该文教程分一下三步:
- 启动一个用于测试的区块链网络
- 学习如何使用智能合约
- 开发一个可以查询和修改的应用
启动网络
这次我们定位到fabcar文件夹:
git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples/fabcar
启动:
./startFabric.sh
这个脚本做了以下事情:
- 启动一个peer节点,order节点,证书和CLI容器
- 创建一个channel,并把peer添加到channel
- 安装智能合约(例如chaincode)到peer的文件系统,然后初始化chaincode到channel,实例化一个chaincode容器
- 调用
initLedger
方法来初始化10辆汽车到channel账本
可以通过docker ps
命令来查看当前脚本运行后的进程情况,接下来我们将重点放在应用上。下图描述了一个应用是如何与区块链网络交互的:
应用与网络的交互
应用使用API来调用智能合约(即这个demo中的chaincode),这些智能合约在主机的网络中用名字和版本唯一标识。例如,我们的chaincode容器名为dev-peer0.org1.example.com-fabcar-1.0
,名字是fabcar
,版本是1.0
,peer运行在dev-peer0.org1.example.com
查询账本
你可以通过单参数、多参数、或者是JSON形式的参数来查询账本
我们之前已经把账本中初始化了10辆汽车,现在我们可以用query.js
的代码来查询这些数据了。
再次之前,我们需要先安装一些node模块的sdk,定位到fabcar文件夹,执行:
npm install
然后运行脚本query.js
,来得到账本中的汽车列表,这脚本中我们使用了queryAllCars
方法:
node query.js
Query result count = 1
Response is [{"Key":"CAR0", "Record":{"colour":"blue","make":"Toyota","model":"Prius","owner":"Tomoko"}},
{"Key":"CAR1", "Record":{"colour":"red","make":"Ford","model":"Mustang","owner":"Brad"}},
{"Key":"CAR2", "Record":{"colour":"green","make":"Hyundai","model":"Tucson","owner":"Jin Soo"}},
{"Key":"CAR3", "Record":{"colour":"yellow","make":"Volkswagen","model":"Passat","owner":"Max"}},
{"Key":"CAR4", "Record":{"colour":"black","make":"Tesla","model":"S","owner":"Adriana"}},
{"Key":"CAR5", "Record":{"colour":"purple","make":"Peugeot","model":"205","owner":"Michel"}},
{"Key":"CAR6", "Record":{"colour":"white","make":"Chery","model":"S22L","owner":"Aarav"}},
{"Key":"CAR7", "Record":{"colour":"violet","make":"Fiat","model":"Punto","owner":"Pari"}},
{"Key":"CAR8", "Record":{"colour":"indigo","make":"Tata","model":"Nano","owner":"Valeria"}},
{"Key":"CAR9", "Record":{"colour":"brown","make":"Holden","model":"Barina","owner":"Shotaro"}}]
现在我们来看一下query.js
代码里面到底发生了什么。
首先定义了一些变量,例如chaincode ID、channel名字以及网络端点等:
var options = {
wallet_path : path.join(__dirname, './network/creds'),
user_id: 'PeerAdmin',
channel_id: 'mychannel',
chaincode_id: 'fabcar',
network_url: 'grpc://localhost:7051',
下面是构造一个查询请求:
// queryCar - requires 1 argument, ex: args: ['CAR4'],
// queryAllCars - requires no arguments , ex: args: [''],
const request = {
chaincodeId: options.chaincode_id,
txId: transaction_id,
fcn: 'queryAllCars',
args: ['']
我们定义chaincode_id
为fabcar
,然后调用了queryAllCars
方法,这个方法被定义在chaincode中。查看chaincode\fabcar\fabcar.go
文件,我们可以看到这里面还定义了一些其他的方法,我们可以找到queryAllCars
方法的位置:
func (s *SmartContract) queryAllCars(APIstub shim.ChaincodeStubInterface) sc.Response {
startKey := "CAR0"
endKey := "CAR999"
resultsIterator, err := APIstub.GetStateByRange(startKey, endKey)
方法中使用shim接口的函数GetStateByRange
来获得账本中startKey
和endKey
之间的数据。下图表示了一个app是如何调用chaincode中的不同方法的:
回到query.js
,我们将request调用的方法修改为queryCar,并在args里面加上参数,来获取某一辆汽车的数据:
const request = {
chaincodeId: options.chaincode_id,
txId: transaction_id,
fcn: 'queryCar',
args: ['CAR4']
运行:
node query.js
{"colour":"black","make":"Tesla","model":"S","owner":"Adriana"}
现在,你应该知道了如何在chaincode中做基本的查询数据的操作,下面让我们来讲如何更新账本。
更新账本
账本更新的第一件事情,是要创建一个交易提议,类似于查询,我们需要先创建出一个request,然后调用channel.SendTransactionProposal
的API来发送给peer背书。
然后会从network接收到这个交易提议的回复,应用可以将这个回复信息用于创建和签名一个交易请求。然后我们调用channel.sendTransaction
API来将请求发送到ordering service,这笔交易将会被打包成一个block,然后投递到该channel的各个peer节点来进行验证(这个例子中我们只有一个单独的结点)。
最终,应用将使用eh.setPeerAddr
API来连接结点的监听端口,调用eh.registerTxEvent
来注册与这个交易ID相关的事件,我们可以通过这个API来得知这次事件的成功与否。
在invode.js
脚本中,就有用到上述提到的交易流程:
var request = {
targets: targets,
chaincodeId: options.chaincode_id,
fcn: 'createCar',
args: ['CAR10', 'Chevy', 'Volt', 'Red', 'Nick'],
chainId: options.channel_id,
txId: tx_id
我们创建了一个CAR10的请求,执行:
node invoke.js
The transaction has been committed on peer localhost:7053
节点发送了这次事件的通知,然后我们的应用通过eh.registerTxEvent
API接收到了这个通知,并知道了事件的成功。我们可以再调用查询接口验证一下:
Response is {"colour":"Red","make":"Chevy","model":"Volt","owner":"Nick"}
最后,让我们来看看修改数据。将request中的方法改为changeCarOwner
,修改对应参数如下:
var request = {
targets: targets,
chaincodeId: options.chaincode_id,
fcn: 'changeCarOwner',
args: ['CAR10', 'Barry'],
chainId: options.channel_id,
txId: tx_id
执行:
node invoke.js
查询验证:
Response is {"colour":"Red","make":"Chevy","model":"Volt","owner":"Barry"}