本文介绍fabric的应用开发模型,Node SDK的使用以及运行一个简单的fabric应用示例。

前言

前面提到的fabric示例(如first-network和e2e-cli)都只是在单机上的简单测试,启动一个cli命令行容器来与网络成员节点进行交互,通过在cli容器中手动输入命令完成一系列操作。

而在实际开发中,fabric区块链应用应该拥有一个完整的应用程序来处理前端发起的请求,调用SDK与各节点进行交互,最终利用fabric底层特性将数据存入区块链中。

应用模型

架构图

Fabric应用可以分为三层,App层,SDK层,Fabric底层。开发人员需要开发的包括app应用和链码chaincode。应用程序一般运行于客户端节点上,负责处理请求并调用相应SDK与Peer节点,Orderer节点,CA节点进行通信。chiancode负责业务逻辑的执行,从账本查询数据或更新数据到账本。

Fabric Node SDK

Hyperledger fabric支持多种语言的SDK,包括Go, Node.js, Java, Python。其中Node SDK由官方维护,最为稳定,文档资料也最为齐全。

Node SDK主要的模块及其中重要的方法如下:
1.Client

  • getUserContext() / setUserContext():从本地读取/写入用户信息
  • 创建其他各种类的示例

2.CAClient

  • register():登记
  • enroll():注册

3.Channel

  • sendTransactionProposal():发送提案
  • sendTransaction():发送交易
  • queryByChaincode():调用链码查询
  • 各种与区块、交易有关的查询功能

4.Peer

  • sendProposal():发送交易提案到Peer节点

5.Orderer

  • sendBrodcast():发送数据到Ordere节点
  • sendDeliver():从Orderer节点获取数据

Balance Transfer

Blacne transfer是Fabric Node SDK的一个示例应用,基于Node.js的express框架实现了完整的web服务,提供了RESTful接口,实现网络初始化,用户注册生成证书,交易转账,查询等功能。

1.下载示例
下载前需要部署所需环境,前文以及详细介绍,这里不再赘述。注意fabric-samples的版本最好与fabric镜像的版本保持一致,否则可能会出现各种错误,可以利用git checkout加上指定版本tag切换版本。

git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples/balance-transfer

2.启动网络
在终端1执行:

./runApp.sh

该脚本完成:

  • 启动fabric网络节点(docker-compose up)
  • 下载所需node模块(npm install)
  • 启动应用程序监听4000端口(node app.js)

3.测试网络
测试前需要下载jq:

sudo apt-get install jq

在终端2执行测试脚本,主要是利用curl工具发送请求:

./testAPIs.sh

该脚本完成:

  • 创建通道并加入节点
  • 按照和实例化链码
  • 调用执行转账交易操作
  • 进行各种查询操作

4.关闭网络

# 清除所有容器并删除docker网络
cd artifacts
docker-compose down
# 删除chaincode镜像
docker rmi -f $(docker images | grep dev | awk '{print $3}')
# 删除用户数据,包括私钥和证书
rm -rf fabric-client-kv-org[1-2]

标签: fabric

已有 4 条评论

  1. 这个搭建只是为了测试,我想用到web上,那我这个怎么搞,大神有推荐网址吗?我才学,不太懂。不过感谢大神的分享。

    1. zyj zyj

      参考上面的应用模型图,可以在应用层之上再封装一个web层。用户进行前端交互,调用后台的app层接口。

  2. YUX YUX

    你好,请问有弄过fabric-java-sdk 的吗?还有你github上面那个fabric-tool主要做什么的呢?

    1. zyj zyj

      只用过node-sdk,不过两者功能差不多。fabric-tools主要是一些基于node-sdk的 动态增删组织 和 多机部署 的自动化脚本。

添加新评论