在 Hyperledger Fabric 1.0 从零开始(十二)——fabric-sdk-java应用 中我已经把官方sdk具体改良办法,即使用办法发出来了,所有的类及文件都是完整的,在文章的结尾也说明了用法主要都依赖于ChaincodeManager这个智能合约管理器,建议以单例的形式生成该对象。
鉴于新入门的朋友在实际运用上可能需要更加简单明了的方案,这里就把最直接的方案给出,具体是写了一个FabricManager管理器,这个管理器将会接管整个java sdk与peer节点服务器及orderer排序服务器的通讯过程,包括event等时间的拦截等等,但是这里还是给一个demo级的,具体实际运用需要大家根据自己的实际场景进行简单的修改和完善。
在此之前,请现将 Hyperledger Fabric 1.0 从零开始(十二)——fabric-sdk-java应用 这篇文章中的类及结构按照自己的需要结合到自己的项目中,确保不会报错。
然后我们开始编写FabricManager管理器,这个管理器包含两个简单部分,第一部分是项目配置,第二部分是调用方法。
项目配置
节点服务器设置
1 /**
2 * 根据节点作用类型获取节点服务器配置
3 *
4 * @param type
5 * 服务器作用类型(1、执行;2、查询)
6 * @return 节点服务器配置
7 */
8 private FabricConfig getConfig() {
9 FabricConfig config = new FabricConfig();//创建配置
10 config.setOrderers(getOrderers());//设置排序服务器
11 config.setPeers(getPeers());//[]设置节点服务器对象
12 config.setChaincode(getChaincode("xxx","xxxcc", "github.com/hyperledger/fabric/chaincode/go/release/xxx", "1.0"));//设置智能合约对象
13 config.setCryptoConfigPath(getCryptoConfigPath());//设置crypto-config所在路径
14 return config;
15 }
创建配置
FabricConfig.java类创建配置,在构造器里设置crypto-config所在路径,默认路径为src/main/resources/fabric/crypto-config/
1 public FabricConfig() {
2 // 默认channel-artifacts所在路径 /xxx/WEB-INF/classes/fabric/channel-artifacts/
3 channelArtifactsPath = getChannlePath() + "/channel-artifacts/";
4 // 默认crypto-config所在路径 /xxx/WEB-INF/classes/fabric/crypto-config/
5 cryptoConfigPath = getChannlePath() + "/crypto-config/";
6 }
如下图未知:

设置排序服务器
通过getOrderers()方法新建排序服务器,在由config.setOrderers()方法添加排序服务器到设置。
1 private Orderers getOrderers() {
2 Orderers orderer = new Orderers();
3 orderer.setOrdererDomainName("example.com");//设置排序服务器所在的根域名
4 orderer.addOrderer("orderer0.example.com", "grpc://x.x.x.x");//新增排序服务器
5 orderer.addOrderer("orderer1.example.com", "grpc://x.x.x.xx");
6 orderer.addOrderer("orderer2.example.com", "grpc://x.x.x.xxx");
7 return orderer;
8 }
排序服务器可以添加一个或多个,排序服务器的域名和排序服务器的访问地址按提供的文件填写。
设置节点服务器对象
通过getPeers ()方法新建节点服务器,在由config. setPeers ()方法添加节点服务器到设置。
1 private Peers Peers() {
2 Peers peers = new Peers();
3 peers.setOrgName("XXX");//设置组织名称
4 peers.setOrgMSPID("XXXMSP");//组织名称+MSP
5 peers.setOrgDomainName("xxx.example.com");//设置组织根域名
6 peers.addPeer("peer1.xxx.example.com", "peer1.xxx.example.com", "grpc://x.x.x.x:7051", "grpc://x.x.x.x:7053", "http://x.x.x.x:7054");//添加排序服务器
7 return peers;
8 }
组织名称、MSPID、组织根域名根据实际情况填写。
设置智能合约对象
通过getChaincode ()方法获取智能合约对象,在由config. setChaincode ()方法添加智能合约对象到设置。
1 private Chaincode getChaincode(String channelName, String chaincodeName, String chaincodePath, String chaincodeVersion) {
2 Chaincode chaincode = new Chaincode();
3 chaincode.setChannelName(channelName);//设置当前将要访问的智能合约所属频道名称
4 chaincode.setChaincodeName(chaincodeName);//设置智能合约名称
5 chaincode.setChaincodePath(chaincodePath);//设置智能合约安装路径
6 chaincode.setChaincodeVersion(chaincodeVersion);//设置智能合约版本号
7 chaincode.setInvokeWatiTime(100000);
8 chaincode.setDeployWatiTime(120000);
9 return chaincode;
10 }
项目配置到这里基本就完成了,接下来是调用过程。
在述说调用过程之前,我把完整的代码粘贴出来,当然还是demo级的,但已经可以使用于生产了,如下:
1 package cn.xx.xxx.util;
2
3 import java.io.File;
4 import java.io.IOException;
5 import java.security.NoSuchAlgorithmException;
6 import java.security.NoSuchProviderException;
7 import java.security.spec.InvalidKeySpecException;
8
9 import org.hyperledger.fabric.sdk.exception.CryptoException;
10 import org.hyperledger.fabric.sdk.exception.InvalidArgumentException;
11 import org.hyperledger.fabric.sdk.exception.TransactionException;
12
13 import cn.aberic.fabric.ChaincodeManager;
14 import cn.aberic.fabric.FabricConfig;
15 import cn.aberic.fabric.bean.Chaincode;
16 import cn.aberic.fabric.bean.Orderers;
17 import cn.aberic.fabric.bean.Peers;
18 import lombok.extern.slf4j.Slf4j;
19
20 @Slf4j
21 public class FabricManager {
22
23 private ChaincodeManager manager;
24
25 private static FabricManager instance = null;
26
27 public static FabricManager obtain()
28 throws CryptoException, InvalidArgumentException, NoSuchAlgorithmException, NoSuchProviderException, InvalidKeySpecException, TransactionException, IOException {
29 if (null == instance) {
30 synchronized (FabricManager2.class) {
31 if (null == instance) {
32 instance = new FabricManager();
33 }
34 }
35 }
36 return instance;
37 }
38
39 private FabricManager()
40 throws CryptoException, InvalidArgumentException, NoSuchAlgorithmException, NoSuchProviderException, InvalidKeySpecException, TransactionException, IOException {
41 manager = new ChaincodeManager(getConfig());
42 }
43
44 /**
45 * 获取节点服务器管理器
46 *
47 * @return 节点服务器管理器
48 */
49 public ChaincodeManager getManager() {
50 return manager;
51 }
52
53 /**
54 * 根据节点作用类型获取节点服务器配置
55 *
56 * @param type
57 * 服务器作用类型(1、执行;2、查询)
58 * @return 节点服务器配置
59 */
60 private FabricConfig getConfig() {
61 FabricConfig config = new FabricConfig();
62 config.setOrderers(getOrderers());
63 config.setPeers(getPeers());
64 config.setChaincode(getChaincode("xxx", "xxxcc", "github.com/hyperledger/fabric/chaincode/go/release/xxx", "1.0"));
65 config.setChannelArtifactsPath(getChannleArtifactsPath());
66 config.setCryptoConfigPath(getCryptoConfigPath());
67 return config;
68 }
69
70 private Orderers getOrderers() {
71 Orderers orderer = new Orderers();
72 orderer.setOrdererDomainName("example.com");
73 orderer.addOrderer("orderer1.example.com", "grpc://x.x.x.x:7050");
74 orderer.addOrderer("orderer0.example.com", "grpc://x.x.x.xx:7050");
75 orderer.addOrderer("orderer2.example.com", "grpc://x.x.x.xxx:7050");
76 return orderer;
77 }
78
79 /**
80 * 获取节点服务器集
81 *
82 * @return 节点服务器集
83 */
84 private Peers getPeers() {
85 Peers peers = new Peers();
86 peers.setOrgName("XXX");
87 peers.setOrgMSPID("XXXMSP");
88 peers.setOrgDomainName("xxx.example.com");
89 peers.addPeer("peer1.xxx.example.com", "peer1.xxx.example.com", "grpc://x.x.x.x:7051", "grpc://x.x.x.x:7053", "http://x.x.x.x:7054");
90 return peers;
91 }
92
93 /**
94 * 获取智能合约
95 *
96 * @param channelName
97 * 频道名称
98 * @param chaincodeName
99 * 智能合约名称
100 * @param chaincodePath
101 * 智能合约路径
102 * @param chaincodeVersion
103 * 智能合约版本
104 * @return 智能合约
105 */
106 private Chaincode getChaincode(String channelName, String chaincodeName, String chaincodePath, String chaincodeVersion) {
107 Chaincode chaincode = new Chaincode();
108 chaincode.setChannelName(channelName);
109 chaincode.setChaincodeName(chaincodeName);
110 chaincode.setChaincodePath(chaincodePath);
111 chaincode.setChaincodeVersion(chaincodeVersion);
112 chaincode.setInvokeWatiTime(100000);
113 chaincode.setDeployWatiTime(120000);
114 return chaincode;
115 }
116
117 /**
118 * 获取channel-artifacts配置路径
119 *
120 * @return /WEB-INF/classes/fabric/channel-artifacts/
121 */
122 private String getChannleArtifactsPath() {
123 String directorys = FabricManager.class.getClassLoader().getResource("fabric").getFile();
124 log.debug("directorys = " + directorys);
125 File directory = new File(directorys);
126 log.debug("directory = " + directory.getPath());
127
128 return directory.getPath() + "/channel-artifacts/";
129 }
130
131 /**
132 * 获取crypto-config配置路径
133 *
134 * @return /WEB-INF/classes/fabric/crypto-config/
135 */
136 private String getCryptoConfigPath() {
137 String directorys = FabricManager.class.getClassLoader().getResource("fabric").getFile();
138 log.debug("directorys = " + directorys);
139 File directory = new File(directorys);
140 log.debug("directory = " + directory.getPath());
141
142 return directory.getPath() + "/crypto-config/";
143 }
144
145 }
调用过程
调用过程其实就是对FabricManager管理器的具体应用,一般都在impl中进行,具体可执行代码如下:
1 ChaincodeManager manager = FabricManager.obtain().getManager(); 2 3 manager.invoke(fcn, arguments); 4 5 manager.query(fcn, arguments);
具体返回结果的运用需要各位智能合约编写返回结果的解析来支持,这里需要结合业务来实操,无法说的详尽。
需要注意区块链的事务处理,另外还有invoke和query的区别。
至此整个java sdk的改良使用和调用方法应该就完成了,如果还有什么问题,可以留言讨论。
