区块链Hyperledger Composer 开发应用程序（三）

1. 编写Node.js应用程序

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

样本landregistry.js文件包含代表土地登记处的类别，并包含列出土地标题，添加默认标题和提交交易的方法。这已使用JavaScript类实现; 但是你可以自由地构建你的代码，只要你愿意。

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

如果您不熟悉基于Promise的开发，那么值得在线查看一些教程以获取想法。除此之外，在节点8中，现在支持async / await，这使得开发异步应用程序变得更加容易。这里显示的示例使用await并假定代码包含在具有async属性的函数中

需要模块

Copy 复制

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

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

连接到Hyperledger Composer运行时

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

Copy 复制

this.bizNetworkConnection = new BusinessNetworkConnection();

我们要在这里创建的第一个Hyperledger Composer API调用是connect（）API，用于在Hyperledger Fabric上建立与Hyperledger Composer运行时的连接。需要提供适当的cardName用于连接，例如admin@digitalproperty-network可能是有效的卡名称，具体取决于数字资产网络的部署方式。如果成功，此API将对商业网络定义返回一个承诺：

Copy 复制

let this.businessNetworkDefinition = await this.bizNetworkConnection.connect(cardName);

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

将资产添加到注册表

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

Copy 复制

this.titlesRegistry = await this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle');

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

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

Copy 复制

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

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

Copy 复制

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

我们现在创建了一个需要存储在注册表中的土地所有权。

Copy 复制

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

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

Copy 复制

let personRegistry = await this.bizNetworkConnection.getParticipantRegistry('net.biz.digitalPropertyNetwork.Person');
await personRegistry.add(owner);

将资产列入注册表中

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

Copy 复制

let registry = await this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle');
let aResources = await registry.getAll();
let table = new Table({
    head: ['TitleID', 'OwnerID', 'First Name', 'Surname', 'Description', 'ForSale']
});
let arrayLength = aResources.length;
for (let i = 0; i < arrayLength; i++) {
    let tableLine = [];
    tableLine.push(aResources[i].titleId);
    tableLine.push(aResources[i].owner.personId);
    tableLine.push(aResources[i].owner.firstName);
    tableLine.push(aResources[i].owner.lastName);
    tableLine.push(aResources[i].information);
    tableLine.push(aResources[i].forSale ? 'Yes' : 'No');
    table.push(tableLine);
}
  // Put to stdout - as this is really a command line app
return table;

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

Copy 复制

asset LandTitle identified by titleId {
  o String   titleId
  o Person   owner
  o String   information
  o Boolean  forSale   optional
}

participant Person identified by personId {
  o String personId
  o String firstName
  o String lastName
}

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

提交交易

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

Copy 复制

transaction RegisterPropertyForSale identified by transactionId{
  o String transactionId
  --> LandTitle title
}

该交易在这里有两个字段，一个trandsactionId，以及对应该提交出售的土地所有权的引用。第一步是访问登陆注册地的标题，并找回我们要提交出售的具体土地所有权。

Copy 复制

let registry = await this.bizNetworkConnection.getAssetRegistry('net.biz.digitalPropertyNetwork.LandTitle');
await registry.get('LID:1148');

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

Copy 复制

let serializer = this.businessNetworkDefinition.getSerializer();

let resource = serializer.fromJSON({
  '$class': 'net.biz.digitalPropertyNetwork.RegisterPropertyForSale',
  'title': 'LID:1148'
});

await this.bizNetworkConnection.submitTransaction(resource);

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

2. 编写Web应用程序

要与已部署的业务网络进行交互，Web应用程序应该创建REST API调用。要为业务网络创建自定义REST API，请使用该composer-rest-server命令。

要创建可与REST API交互的骨架Angular应用程序，请使用该yo hyperledger-composer命令。

请按照开发者教程中关于如何使用composer-rest-server和Angular生成器的例子。

从业务网络存档（.BNA）生成Angular应用程序

构建Angular应用程序的流程如下所示：

如果您已经拥有Business Network Archive并希望构建骨架Angular应用程序，请使用以下参考说明，如果您想全面了解如何从头开发BNA并从此构建应用程序，请参阅开发人员教程。

先决条件

• 您将需要Hyperledger Composer 开发工具才能运行Angular生成器。
• 您想要部署的业务网络存档（.BNA）。

1.启动在本地机器上运行的Hyperledger Fabric

如果您已经安装了开发工具，则将安装Hyperledger Fabric。

前往fabric-dev-servers目录并启动Hyperledger Fabric。如果您使用了我们的开发工具安装指南，以下代码是一个示例：

Copy 复制

cd ~/fabric-dev-servers
./startFabric.sh
./createPeerAdminCard.sh

这也将创建一个PeerAdmin.card文件，它需要修改在部署的同位体上运行的代码。

您可以随时通过运行以下命令列出您已安装的所有卡：

Copy 复制

composer card list

2.准备Hyperledger Fabric对等体

为了将业务网络存档安装到Hyperledger Fabric网络上，您需要将业务网络安装到对等设备上。建议您从一个干净的目录开始。将您的BNA移入该目录并将终端目录更改为该目录。

您需要拥有业务网络存档才能执行此操作，下面您可以看到一个示例tutorial-network以及用于部署的“PeerAdmin”卡。

Copy 复制

composer network install --card PeerAdmin@hlfv1 --archiveFile [email protected]

3.在Hyperledger Fabric上启动您的业务网络

我们将使用该composer network start命令启动业务网络，我们将需要使用我们的PeerAdmin卡来完成此操作。我们还需要在我们的网络上创建用户，我们将使用“管理员”用户名和密码开始。

以下是使用tutorial-networkBNA 的示例。

Copy 复制

composer network start --networkName tutorial-network --networkVersion 0.0.1 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1

这将为业务网络创建一个“管理员”卡，在前面的例子中就是这样 [email protected]

请注意：admin用户名和adminpw密码是针对为开发者教程中部署的Hyperledger Fabric实例配置的特定Hyperledger Fabric标识。如果您已从头开始配置Hyperledger Fabric实例，则这些身份详细信息将有所不同。

4.安装“管理员”卡准备好使用

接下来我们将采用我们刚刚制作的管理卡，并将其导入以用于您的业务网络。

Copy 复制

composer card import --file [email protected]

5.启动REST服务器并生成Swagger API文档

导航到您的目录并运行该composer-rest-server命令。

Copy 复制

composer-rest-server

• 输入admin @ tutorial-network作为卡片名称。确保不要添加.card扩展名。
• 询问是否在生成的API中使用名称空间时，请选择不使用名称空间。
• 当询问是否保护生成的API时选择否。
• 当询问是否启用事件发布时，选择是。
• 当被问及是否启用TLS安全时，请选择否。

剩下的服务器将在http：// localhost：3000 / explorer上生成并可用

6.生成Angular应用程序

Angular应用程序需要运行其他服务器才能连接到Fabric实例。确保您在执行此操作时已在后台运行REST服务器。运行Yeoman生成器时，您还需要与.BNA文件位于同一目录中。

Copy 复制

yo hyperledger-composer

按照下面的内容输出匹配。

Copy 复制

Welcome to the Hyperledger Composer project generator
? Please select the type of project: Angular
You can run this generator using: 'yo hyperledger-composer:angular'
Welcome to the Hyperledger Composer Angular project generator
? Do you want to connect to a running Business Network? Yes
? Project name: [insert]
? Description: Hyperledger Composer Angular project
? Author name: [insert]
? Author email: [insert]
? License: Apache-2.0
? Name of the Business Network card: admin@tutorial-network
? Do you want to generate a new REST API or connect to an existing REST API?  Connect to an existing REST
 API
? REST server address: http://localhost
? REST server port: 3000
? Should namespaces be used in the generated REST API? Namespaces are not used
Created application!

生成的应用程序将位于Project name上面输入的子目录内。

最后进入这个目录并运行应用程序，运行：

Copy 复制

npm start

它将在http：// localhost：4200上可用

3. 订阅活动

Node.js应用程序可以通过使用composer-client.BusinessNetworkConnection.onAPI调用来订阅来自业务网络的事件。事件在业务网络模型文件中定义，并由事务处理函数文件中的指定事务处理。有关发布事件的更多信息，请参阅发布事件。

在你开始之前

在应用程序可以订阅事件之前，您必须已经定义了一些事件以及将发出它们的事务。业务网络也必须部署，并且您必须具有可连接到它的连接配置文件。

程序

1. 应用程序必须发送特定的API调用以订阅业务网络中事件发出的事务。目前，订阅事件的应用程序将接收所有发出的事件。API调用应采用以下格式：

Copy 复制

businessNetworkConnection.on('event', (event) => {
    // event: { "$class": "org.namespace.BasicEvent", "eventId": "0000-0000-0000-000000#0" }
    console.log(event);
});

这包括BasicEvent在发布事件文档中创建的一个事件。该eventId属性总是transactionId与发送事件的事务相同，并在表单中附加一个数字"transactionId": "#number"。