fabric-samples到底包含了哪些案例？

00 导言

      在上一讲《Fabric 环境搭建时bootstrap.sh帮我们做了什么？》中，我们知道bootstrap.sh帮我们做了三件事：

1. 从github上克隆 hyperledger/fabric-samples并进入该目录，然后检出适当的版本
2. 在fabric-samples目录下安装特定平台的 Hyperledger Fabric 二进制可执行文件 和配置文件
3. 下载 指定版本的Hyperledger Fabric 的docker镜像

      其中第一件事情就是从github上克隆 hyperledger/fabric-samples，克隆完成后，它里面包含的目录如下。

360截图20180806161424892.png

      接下来我们来介绍一下这些目录是干什么的？这些目录里包含了一些什么？

01 balance-transfer目录

      这是一个转账的案例，通过node.js SDK完成如下功能：创建通道(chanel)，加入通道，部署链码（chaincode-就是智能合约），实例化链码，调用链码完成交易，以及查询链码等功能。链码的编程语言提供了两种语言的示例：golang和node.js语言。而app端又提供了两种语言的示例:node.js和typescript。整体如下图。

360截图20180806161613515.png

02 basic-network目录

      该目录提供了一系列shell脚本，去生成初始化并启动一个最基本的网络，包含一个order节点，一个组织下的一个普通的peer节点。

脚本	作用
init.sh	删除之前存储的证书数据
generate.sh	生成加密材料、创世区块、通道等
start.sh	启动网络
stop.sh	删除网络
teardown.sh	彻底删除所有与网络有关的证据（删除存储和镜像）

03 chaincode目录

      该目录是一些链码的示例，包括以下目录：

目录	作用
abac	Attribute-Based Access Control 基于身份属性的访问控制
chaincode_example02	一个简单的账户间转账和查询 的示例
fabcar	一个关于汽车的综合示例，提供了Fabric功能的广泛演示。 演示与证书颁发机构进行交互并生成注册证书的过程，用这些身份来查询和更新帐本
marbles02	弹珠资产管理链码，演示couchDB的富查询（基于json）
marbles02-private	暂不了解
sacc	SimpleAssetChainCode 简单资产管理链码示例

04 chaincode-docker-devmode目录

      该目录演示在开发网络时，利用预生成的order和chanel来启动“开发模式”。 这样，用户可以立即进入编译链码和驱动调用的过程。

      通常，链码由peer节点启动和维护。 然而，在“开发模式”中，链码由用户构建和启动。在链代码开发阶段，此模式非常有用，可用于快速代码/构建/运行/调试。

05 fabcar目录

      一个汽车的例子，主要是通过单机配置模拟环境，实现管理员admin用户的enrollAdmin（注册管理），其他用户的注册（主要是指user1），以及实现query和invoke。

      该目录下主要包含的是一些js文件和一个startFabric.sh，没有包含链码（相关的链码放在chaincode/fabcar目录下）。运行startFabric.sh会先运行basic-network启动网络。

06 fabric-ca目录

      演示如何使用Hyperledger Fabric CA客户端和服务器为order，peer，管理员和最终用户生成加密证书上，以便私钥永远不会离开生成它们的主机或容器。

      为啥要使用CA呢？ cryptogen加密工具不适用于生产环境，因为它在一个位置生成所有私钥，然后必须将其复制到适当的主机或容器。

07 first-network目录

      我们平常说的搭建hyperledger fabric环境，一般指的是就是部署运行这个示例。该目录下提供一个脚本byfn.sh文件，该文件提供一条龙服务，演示了生成证书，启动网络节点（两个组织，每个组织有2个节点），以及部署、实例化链码，并调用链码进行转账和查询，最后停止整个网络。本示例采用的是solo共识服务机制。

08 high-throughput目录

      访目录提供的案例，用于演示如何正确设计链码数据模型，以处理在每秒数千个并发事务，这些事务都更新了账本的相同资产。实际上就如何处理高并发的情况！

09 scripts目录

      访目录提供了两种不同的脚本，一个是bootstrap.sh，该脚本跟《Fabric 环境搭建时bootstrap.sh帮我们做了什么？》中说的bootstrap.sh几乎一致，只是少了个sampleInstall这个过程。

      还有一种是Jenkins_Scripts，对这行种脚本小编了解得不多，只知道Jenkins是一种基于Java开发的一种持续集成工具。

10 总结

      到此为止，我们几乎把fabric-samples的一级目录和文件都作了个简单的介绍。

      学习hyperledger fabric，我们除了首先要学习环境怎么部署和搭建之外，还需要通过一些案例来透彻理解fabric的架构设计、账户体系、授权认证机制、以及智能合约和SDK等方方面面的内容。而fabric-samples里正好包含了若干案例，来帮助我们达到这些目标。可以说，只要认真研究了fabric-samples提供的这些案例，基本上已经对hyperledger fabric的技术知识体系和动作原理有一定的了解了，接下来就要多多参与到工程级别的项目开发中，积累更多业务方面的经验，让hyperledger fabric更接地气，更面向实际业务场景！

      由于小编的技术和业务水平有限，未能完全参透此目录的所有案例的内容。所以在这一讲中，我们只是简单介绍了一下各案例和对应的目录结构，后期，我们还会出一系列的文章来详细讲解这些案例并把这些案例部署运行起来。敬请期待！