Writing Your First Application
编写你的第一个程序。
编写你的第一个程序。
本文档的目标是使阅读本文档的人能基于HyperLedger Fabric Network编写自己的第一个程序。
在这个程序里,我们提供最基本的功能: 用户能在账本中查询一条数据或者用户更新账本中的一条数据。
我们的程序是使用JAVASCRIPT编写,运行在NODEJS平台上。 此文档将会指导你通过三步去编写你的第一个程序。
第一步:
运行一个HyperLedger Fabric BlockChain Network。
我们需要一些基础组件去查询和更新账本。 一个通道节点(peer node), 排序节点(Ordering node)和认证授权中心(Certificate Authority )--作为我们的网络支撑。
我们还需要一个CLI容器来执行管理命令。 一个单独的脚本将会下载和运行这个测试网络。
第二步:
学习我们的程序将要使用的智能合约的参数。
我们的智能合约允许我们使用多种不同的方法去操作账本(Ledger)。 例如: 我们可以读取数据的整体或者是一部分(we can
read data holistically or on a more granular level.)。
第三步:
部署程序去查询和更新数据。
我们提供两种简单的程序 ---- 一个查询账本,另一个更新账本。 我们的程序将会使用超级账本的SDK API 去影响 HyperLedger.
在完成本教程之后,你应该对如何使用HyperLedger Fabric Network提供的NODEJS的API去编写自己的程序有一个基本的理解。
首先,让我们运行我们的HyperLedger。
运行一个HyperLedger Fabric BlockChain Network。
我们需要一些基础组件去查询和更新账本。 一个通道节点(peer node), 排序节点(Ordering node)和认证授权中心(Certificate Authority )--作为我们的网络支撑。
我们还需要一个CLI容器来执行管理命令。 一个单独的脚本将会下载和运行这个测试网络。
第二步:
学习我们的程序将要使用的智能合约的参数。
我们的智能合约允许我们使用多种不同的方法去操作账本(Ledger)。 例如: 我们可以读取数据的整体或者是一部分(we can
read data holistically or on a more granular level.)。
第三步:
部署程序去查询和更新数据。
我们提供两种简单的程序 ---- 一个查询账本,另一个更新账本。 我们的程序将会使用超级账本的SDK API 去影响 HyperLedger.
在完成本教程之后,你应该对如何使用HyperLedger Fabric Network提供的NODEJS的API去编写自己的程序有一个基本的理解。
首先,让我们运行我们的HyperLedger。
Getting a Test Network
获取一个测试网络。
获取一个测试网络。
确保你已经安装了所有必须的依赖软件。
首先决定你要克隆Fabric-samples到哪一个目录,然后运行克隆脚本,随后进入fabric的子目录。
git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples/fabcar
这个子目录(fabcar)包含脚本和程序代码可以运行简单的fabric程序。 运行ls命令你将会看到如下内容:
chaincode invoke.js network package.json query.js startFabric.sh
现在我们运行startFabric.sh脚本去运行网络。
./startFabric.sh
注意: 这个脚本将会下载HyperLedger Fabric Docker 镜像,所以它将会运行一会儿。
为了简洁起见, 我们不会深挖这个命令运行时发生了什么, 这里给出了一个大概内容。
启动一个通道节点(peer node), 排序节点(Ordering node)和认证授权中心(Certificate Authority )和一个CLI 容器。
创建一个通道并且将启动的节点加入通道。
在启动的节点上安装智能合约并且安装启动chainCode。
调用initLedger添加10条数据到账本中。
注意: 这些操作通常有管理员来完成。 本脚本使用CLI执行脚本完成操作。同时SDK也能很好的支持这些操作。
执行docker ps 命令去显示startFabric.sh脚本运行的进程。 你可以通过Building Your First Network来学习更多细节和关于这些机器的操作。
在这里我们把注意力放在程序这里。下面的图片简单展示了程序是如何访问HyperLedger Fabric Netowrk。
首先决定你要克隆Fabric-samples到哪一个目录,然后运行克隆脚本,随后进入fabric的子目录。
git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples/fabcar
这个子目录(fabcar)包含脚本和程序代码可以运行简单的fabric程序。 运行ls命令你将会看到如下内容:
chaincode invoke.js network package.json query.js startFabric.sh
现在我们运行startFabric.sh脚本去运行网络。
./startFabric.sh
注意: 这个脚本将会下载HyperLedger Fabric Docker 镜像,所以它将会运行一会儿。
为了简洁起见, 我们不会深挖这个命令运行时发生了什么, 这里给出了一个大概内容。
启动一个通道节点(peer node), 排序节点(Ordering node)和认证授权中心(Certificate Authority )和一个CLI 容器。
创建一个通道并且将启动的节点加入通道。
在启动的节点上安装智能合约并且安装启动chainCode。
调用initLedger添加10条数据到账本中。
注意: 这些操作通常有管理员来完成。 本脚本使用CLI执行脚本完成操作。同时SDK也能很好的支持这些操作。
执行docker ps 命令去显示startFabric.sh脚本运行的进程。 你可以通过Building Your First Network来学习更多细节和关于这些机器的操作。
在这里我们把注意力放在程序这里。下面的图片简单展示了程序是如何访问HyperLedger Fabric Netowrk。
好吧, 现在你有了一个简单的网络环境和一些能与这个环境交互的代码,让我们将这两部分组合到一起吧。
How Applications Interact with the Network
如何使用程序
如何使用程序