Spring Boot 整合 Fisco Bcos部署、调用区块链合约的案例
本篇文章介绍 Spring Boot 整合 Fisco Bcos 的相关技术(合约的调用)
简介
在上一节,介绍了Spring Boot 整合 Fisco BCOS的最最基础的案例(SpringBoot成功连接Fisco BCOS,并访问其节点网络 --> 文章链接)。
本节,咱们继续介绍Spring Boot 整合 Fisco BCOS的最最重要的技术点:部署、调用区块链合约(基于上一节的工程案例)。
主要流程
--> 1、合约开发(省略,因为是案例演示,直接使用 Fisco BCOS自带的 HelloWorld合约即可,默认已包含的get、set方法)
--> 2、合约编译(需要编译成java文件,才能在Spring Boot工程中使用)
--> 3、Spring Boot配置合约(将编译好的合约文件,配置到Spring Boot工程中)
--> 4、合约调用的功能实现
--> 5、功能测试
1、合约开发
Fisco BCOS 默认自带了一些合约参考案例,我们就不用自己开发了(原因是比较懒,能不做的就要坚持不做),直接使用HelloWorld.sol即可:
看一下该合约的代码实现,只包含了一个变量,以及该变量的get、set方法(现阶段不用考虑solidity语法,相信有过编程经验的同学都能看得懂):
2、合约编译
合约HelloWorld.sol想在SpringBoot中使用,需要先将合约文件进行编译,得到.java文件。
编译合约,最简单的方式是通过 Fisco BCOS提供的Console控制台程序进行编译,
官方文档:--> 请参考:第四步. 准备智能合约
比较简单,此处不再复述。
注意:如果是自己开发的合约,需要先将合约拷贝到 ~/fisco/console/contracts/solidity目录下,再执行编译合约的命令。
编译成功后,可以在/contracts/sdk/java/org/com/fisco/目录中找到编译后的java文件 :
其中,HelloWorld.java 就是我们需要的文件。
3、Spring Boot配置合约
将HelloWorld.java拷贝到SpringBoot工程中,注意:在应用中所放的位置要与我们设定的包名相同(即:编译后存放java文件的目录结构):
这样就算配置好了,接下来我们直接编码调用合约就可以了~
4、合约调用的功能实现
BcosController完整代码:
package com.qxc.demo_bcos.controller; import org.com.fisco.HelloWorld; import org.fisco.bcos.sdk.BcosSDK; import org.fisco.bcos.sdk.client.Client; import org.fisco.bcos.sdk.client.protocol.response.BlockNumber; import org.fisco.bcos.sdk.crypto.keypair.CryptoKeyPair; import org.fisco.bcos.sdk.model.TransactionReceipt; import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import org.springframework.web.bind.annotation.*; /** * Bcos 演示案例: * 齐行超 * 2022-01-04 */ @RestController public class BcosController { private BcosSDK bcosSDK; private Client client; private HelloWorld helloWorld; private void initSDK() throws Exception { System.out.println("-----init BcosSDK:------"); @SuppressWarnings("resource") ApplicationContext context = new ClassPathXmlApplicationContext("classpath:fisco-config.xml"); System.out.println("-----init config ok------"); bcosSDK = context.getBean(BcosSDK.class); System.out.println("-----init BcosSDK ok------"); // 为群组1初始化client client = bcosSDK.getClient(Integer.valueOf(1)); System.out.println("-----init client ok------"); // 向群组1部署HelloWorld合约 CryptoKeyPair cryptoKeyPair = client.getCryptoSuite().getCryptoKeyPair(); helloWorld = HelloWorld.deploy(client, cryptoKeyPair); System.out.println("-----deploy HelloWorld ok------"); } @GetMapping("/test") public String test() { System.out.println("-----test------"); return "this is bcos demo"; } @GetMapping("/block") public String getBlockNumber() throws Exception { System.out.println("-----getBlockNumber------"); if(bcosSDK == null){ initSDK(); } if(bcosSDK == null || client == null){ System.out.println("-----init BcosSDK failed------"); return "-----init BcosSDK failed----"; } BlockNumber blockNumber = client.getBlockNumber(); return "block number is : " + blockNumber.getBlockNumber().toString(); } @GetMapping("/get") public String getHelloworld() throws Exception { System.out.println("-----getHelloworld------"); if(bcosSDK == null){ initSDK(); } if(bcosSDK == null || helloWorld == null){ System.out.println("-----init BcosSDK failed------"); return "-----init BcosSDK failed----"; } // 调用HelloWorld合约的get接口 String getValue = helloWorld.get(); System.out.println("-----call HelloWorld get success------:" + getValue); return getValue; } @GetMapping("/set") public String setHelloworld(@RequestParam(value="val",required = false,defaultValue = "default val")String val) throws Exception { System.out.println("-----setHelloworld------"); if(bcosSDK == null){ initSDK(); } if(bcosSDK == null || helloWorld == null){ System.out.println("-----init BcosSDK failed------"); return "-----init BcosSDK failed----"; } // 调用HelloWorld合约的set接口 TransactionReceipt receipt = helloWorld.set(val); System.out.println("-----call HelloWorld get success------:" + receipt.getMessage()); return "setHelloworld success"; } }
代码中除了合约的调用,还有BCOS SDK初始化等功能,对应的技术讲解请在上一节中查看,本节不再复述哈--> 文章链接。
5、功能测试
我这边有两台电脑:
电脑1:本地的Mac电脑,没有区块链环境,只是用于SpringBoot工程的开发;
电脑2:阿里云上的CentOS服务器,配置了区块链环境,合约部署、编译、SpringBoot工程的jar包运行都是在该电脑上;
大家可根据自己的电脑环境,对比着进行功能测试即可。
5.1、编译SpringBoot工程,生成jar包:
5.2、发送到服务器上运行:
5.3、在mac电脑上远程访问服务端程序(也可在服务端通过curl自己访问自己):
测试get:
测试set:
再测试get:
测试块高(我这边反复set了几次,块高已累计到9了 ):
总结
至此,Spring Boot 整合 Fisco Bcos(部署、调用区块链合约)的案例讲解已结束。
Fisco Bcos 的使用还是很简单的,如果有问题大家可以直接查询官方技术文档,也欢迎留言讨论,咱们共同学习、共同进步,哈哈~~。
到此这篇关于Spring Boot 整合 Fisco Bcos(部署、调用区块链合约)的文章就介绍到这了,更多相关Spring Boot 整合 Fisco Bcos内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!