13.4 应用开发案例一：转账
Fabric项目中自带一些完整链码的示例，如Go编写的链码（位于examples/chaincode/go）和Java编写的链码（位于examples/chaincode/java）。
本节将以Go语言典型链码chaincode_example02.go为例进行讲解。该链码简单实现了两方的转账功能，很适合初学者上手。
链码代码位置在examples/chaincode/go/chaincode_example02/chaincode_example02.go。
13.4.1 链码结构
链码的必要结构如下。如前文所述，必要结构包括引入必要的包、声明链码结构体、实现Init和Inovoke方法、主函数：
package main
// 引入必要的包
import (
……
)
// 声明链码结构体
type SimpleChaincode struct {
}
// 实现Init方法
func (t *SimpleChaincode) Init(stub shim.ChaincodeStubInterface) pb.Response {
……
}
// 实现Invoke方法
func (t *SimpleChaincode) Invoke(stub shim.ChaincodeStubInterface) pb.Response {
……
}
// 主函数
func main() {
……
}
本例的链码实现了三个Invoke的分支方法：invoke、delete、query。Invoke被调用时，会根据交易参数定位到不同的分支处理逻辑。各分支方法总结如表13-5。
表13-5 三个Invoke的分支方法总结
13.4.2 Init方法
Init方法中，首先通过stub的GetFunctionAndParameters（）方法提取本次调用的交易中所指定的参数：
_, args := stub.GetFunctionAndParameters()
注意，GetFunctionAndParameters（）的返回值类型为 （functionstring，params[]string）。其中function string是交易参数中的第一个参数，params[]string是交易参数中从第二个参数起所有参数的列表（若交易只有一个参数，则为空列表）。
例如，如果实例化链码时指定参数{"Args"：["init"，"a"，"100"，"b"，"200"]}，则 GetFunction-AndParameters（）的返回值中，function等于"init"，params等于 ["a"，"100"，"b"，"200"]。
本例中，用下划线忽略了返回的function值，用args变量记录其他参数。
接下来检查args参数数量，必须为4，否则会通过shim.Error（）函数创建并返回一个状态为ERROR的Response消息：
if len(args) != 4 {
return shim.Error("Incorrect number of arguments. Expecting 4")
}
分别读取4个参数。设用该链码实现转账的两个实体分别为a和b，则A、Aval、B、Bval的值分别表示a的名称、a的初始余额、b的名称、b的初始余额：
A = args[0]
Aval, err = strconv.Atoi(args[1])
if err != nil {
return shim.Error("Expecting integer value for asset holding")
}
B = args[2]
Bval, err = strconv.Atoi(args[3])
if err != nil {
return shim.Error("Expecting integer value for asset holding")
}
之后，最为关键的是将必要的状态值记录到分布式账本中。stub的PutState（）函数可以尝试在账本中添加或更新一对键值（需要等待Committer节点验证通过，才真正写入账本得到确认）。
Pustate（）方法格式为PutState（key string，value[]byte）error，其中key为键，类型是string；value为值，类型是字节数组。以下代码向账本中存入了两对键值，分别记录了a和b的余额：
err = stub.PutState(A, []byte(strconv.Itoa(Aval)))
if err != nil {
return shim.Error(err.Error())
}
err = stub.PutState(B, []byte(strconv.Itoa(Bval)))
if err != nil {
return shim.Error(err.Error())
}
最后，通过shim.Success（nil）创建并返回状态为OK的Response消息。
13.4.3 Invoke方法
Invoke方法中，同样通过stub的GetFunctionAndParameters（）方法提取本次调用的交易中所指定的参数：
function, args := stub.GetFunctionAndParameters()
之后根据function值的不同，执行不同的分支处理逻辑。
本例在Invoke中实现了三个分支处理逻辑：query、invoke和delete。由代码可见，为每个分支的处理逻辑都编写了一个方法：
if function == "invoke" {
return t.invoke(stub, args)
} else if function == "delete" {
return t.delete(stub, args)
} else if function == "query" {
return t.query(stub, args)
}
1.query分支
query分支实现了查询一个实体的余额。
query方法需要传入一个参数，即实体的名称。例如，如果调用链码时指定参数{"Args"：["query"，"a"]}，则功能为查询实体a的余额。
具体来说，通过stub的GetState（）函数查询余额。该函数格式为GetState（key string）（[]byte，error），功能为传入键，返回键对应的值。
如果成功查询到余额，则返回shim.Success（Avalbytes），即返回状态为OK的Response消息，并将余额Avalbytes写入Response的Payload字段中。
2.invoke分支
invoke分支实现了两个实体之间的转账。
invoke方法需要传入三个参数，分别为付款方名称、收款方名称、转账数额。例如，如果调用链码时指定参数{"Args"：["invoke"，"a"，"b"，"50"]}，则功能为a向b转账50。
具体，先用GetState（）函数得到双方余额，之后计算转账后的余额，再通过PutState（）函数更新键值写入账本。
3.delete分支
delete分支实现了删除一个实体。
delete方法需要传入一个参数，即实体的名称。例如，如果调用链码时指定参数{"Args"：["delete"，"b"]}，则功能为删除实体b。
具体，通过sub的DelState（）函数删除实体。该函数格式为DelState（key string）error，功能为传入键，从账本中删除键对应的键值。注意，虽然键值从账本中删除，但删除操作的交易记录会保存在区块中。
来源：我是码农，转载请保留出处和链接！
本文链接：http://www.54manong.com/?id=894