区块链从零起步（P3）创建第一个应用

参考
https://hyperledger-fabric.readthedocs.io

该文教程分一下三步：

启动一个用于测试的区块链网络
学习如何使用智能合约
开发一个可以查询和修改的应用

启动网络

这次我们定位到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.sendTransactionAPI来将请求发送到ordering service，这笔交易将会被打包成一个block，然后投递到该channel的各个peer节点来进行验证（这个例子中我们只有一个单独的结点）。
最终，应用将使用eh.setPeerAddrAPI来连接结点的监听端口，调用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.registerTxEventAPI接收到了这个通知，并知道了事件的成功。我们可以再调用查询接口验证一下：

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

执行：