编写Node.js应用程序

应用程序开发人员使用composer-clientnpm模块以编程方式连接到已部署的业务网络，创建、读取、更新、删除资产和参与者，以及提交交易。如果应用程序需要能够部署或管理业务网络，则可以使用composer-adminnpm模块。

示例landregistry.js文件包含一个代表土地注册的类，并包含列出土地权证、添加默认权证和提交交易的方法。这已经使用JavaScript类实现了; 然而，你可以自由地构建你的代码，如你所愿。

值得强调的是API的风格是使用承诺（promise）。通常，Hyperledger Composer API将返回在成功完成操作时解决的承诺，或返回操作结果（如果适用）。

如果你不熟悉基于Promise的开发，那么值得在线查看一些教程来获得一个想法。

需要的模块

  1. const BusinessNetworkConnection = require('composer-client').BusinessNetworkConnection;

对于Hyperledger Composer客户端应用程序，这是唯一需要的npm模块。

连接到Hyperledger Composer运行时

BusinessNetworkConnection实例已创建，然后被用于连接到运行时：

  1. this.bizNetworkConnection = new BusinessNetworkConnection();
  2. this.cardName = config.get('cardName');
  3. this.businessNetworkIdentifier = config.get('businessNetworkIdentifier');

我们要在这里创建的第一个Hyperledger Composer API调用是connect() API，用于建立与Hyperledger Fabric上的Hyperledger Composer运行时的连接。如果成功，此API将对BusinessNetworkDefinition返回一个Promise：

  1. this.bizNetworkConnection.connect(this.cardName)
  2. .then((result) => {
  3.   this.businessNetworkDefinition = result;
  4. });

对于客户端应用程序来说，这是所有必需的要点，从这个角度来看，应用程序想要做什么来调用哪些API。

将资产添加到库

Hyperledger Composer运行时将为每种建模资产创建一个默认库。所以在这个例子中，LandTitle（土地权证）库已经被创建了。我们在这里要做的是访问该库，然后添加一些资产。该getAssetRegistry()方法采用CTO模型文件中定义的全限定资产名称（即命名空间加上资产类型的名称）。它返回一个与资产库一起解决的承诺：

  1. this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle')
  2. .then((result) => {
  3.     this.titlesRegistry = result;
  4. });

下一步是创建一些资产（在代码中查找方法_bootstrapTitles）

工厂样式模式用于创建资产。从businessNetworkDefinition获取工厂，用于创建业务网络中定义的所有类型的实例。请注意使用命名空间和资产名称。然后我们可以设置这个资产的属性。这里的标识符（firstName lastName）与模型中定义的属性匹配。

  1. let factory = this.businessNetworkDefinition.getFactory();
  2. owner = factory.newResource('net.biz.digitalPropertyNetwork', 'Person', 'PID:1234567890');
  3. owner.firstName = 'Fred';
  4. owner.lastName = 'Bloggs';

我们现在有一个人！现在我们需要一个土地权证。请注意业主是如何被指定为我们刚刚创建的人。（在实际的示例代码中，我们使用这个代码两次来创建landTitle1和landTitle2）。

  1. let landTitle2 = factory.newResource('net.biz.digitalPropertyNetwork', 'LandTitle', 'LID:6789');
  2. landTitle2.owner = owner;
  3. landTitle2.information = 'A small flat in the city';

我们现在已经创建了一个需要存储在库中的土地权证。

  1. this.titlesRegistry.addAll([landTitle1, landTitle2]);

这是使用API来添加多个权证，这会返回一个在添加资产时解决的承诺。我们需要做的最后一件事是添加Person，Fred Bloggs。由于这是“参与者”，因此使用getParticipantRegistry API。

  1. this.bizNetworkConnection.getParticipantRegistry('net.biz.digitalPropertyNetwork.Person')
  2.   .then((personRegistry) => {
  3.       return personRegistry.add(owner);
  4.   })

列出库中资产

在示例应用程序中，这是以不同的方法处理的list()。与放置资产相同的设置是必需的，所以在我们需要获取资产库之前，我们称之为getAll() API。这将返回一个对象数组。

  1. this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle')
  2. .then((registry) => {
  3.    return registry.getAll();
  4. })
  5. .then((aResources) => {
  6.   // instantiate
  7.   let table = new Table({
  8.     head: ['TitleID', 'OwnerID', 'First Name', 'Surname', 'Description', 'ForSale']
  9.   });
  10.   let arrayLength = aResources.length;
  11.   for(let i = 0; i < arrayLength; i++) {
  12.     let tableLine = [];
  13.     tableLine.push(aResources[i].titleId);
  14.     tableLine.push(aResources[i].owner.personId);
  15.     tableLine.push(aResources[i].owner.firstName);
  16.     tableLine.push(aResources[i].owner.lastName);
  17.     tableLine.push(aResources[i].information);
  18.     tableLine.push(aResources[i].forSale ? 'Yes' : 'No');
  19.     table.push(tableLine);
  20.   }
  21.   // Put to stdout - as this is really a command line app
  22.   return(table);
  23. })

其中大部分不是Hyperledger Composer API代码 - 但它显示了如何访问已返回的对象的详细信息。在这一点上，值得再看看这个模型。

  1. asset LandTitle identified by titleId {
  2.   o String   titleId
  3.   o Person   owner
  4.   o String   information
  5.   o Boolean  forSale   optional
  6. }
  8. participant Person identified by personId {
  9.   o String personId
  10.   o String firstName
  11.   o String lastName
  12. }

您可以看到如何以非常简单的方式访问所有者和权证信息。

提交交易

我们需要做的最后一件事是提交交易。这是模型文件中交易的定义：

  1. transaction RegisterPropertyForSale identified by transactionId{
  2.   o String transactionId
  3.   --> LandTitle title
  4. }

交易在这里有两个字段，一个是trandsactionId，一个是应该提交出售的土地权证的引用。第一步是进入地产登记处，取回我们要提交出售的具体土地权证。

  1. this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle')
  2. .then((registry) => {
  3.   return registry.get('LID:1148');
  4. })

getAssetRegistry调用现在应该看起来有点熟悉，get API用于获取特定的土地权证。下一步是创建我们想要提交的交易。

  1. let serializer = this.businessNetworkDefinition.getSerializer();
  3. let resource = serializer.fromJSON({
  4.   '$class': 'net.biz.digitalPropertyNetwork.RegisterPropertyForSale',
  5.   'title': 'LID:1148'
  6. });
  8. return this.bizNetworkConnection.submitTransaction(resource);

我们需要做的是创建一个“序列化器”。这是能够创建一个资源 - 这个资源随后被传递给submitTransaction API。请注意，交易JSON与模型文件中指定的结构要匹配。

参考