当前位置:首页 » 区块链精品文章 » 正文

13.4 应用开发案例一:转账

1615 人参与  2018年09月29日 11:07  分类 : 区块链精品文章  评论

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的分支方法总结

image.png

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

区块链是什么  

微信号:qq444848023    QQ号:444848023

加入【我是码农】QQ群:864689844(加群验证:我是码农)

<< 上一篇 下一篇 >>

网站分类

标签列表

最近发表

全站首页 | 数据结构 | 区块链| 大数据 | 机器学习 | 物联网和云计算 | 面试笔试

本站资源大部分来自互联网,版权归原作者所有!