一、智能合约介绍
智能合约是指把合同/协议条款以代码的形式电子化地放到区块链网络上。FISCO BCOS平台支持两种智能合约类型：Solidity智能合约与预编译智能合约
Solidity与Java类似。代码写好后，都需要通过编译器将代码转换成二进制，在Java中，编译器是Javac，而对于Solidity，是solc。生成后的二进制代码，会放到虚拟机里执行。Java代码在Java虚拟机（JVM）中执行，在Solidity中，是一个区块链上的虚拟机EVM。目的，是给区块链提供一套统一的逻辑，让相同的代码跑在区块链的每个节点上，借助共识算法，让区块链的数据以统一的方式进行改变，达到全局一致的结果
设计目的：
为区块链提供一套统一的逻辑，让相同的代码跑在区块链的每个节点上，借助共识算法，让区块链的数据以统一的方式进行改变，达到全局一致的结果
Solidity 局限与改进
- Solidity不够灵活
受自身堆栈深度的限制,函数传参和局部参数的个数总和不能超过16个，Solidity是一种强类型的语言，但其类型转换较为麻烦
- 性能差
底层存储单位是32字节（256 bits），对硬盘的读写要求较高，浪费了大量的存储资源
针对上述两点，FISCO BCOS提供了一种用C++写合约方式：预编译合约。开发者可以用C++编写智能合约逻辑，并将其内置在节点中，
预编译合约突破了Solidity语言的限制，借助强大的C++语言，可以灵活的实现各种逻辑，灵活性大大提高。同时，C++的性能优势也得到了很好的利用，通过预编译合约编写的逻辑，相比于Solidity语言来说，性能得到提升
合约编写
开发工具:remix-ide的使用，开发编译过程选择在线remix
Remix是功能强大的开源工具，可帮助您直接从浏览器编写Solidity合同。Remix用JavaScript编写，支持在浏览器和本地使用。
Remix还支持智能合约的测试，调试和部署等等。
优点：
1. 动态编译、可调控编译版本
2. 即时错误提醒
3. 代码自动补全
4. 发布阶段，代码问题提醒
5. 对设计方法的简单调用
认识合约
例：
pragma solidity ^ 0.4.26; constant Sample{ //变量 address表示账户地址 address private _admin; uint private _state; //修饰符 ，为函数提供一些额外的功能，例如检查、清理等工作 // 检测函数的调用者是否为函数部署时设定的那个管理员(即合约的部署人) modifier onlyAdmin(){ require(msg.sender==_admin,"You are not admin"); _; } //事件 // 记录事件定义的参数，存储到区块链交易的日志中，提供廉价的存储。 // 提供一种回调机制，在事件执行成功后，由节点向注册监听的SDK发送回调通知，触发回调函数被执行。 // 提供一个过滤器，支持参数的检索和过滤。 event SetState(unit valule); //构造方法 构造函数用于初始化合约 constructor() public { _admin=msg.sender; } //函数 方法 function setSate(unit value) public onlyAdmin(){ _state=value; emit SetState(value); } function getValue() public view return (uint){ return _state; } }
二、案列合约设计
逻辑如下：
定义：
- 定义事件方法AddEqu(string equnum, string data)
- 构造函数中创建t_equipment表
- 查询方法：select(string equnum)，根据设备编号查询设备备案信息，或使用记录。（ 成功返回0, 设备不存在返回-1）
- addEqu(string equnum, string data)，添加数据前校验数据唯一性，已存在不在插入
Eqump合约类图
Contract:Java与智能合约进行交互的实体合约类型抽象
ManagedTransaction: 交易管理
pragma solidity ^ 0.4.25; import "./Table.sol"; contract Eqump{ // event event AddEqu(string equnum, string data); // constructor() public { // 构造函数中创建t_equipment表 createTable(); } function createTable() private { TableFactory tf = TableFactory(0x1001); // 创建表 tf.createTable("t_equipment", "equnum", "data"); } function openTable() private view returns(Table) { TableFactory tf = TableFactory(0x1001); Table table = tf.openTable("t_equipment"); return table; } /* 描述 : 根据设备管理信息查询设备信息 参数 ： equ_num : 设备编号 返回值： 参数一： 成功返回0, 设备不存在返回-1 */ function select(string equnum) public view returns(int256, string) { // 打开表 Table table = openTable(); // 查询 Entries entries = table.select(equnum, table.newCondition()); if (0 == uint256(entries.size())) { return (-1, ""); } else { Entry entry = entries.get(0); return (0, entry.getString("data")); } } /* 描述 : 添加信息 参数 ： equnum : 案信息主键 data : 信息 返回值： 0 备案成功 -1 备案信息已存在 -2 其他错误 */ function addEqu(string equnum, string data) public returns(int256){ int256 ret_code = 0; Table table = openTable(); Entries entries = table.select(equnum, table.newCondition()); if(0 == uint256(entries.size())) { Entry entry = table.newEntry(); entry.set("equnum", equnum); entry.set("data", data); // 插入 int count = table.insert(equnum, entry); if (count == 1) { // 成功 ret_code = 0; } else { // 失败? 无权限或者其他错误 ret_code = -2; } } else { // 备案信息 ret_code = -1; } emit AddEqu(equnum, data); return ret_code; } }
pragma solidity ^0.4.24; contract TableFactory { function openTable(string) public constant returns (Table); // 打开表 function createTable(string,string,string) public returns(int); // 创建表 } // 查询条件 contract Condition { //等于 function EQ(string, int) public; function EQ(string, string) public; //不等于 function NE(string, int) public; function NE(string, string) public; //大于 function GT(string, int) public; //大于或等于 function GE(string, int) public; //小于 function LT(string, int) public; //小于或等于 function LE(string, int) public; //限制返回记录条数 function limit(int) public; function limit(int, int) public; } // 单条数据记录 contract Entry { function getInt(string) public constant returns(int); function getAddress(string) public constant returns(address); function getBytes64(string) public constant returns(byte[64]); function getBytes32(string) public constant returns(bytes32); function getString(string) public constant returns(string); function set(string, int) public; function set(string, string) public; function set(string, address) public; } // 数据记录集 contract Entries { function get(int) public constant returns(Entry); function size() public constant returns(int); } // Table主类 contract Table { // 查询接口 function select(string, Condition) public constant returns(Entries); // 插入接口 function insert(string, Entry) public returns(int); // 更新接口 function update(string, Entry, Condition) public returns(int); // 删除接口 function remove(string, Condition) public returns(int); function newEntry() public constant returns(Entry); function newCondition() public constant returns(Condition); }
编译发布
WeBASE简介：
WeBASE（WeBank Blockchain Application Software Extension） 是在区块链应用和FISCO-BCOS节点之间搭建的一套通用组件。围绕交易、合约、密钥管理，数据，可视化管理来设计各个模块，开发者可以根据业务所需，选择子系统进行部署。WeBASE屏蔽了区块链底层的复杂度，降低开发者的门槛，大幅提高区块链应用的开发效率，包含节点前置、节点管理、交易链路，数据导出，Web管理平台等子系统。
过程
-
- 编译发布
- 测试验证 发交易-->addEqu
{
equnum : y1
data:y1
}
发交易-->select
{
equnum:y1
}
基于web3sdk 调试Eqump
1. 在IDE⾥编写智能合约。
2. 合约编写完成后，拿到fisco ckient 命令⾏⼯具内进⾏编译和⽣成java SDK的操作。 在/home/FISCO-BCOS/generator/console⽬录下执⾏⼀下命令,将合约解析成java SDK⽂件。
sh sol2java.sh com.wg.service
特点
- - 轻量化配置，即可连接区块链节点
- - 根据.sol 合约文件，一键生成.abi 和 .bin文件
- - 一键生成java 合约文件
基于springboot-demo项目
applycation.yml
encrypt-type: # 0：普通， 1：国密 encrypt-type: 0 group-channel-connections-config: caCert: ca.crt sslCert: sdk.crt sslKey: sdk.key all-channel-connections: - group-id: 1 #group ID connections-str: # 若节点小于v2.3.0版本，查看配置项listen_ip:channel_listen_port - 127.0.0.1:20200 # node channel_listen_ip:channel_listen_port - 127.0.0.1:20201 - group-id: 2 connections-str: # 若节点小于v2.3.0版本，查看配置项listen_ip:channel_listen_port - 127.0.0.1:20202 # node channel_listen_ip:channel_listen_port - 127.0.0.1:20203 channel-service: group-id: 1 # sdk实际连接的群组 agency-name: fisco # 机构名称
SSL连接配置
国密区块链和非国密区块链环境下，节点与SDK之间均可以建立SSL的连接，将节点所在目录nodes/${ip}/sdk/目录下的ca.crt、sdk.crt和sdk.key文件拷贝到项目的资源目录。（低于2.1版本的FISCO BCOS节点目录下只有node.crt和node.key，需将其重命名为sdk.crt和sdk.key以兼容最新的SDK）
启动
无异常，看到区块链的版本、java环境地址、端口为正常启动。
2020-07-17 09:13:21,417 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.handler.ConnectionCallback] ConnectionCallback.java:267 - support channel handshake node: Version [buildTime=20200602 03:35:56, buildType=Linux/clang/Release, chainID=1, version=2.4.1, gitBranch=HEAD, gitCommit=f6f2b4f12d5441e24c81a7c862691636c9cb3263, supportedVersion=2.4.1], content: {"id":0,"jsonrpc":"2.0","result":{"Build Time":"20200602 03:35:56","Build Type":"Linux/clang/Release","Chain Id":"1","FISCO-BCOS Version":"2.4.1","Git Branch":"HEAD","Git Commit Hash":"f6f2b4f12d5441e24c81a7c862691636c9cb3263","Supported Version":"2.4.1"}}
2020-07-17 09:13:21,422 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.handler.ConnectionCallback] ConnectionCallback.java:167 - channel protocol handshake success, set socket channel protocol, host: 10.2.23.16:20200, channel protocol: ChannelProtocol [protocol=3, nodeVersion=2.4.1, EnumProtocol=VERSION_3]
2020-07-17 09:13:21,424 [restartedMain] INFO [org.fisco.bcos.channel.client.Service] Service.java:373 - Connect to nodes: [10.2.23.16:20200] ,groupId: 1 ,caCert: class path resource [ca.crt] ,sslKey: class path resource [sdk.key] ,sslCert: class path resource [sdk.crt] ,java version: 1.8.0_151 ,java vendor: Oracle Corporation
2020-07-17 09:13:21,432 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.handler.ConnectionCallback] ConnectionCallback.java:338 - send update topic message request, seq: 89300763da2a4279bcb49b4b8187e477, content: ["_block_notify_1"]
2020-07-17 09:13:21,434 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.handler.ConnectionCallback] ConnectionCallback.java:370 - query block number host: 10.2.23.16:20200, seq: 0db7f13819ec425c8d9494cb68cd98cd, content: {"jsonrpc":"2.0","method":"getBlockNumber","params":[1],"id":1}
2020-07-17 09:13:21,440 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.handler.ConnectionCallback] ConnectionCallback.java:395 - query blocknumer, host:10.2.23.16:20200, blockNumber: 336
验证
编写单元测试
核心代码
package org.fisco.bcos; import org.fisco.bcos.constants.GasConstants; import org.fisco.bcos.solidity.Eqump; import org.fisco.bcos.web3j.crypto.Credentials; import org.fisco.bcos.web3j.protocol.Web3j; import org.fisco.bcos.web3j.tuples.generated.Tuple2; import org.fisco.bcos.web3j.tx.gas.StaticGasProvider; import org.junit.Test; import org.springframework.beans.factory.annotation.Autowired; import java.math.BigInteger; import static org.junit.Assert.assertTrue; /** * 财政部大型设备合约单元测试 */ public class EqumpTest extends BaseTest { @Autowired private Web3j web3j; @Autowired private Credentials credentials; /** * 部署调用合约 * @throws Exception */ @Test public void deployAndCall() throws Exception { // deploy contract Eqump eqump = Eqump.deploy(web3j, credentials, new StaticGasProvider(GasConstants.GAS_PRICE, GasConstants.GAS_LIMIT)).send(); if (eqump != null) { System.out.println("Eqump address is: " + eqump.getContractAddress()); // call set function eqump.addEqu("1A2B","12312").send(); // call get function Tuple2<BigInteger, String> send = eqump.select("1A2B").send(); System.out.println(send.getValue1()); System.out.println(send.getValue2()); assertTrue("Eqump!".equals(send)); } } /** * 查询 * @throws Exception */ @Test public void queryAndCall() throws Exception { // deploy contract Eqump eqump = Eqump.deploy(web3j, credentials, new StaticGasProvider(GasConstants.GAS_PRICE, GasConstants.GAS_LIMIT)).send(); if (eqump != null) { System.out.println("Eqump address is: " + eqump.getContractAddress()); // call set function // call get function Tuple2<BigInteger, String> send = eqump.select("y6").send(); System.out.println(send.getValue1()); System.out.println(send.getValue2()); } } }
核心业务代码
/** * 添加设备信息 * * @param dataArray * @throws InterruptedException */ private void addIpassItem(JSONArray dataArray) { System.out.println("===========================addIpassItem 添加设备信息业务开始================================"); try { Eqump eqump = Eqump.deploy(web3j, credentials, new StaticGasProvider(GasConstants.GAS_PRICE, GasConstants.GAS_LIMIT)).send(); for (int i = 0; i < dataArray.size(); i++) { List list = (List) dataArray.getJSONObject(i).get("equipmentInfor"); long startime = System.currentTimeMillis(); for (int j = 0; j < list.size(); j++) { JSONObject jobj = (JSONObject) list.get(j); String sbbh = StringUtil.validator(jobj.get("设备编号")); String jsonStr = StringUtil.validator(jobj); if (eqump != null) { System.out.println("Eqump address is: " + eqump.getContractAddress()); eqump.addEqu(sbbh,jsonStr).send(); } } System.out.println("耗时：" + (System.currentTimeMillis() - startime) + " 毫秒"); } } catch (NumberFormatException e) { e.printStackTrace(); } catch (Exception e) { e.printStackTrace(); } System.out.println("===========================addIpassItem 添加设备信息业务结束================================"); } /** * 添加设备使用信息 * * @param dataArray * @throws InterruptedException */ private void addIpassUse(JSONArray dataArray) { System.out.println("===========================addIpassUse 添加设备信息业务开始================================"); try { for (int i = 0; i < dataArray.size(); i++) { List list = (List) dataArray.getJSONObject(i).get("equipmentUsageRec"); long startime = System.currentTimeMillis(); for (int j = 0; j < list.size(); j++) { JSONObject jobj = (JSONObject) list.get(j); String sbbh = StringUtil.validator(jobj.get("设备编号")); String jsonStr = StringUtil.validator(jobj); Eqump eqump = Eqump.deploy(web3j, credentials, new StaticGasProvider(GasConstants.GAS_PRICE, GasConstants.GAS_LIMIT)).send(); if (eqump != null) { System.out.println("Eqump address is: " + eqump.getContractAddress()); eqump.addEqu(sbbh,jsonStr).send(); } } System.out.println("耗时：" + (System.currentTimeMillis() - startime) + " 毫秒"); } } catch (NumberFormatException e) { e.printStackTrace(); } catch (Exception e) { e.printStackTrace(); } System.out.println("===========================addIpassUse 添加设备信息业务结束================================"); }
日志信息
===========================addIpassItem 添加设备信息业务开始================================ 2020-07-23 17:20:57,261 [http-nio-8080-exec-1] INFO [org.fisco.bcos.web3j.utils.Async] Async.java:19 - default set setExeutor , pool size is 50 2020-07-23 17:20:57,262 [http-nio-8080-exec-1] INFO [org.fisco.bcos.web3j.utils.Async] Async.java:81 - set setExeutor because executor null, executor is java.util.concurrent.ThreadPoolExecutor@3ac27c97[Running, pool size = 0, active threads = 0, queued tasks = 0, completed tasks = 0] 2020-07-23 17:20:57,458 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.client.Service] Service.java:1388 - Receive block notify: {"blockNumber":353,"groupID":1} Eqump address is: 0x0066699656ac8bc09ec364858680f2357f899ae0 2020-07-23 17:21:01,012 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.client.Service] Service.java:1388 - Receive block notify: {"blockNumber":354,"groupID":1} Eqump address is: 0x0066699656ac8bc09ec364858680f2357f899ae0 2020-07-23 17:21:02,807 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.client.Service] Service.java:1388 - Receive block notify: {"blockNumber":355,"groupID":1} Eqump address is: 0x0066699656ac8bc09ec364858680f2357f899ae0 2020-07-23 17:21:04,341 [nioEventLoopGroup-2-1] INFO [org.fisco.bcos.channel.client.Service] Service.java:1388 - Receive block notify: {"blockNumber":356,"groupID":1} 耗时：6593 毫秒 ===========================addIpassItem 添加设备信息业务结束================================
webase验证
{"序号":"3","仪器名称":"600MHz超导核磁共振仪","仪器型号":"Avance III 600","设备编号":"Avance III 600","所属单位":"昆明植物研究所 ","所属区域中心":"昆明生物多样性大型仪器区域中心","制造商名称":"瑞士布鲁克公司 ","国别":"瑞士","购置时间":"20100109","放置地点":"分析测试中心101","预约审核人":"李波 ","操作人员":"李波 ","仪器工作状态":"正常 ","预约形式":"必须预约 ","预约类型":"项目预约","仪器大类":"室内分析测试设备","仪器中类":"波谱仪器 ","仪器小类":"核磁共振波谱仪器"}