这是一个基于fabric-sdk-java的项目，该项目的主要目的是简化HyperLedger/Fabric开发人员在SDK应用层上的工作流程，使得开发和部署更加简单。
该项目使用方便，只需要部署有Docker及docker compose环境即可轻松调用Fabric网络接口，包括执行、查询智能合约，以及trace相关的溯源接口。
- IntelliJ IDEA
- Maven
- JDK-1.8
- spring-boot
- Docker
- docker compose
0.x系列的版本主要是非Docker应用方面的项目，即相互交流的源码层项目。
1.x及以上系列的版本均Docker项目，帮助开发人员快速部署SDK应用，减少开发环节，从而实现业务的快速落地。
提供链接的为已发布版本，未提供连接的为待实现版本。
目前主要版本如下列表所示：
v0.1：无数据库版，适合轻量级的Fabric平台应用。
v0.2：含关系型数据库版，适合单服务管理多Fabric网络。
v1.0-alpha：提供Docker容器服务，方便SDK快速部署。此版本为单排序服务及单节点服务配置，符合绝大部分需求。
v1.0-beta：新增支持多服务节点。
v1.0-beta2：修复重新新增组织、排序服务和节点服务的bug；提供更新组织、排序服务和节点服务的接口；新增Swagger2文档支持。
v1.0-RC：新增通过SDK加入通道、安装合约、实例化合约以及升级合约等功能。
1、确定Linux内核在3.10及以上。
2、在待部署SDK服务器上安装Docker及docker compose环境。
3、执行docker pull aberic/fabric-sdk:1.0-beta2下载镜像。
4、在docker-sdk.yaml文件中配置好Fabric网络中所期望连接的排序服务及节点服务参数，这两类服务各允许设置一台，后续的版本中会增加使用SDK多服务网络方案。
5、执行docker-compose -f docker-sdk.yaml up启动SDK镜像服务，如果不需要观察日志，则在命令最后追加-d即可。
6、服务启动完成后，参考下面的API介绍以便更快投入使用。
docker-sdk.yaml说明
关于docker-sdk.yaml编排文件中的参数，主要来自两个地方，一是二进制生成的证书文件目录crypto-config（点击链接自行学习二进制文件生成指定证书文件以及参考crypto-config文件配置），二是在当前Fabric网络中创建的通道以及通道中创建的智能合约信息。
首先参考crypto-config，在该文件中定义的参数与docker-sdk.yaml中关于排序服务以及节点服务的信息相对应。
相对其他配置如通道及合约的也是如上对应，具体参数释义如下表所示：
| Environment | Description | map |
|---|---|---|
| ORG_NAME | 节点所属组织名称 | 参见crypto-config文件中 -> PeerOrgs-Name |
| ORG_TLS | 节点是否开启TLS | 根据自身创建网络情况选择true或false |
| ORG_USERNAME | 节点所属组织用户名称 | 参见crypto-config目录下的两个用户，默认配置中选择的Admin |
| ORG_CRYPTO_CONFIG_DIR | 映射到容器中的crypto-config目录 | 即crypto-config目录 |
| ORG_MSP_ID | 节点所属组织ID | 参见configtx文件中 -> Organizations-&Org1-Name |
| ORG_DOMAIN_NAME | 节点所属组织域名名称 | 参见crypto-config文件中 -> PeerOrgs-Domain |
| ORG_ORDERER_DOMAIN_NAME | 节点所属排序服务域名名称 | 参见crypto-config文件中 -> OrdererOrgs-Domain |
| ORG_CHANNEL_NAME | 自行创建的通道名称 | 如：peer channel create -o orderer.example.com:7050 -c mychannel -t 50 -f ./channel-artifacts/mychannel.tx 命令所创建的mychannel |
| ORG_CHAINCODE_NAME | 智能合约名称 | 如：peer chaincode install -n testcc -p github.com/hyperledger/fabric/aberic/chaincode/go/chaincode_example02 -v 1.0 命令所创建的testcc |
| ORG_CHAINCODE_PATH | 智能合约路径 | 如：peer chaincode install -n testcc -p github.com/hyperledger/fabric/aberic/chaincode/go/chaincode_example02 -v 1.0 命令中的github.com/hyperledger/fabric/aberic/chaincode/go/chaincode_example02 |
| ORG_CHAINCODE_VERSION | 智能合约版本 | 如：peer chaincode install -n testcc -p github.com/hyperledger/fabric/aberic/chaincode/go/chaincode_example02 -v 1.0 命令中的1.0 |
| ORG_PROPOSAL_WAIT_TIME | 单个提案请求超时时间以毫秒为单位 | 默认90000 |
| ORG_INVOKE_WAIT_TIME | 事务等待时间以秒为单位 | 默认120 |
| ORDERER_NAME | 排序服务名称 | 参见configtx文件中 -> Orderer-Addresses |
| ORDERER_LOCATION | 排序服务访问路径 | 根据自身设置实际情况修改，一般为grpc://host:port的格式 |
| PEER_NAME | 节点服务域名名称 | 参见crypto-config目录下的节点域名列表 |
| PEER_EVENT_HUB_NAME | 节点服务事件域名名称 | 同上 |
| PEER_LOCATION | 节点服务路径 | 根据自身设置实际情况修改，一般为grpc://host:port的格式 |
| PEER_EVENT_HUB_LOCATION | 节点服务事件路径 | 根据自身设置实际情况修改，一般为grpc://host:port的格式 |
| PEER_IS_EVENT_LISTENER | 节点所属组织名称 | 根据自身需求选择是否监听回调服务 |
docker-sdk.yaml中的image: aberic/fabric-sdk，可以指定其版本号，默认是latest。
docker-sdk.yaml中volumes的挂载与ORG_CRYPTO_CONFIG_DIR变量相关，volumes使用方法请学习compose相关知识。
docker-sdk.yaml中的ports，后一个为容器中端口号，不用修改，冒号前的可以指定为自身服务器未占用的端口号，最终调用sdk接口时通过冒号前指定的端口号即可。
API入口文档
| Method | REST API | Description |
|---|---|---|
| POST | /sdk/chaincode/invoke | 执行智能合约 |
| POST | /sdk/chaincode/query | 查询智能合约 |
| POST | /sdk/org/add | 新增组织对象 |
| GET | /sdk/org/list | 获取组织对象集合 |
| POST | /sdk/org/update | 更新组织对象 |
| POST | /sdk/orderer/add | 新增排序服务对象 |
| GET | /sdk/orderer/list/{hash} | 获取排序服务对象集合 |
| POST | /sdk/orderer/update | 更新排序服务对象 |
| POST | /sdk/peer/add | 新增节点服务对象 |
| GET | /sdk/peer/list/{hash} | 获取节点服务对象集合 |
| POST | /sdk/peer/update | 更新节点服务对象 |
| POST | /sdk/trace/hash | 根据交易hash查询区块 |
| POST | /sdk/trace/number | 根据交易区块高度查询区块 |
| POST | /sdk/trace/txid | 根据交易ID查询区块 |
| GET | /sdk/trace/info/{hash} | 根据当前组织hash查询当前链信息 |
该版本目前为即上即用的版本，仅提供单排序服务及单节点服务，因此API文档中未提供安装、实例化及升级操作，但在后续更新中，会支持安装、实例化及升级的功能。如果有PAAS服务的需要，可以自行参考v0.2中的方案来解决。
由于提供了swagger2接口文档，在本文档中就不再赘述接口样例，可自行在swagger-editor进行查阅。
也可以通过当前部署fabric-sdk-container服务器的ip和配置文件中映射的端口号进行访问，如http://ip:port/swagger-ui.html。
这里有几个点需要说明一下：
1、组织hash可以通过/sdk/org/list接口获取，这个接口获取的是一个集合，请选择你所需要的组织hash。
2、args是调用合约传入的参数，在用go编写智能合约的时候，智能合约所接收的参数为一个字符串数组，其中字符串数组的第一个参数是智能合约的方法名。chaincode接口中的args所传入的参数就是智能合约所接收的数组参数。
3、新增排序服务和节点服务中的hash来自新增组织的api回调结果，即必须先新增组织，然后在该组织下新增排序服务和节点服务，以此来完成一个Fabric的组网操作。
sdk-advance是基于fabric-sdk-java v1.1的服务，其主要目的是为了更简单的使用fabric-sdk-java，对原有的调用方法做了进一步封装，主要提供了各种中转对象，如智能合约、通道、排序服务、节点、用户等等，最终将所有的中转对象交由一个中转组织来负责配置，其对外提供服务的方式则交给FabricManager来掌管。
该项目仅作为学习分享的形式提交维护，关于生产部署方面，sdk-advance与app的交互可自行选择采用thrift或protobuf等数据传输协议实现，这里并没有提供该方案的具体实现，需要自己动手解决。
intermediate系列对象是该项目的主要封装对象，间接屏蔽了真实应用层与fabric-sdk-java之间的直接交互。
- IntermediateOrderer
对于Orderer，我们需要知道所选组织名称，同时还需要知道Orderer的服务器域名及真实访问地址。这里的服务器域名是指由crypto-config.yaml中进行指定。
该对象主要提供了对Orderer的服务器域名及真实访问地址的封装。 - IntermediatePeer
Peer是部署于本地节点的配置对象，主要包括当前指定的组织节点域名、当前指定的组织节点事件域名、当前指定的组织节点访问地址、当前指定的组织节点事件监听访问地址以及当前peer是否增加Event事件处理。这里的主要配置信息也由crypto-config.yaml中进行指定 - IntermediateChannel
每一个Peer所加入的Channel都有独立的通道信息，包括名称或通道tx文件等。IntermediateChannel中定义了通道名称，除此之外，还针对上面两个对象进行了调用，并最终生成了Channel对象。
IntermediateChannel中已经开始提供对外服务了，主要依赖于Channel对象所提供的，包括最基本的Peer加入频道的方法。
另外，IntermediateChannel还提供了一系列基本的溯源方法，包括查询当前频道的链信息，包括链长度、当前最新区块hash以及当前最新区块的上一区块hash、在指定频道内根据transactionID查询区块、在指定频道内根据hash查询区块以及在指定频道内根据区块高度查询区块等方法。 - IntermediateChaincodeID
IntermediateChaincodeID对象与IntermediateChannel相似，除了包含了必须的成员参数外，也提供了一些对外服务。在IntermediateChaincodeID中主要对智能合约名称、包含智能合约的go环境路径、智能合约安装路径、智能合约版本号、指定ID的智能合约以及单个提案请求的超时时间以毫秒为单位和事务等待时间以秒为单位。
同时对外提供了安装智能合约、实例化智能合约、升级智能合约、执行智能合约以及查询智能合约的服务。 - IntermediateUser
Fabric中有用户的概念，当然除了用户之外，在1.1中也有组织、节点等基于CA服务的概念。IntermediateUser主要就是用来处理用户CA信息的，目前尚未对此类服务提供更好的封装策略，后续更新中会逐步加入进来，以便提供更简便的实现方案。当前的具体实现可参考IntermediateOrg。 - IntermediateOrg
上述无论是排序服务、节点服务或是通道、合约等内容，都应该被同一个组织所拥有，这里的同一个是指单体组织，而不是只为一个组织服务，整个基于Fabric的区块链网络至少应该为一个组织提供服务。
在IntermediateOrg中集合了已有的对象信息，并从中生成了组织用户以便调用Fabric网络中的接口数据。案例中的方案并非最优方案，关于Fabric CA的实践还没有完成（按照官方的Demo实现无法跑通，如果有能够实现的朋友，欢迎提交代码）。
- OrgManager
组织生成器，该对象已经完全暴露给APP所使用，可以通过SimpleManager对象查看其主要用法。通过OrgManager对外暴露的服务生成系列Intermediate对象，并最终使用use方法确定调用的组织具体对象来生成真正提供Fabric区块链网络服务的FabricManager。
在使用OrgManager的时候，如果有进一步开发SAAS或更深层BAAS服务的想法，建议不要直接使用SimpleManager中的方案，而是结合关系型数据库如MySQL等解决方案，将组织中的相关数据持久化，以便后台可以直接获取并调用。 - FabricManager
区块链网络服务管理器FabricManager，作为APP直接调用Fabric区块链网络的入口对象，该对象提供了Channel和ChaincodeID相关的所有接口。
simple是一个基于spring-boot的项目，在simple中主要关注SimpleManager对象的使用。
我的这个simple中的ip的自己申请的服务器，大家可以随便测试，但不保证有效期，建议自行搭建本地服务测试。
欢迎与我多多交流：
技术博客：HyperLedger/Aberic
HyperLedger/Fabric微信交流群，扫微信订阅号加入：
