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

'); (window.slotbydup = window.slotbydup || []).push({ id: "u3646208", container: s }); })();

'); (window.slotbydup = window.slotbydup || []).push({ id: "u3646147", container: s }); })();