使用Node.JS访问Hyperledger Fabric的gRPC服务

时间 2019-11-12

标签使用 node.js node 访问 hyperledger fabric grpc 服务栏目 Node.js 繁體版

原文原文链接

在即将正式发布的Hyperledger Fabric SDK 1.0中，Hyperledger Fabric经过gRPC提供服务接口以取代现有的REST API。本文介绍了如何使用Node.JS访问Hyperledger Fabric的gRPC服务。node

Hyperledger Fabric的gRPC服务接口能够经过安装Hyperledger fabric Client (HFC)获取。npm

在工做目录下运行以下npm命令以安装HFC。api

npm install hfc

gRPC接口定义文件（.proto）都在HFC的lib\protos下网络

api.proto
    ca.proto
    chaincode.proto
    chaincodeevent.proto
    devops.proto
    events.proto
    fabric.proto
    server_admin.proto

其中的api.proto定义了名为Openchain的服务，该服务提供了若干个接口以获取Hyperledger Fabric区块网络的具体信息。数据结构

// Interface exported by the server.
    service Openchain {

        // GetBlockchainInfo returns information about the blockchain ledger such as
        // height, current block hash, and previous block hash.
        rpc GetBlockchainInfo(google.protobuf.Empty) returns (BlockchainInfo) {}

        // GetBlockByNumber returns the data contained within a specific block in the
        // blockchain. The genesis block is block zero.
        rpc GetBlockByNumber(BlockNumber) returns (Block) {}

        // GetBlockCount returns the current number of blocks in the blockchain data
        // structure.
        rpc GetBlockCount(google.protobuf.Empty) returns (BlockCount) {}

        // GetPeers returns a list of all peer nodes currently connected to the target
        // peer.
        rpc GetPeers(google.protobuf.Empty) returns (PeersMessage) {}
    }

如下代码使用GetBlockCount接口获取区块总数。ui

var fs = require('fs');
    var grpc = require('grpc');
    var ProtoBuf = require("protobufjs");

    var apiProto = grpc.load("./protos/api.proto").protos;

    var client = new apiProto.Openchain('192.168.99.100:7051',  grpc.credentials.createInsecure());

    client.getBlockCount({}, function(err, blockCount) {
        if (err) {
            console.log("Error :" + err); 
        }　else if (blockCount) {
            console.dir(blockCount, { depth: null }); 
        }
    });

GetBlockCount接口返回一个BlockCount消息，该消息包含一个count成员，也就是当前网络中的区块总数。google

message BlockCount {

        uint64 count = 1;

    }

如下代码则使用GetBlockByNumber接口获取某个区块的信息。code

function callbackForBlock(blockNumber) {
            return function(err, block) {
                console.log("Block[" + blockNumber.number + "]");
                if (err) {
                    console.log("Error :" , err); 
                }　else if (block) {
                    console.dir(block, { depth: null }); 
                }
                console.log("=======================");
            };
        }

        for (var n=0; n<blockCount.count; n++) {
            
            var blockNumber = {
                number : n
            };

            client.getBlockByNumber(blockNumber, callbackForBlock(blockNumber));
        }

GetBlockByNumber接口须要一个输入参数，用于指定区块号码，其返回消息则是一个Block消息，其数据结构定义在fabric.proto中。orm

总结

本文介绍了一个使用Node.JS访问Hyperledger Fabric gRPC服务的示例程序。server