美文网首页区块链
区块链从零起步(P3)创建第一个应用

区块链从零起步(P3)创建第一个应用

作者: 山天大畜 | 来源:发表于2017-09-12 18:19 被阅读226次

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

    该文教程分一下三步:

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

    启动网络

    这次我们定位到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_idfabcar,然后调用了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来获得账本中startKeyendKey之间的数据。下图表示了一个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
    

    执行:

    node invoke.js

    查询验证:

    Response is  {"colour":"Red","make":"Chevy","model":"Volt","owner":"Barry"}
    

    相关文章

      网友评论

        本文标题:区块链从零起步(P3)创建第一个应用

        本文链接:https://www.haomeiwen.com/subject/bxfhsxtx.html