fabric中的chaincode包含了Chaincode代码和Chaincode管理命令这两个部分的内容:
- Chaincode代码是业务的承载体,负责具体的业务逻辑。
- Chaincode管理命令负责Chaincode的部署、安装、维护等工作。
Chaincode代码是一段运行在容器中的程序,这些程序可以是Go、Java、Node.js等语言开发的。Chaincode是客户端程序与Fabric之间的桥梁。通过Chaincode客户程序可以发起交易、查询交易。
Chaincode管理命令主要用来对Chaincode进行安装、实例化、调用、打包、签名等操作。
Golang版本的Chaincode的代码结构
Chaincode源代码的基本结构
1、包名
package main
2、引入包
在Chaincode中,执行复制、查询等功能都需要通过shim
"fmt"
"github.com/hyperledger/fabric/core/chaincode/shim"
pb "github.com/hyperledger/fabric/protos/peer"
3、定义结构体并实现
每个Chaincode都需要定义一个结构体,结构体的名字可以是任意符合Golang命令规范的字符串。
type chainCodeStudy1 struct {
}
chaincode结构体是chaincode的主体结构。
4、Chiancode的Init方法
Init方法是初始化方法,当执行命令peer chaincode instantiate实例化 chaincode的时候回调用该方法,同时命令中的-c选项后面内容会作为参数传入Init方法中。
例:
peer chaincode instantiate -o orderer.qklszzn.com:7050 -C qklszzlchannel -n sqlkszzncc -v 1.0 -c '{"Args":["init", "a", "100", "b", "200"]}'
该例子传入4个参数“a”、“100”、“b”、“200”,命令中有五个参数,但第一个参数init是固定值,后面的才是参数。
如果有很多参数需要传递给chaincode,可以采用一些数据格式(如JSON),把数据格式化之后传给Chaincode,在Init方法中可以通过下列方法获取传入参数。
func (t *chainCodeStudy1) Init(stub shim.ChaincodeStubInterface) pb.Response {
// 获取客户端传入的参数,args是一个字符串数据,存储传入的字符串参数
_, args := stub.GetFunctionAndParameters()
}
5、Invoke方法
Invoke方法的主要作用是写入数据,比如发起交易等。在执行命令peer chaincode invoke的时候系统会调用该方法,同时会把命令中-c后面的参数传入Invoke方法中,以下面的invoke命令为例:
peer chaincode invoke -o 192.168.23.212:7050 -C qklszzlchannel -n qlkszzncc -c '{"Args":["invoke", "a", "b", "1"]}'
上面的命令调用Chaincode的Invoke方法并传入三个参数“a”“b”“1”