网上大多fabric sdk java1.1的教程文章大多以测试官方的sdk java中End2endIT示例,但官方提供的sdk注释少难以运用,这两周对别人重新封装的几套sdk进行测试。下面是一些链接。
- https://github.com/hyperledger/fabric-sdk-java/tree/release-1.1 官方fabric sdk java1.1(可以参照网上其他教程先将其中的End2endIT 示例测试通过,测试通过也确保了maven已经拉取了所需的jre包)
- https://github.com/QwertyJack/hellofabric 这个示例相对比较好测试通过,但是它所连接的是项目中的fabric网络,且只有查询、执行链码等基本操作,不适合我们进一步学习
- https://github.com/wanghongfei/hyperledger-fabric-java-SDK-demo 本教程主要对该项目进行测试运行,对于代码进行了一些修改,项目文件会放在教程最后的下载链接中
正文
环境:fabric1.1 maven3.5及以上 jdk1.8及以上
实现:sdk java连接服务器fabric1.1的e2e_cli网络,并执行通过链码操作
前提条件:最好测试通过了End2endIT示例,确保maven已经拉取了所需的jre包
一、Fabric1.1 e2e_cli网络集成CA模块
在sdk中集成的CA的模块,即在与fabric网络交互是 都需要先enroll,再setUserContext,获取到执行用户的信息。所以我们在官方给的e2e_cli的示例中集成CA模块。
(1)修改e2e_cli文件夹中的docker-compose-cli.yaml 文件,加入ca
ca0:
image: hyperledger/fabric-ca
environment:
- FABRIC_CA_HOME=/etc/hyperledger/fabric-ca-server
- FABRIC_CA_SERVER_CA_NAME=ca0
- FABRIC_CA_SERVER_TLS_ENABLED=false
ports:
- "7054:7054"
command: sh -c 'fabric-ca-server start --ca.certfile /etc/hyperledger/fabric-ca-server-config/ca.org1.example.com-cert.pem --ca.keyfile /etc/hyperledger/fabric-ca-server-config/${PRIVATE_KEY} -b admin:adminpw -d'
volumes:
- ./crypto-config/peerOrganizations/org1.example.com/ca/:/etc/hyperledger/fabric-ca-server-config
container_name: ca0
(2)修改network_setup.sh启动脚本,启动CA容器
对启动脚本中networkUp方法中增加红色高亮的代码
function networkUp () {
if [ -d "./crypto-config" ]; then
echo "crypto-config directory already exists."
else
#Generate all the artifacts that includes org certs, orderer genesis block,
# channel configuration transaction
source generateArtifacts.sh $CH_NAME
fi
folder="crypto-config/peerOrganizations/org1.example.com/ca"
privName=""
for file_a in ${folder}/*
do
temp_file=`basename $file_a`
if [ ${temp_file##*.} != "pem" ];then
privName=$temp_file
fi
done
echo $privName
if [ "${IF_COUCHDB}" == "couchdb" ]; then
CHANNEL_NAME=$CH_NAME TIMEOUT=$CLI_TIMEOUT docker-compose -f $COMPOSE_FILE -f $COMPOSE_FILE_COUCH up -d 2>&1
else
CHANNEL_NAME=$CH_NAME TIMEOUT=$CLI_TIMEOUT PRIVATE_KEY=$privName docker-compose -f $COMPOSE_FILE up -d 2>&1
fi
if [ $? -ne 0 ]; then
echo "ERROR !!!! Unable to pull the images "
exit 1
fi
docker logs -f cli
}
(3)启动网络
./network_setup.sh up
二、导入项目工程
在idea或eclipse中导入fabric-java-sdk-demo的项目工程
(1)替换相应的证书密钥文件
将~/src/main/resource/fabric目录下的crypto-config文件 替换为 $GOPATH/src/github.com/hyperledger/fabric/examples/e2e_cli目录下的crypto-config文件,即将服务器上的crypto-config放到项目目录中。
(2)修改相应的ip地址
将demo.java中的ip修改为自己服务器或虚拟机ip
(3)因为在启动e2e_cli网络时,已经实例化了相应的链码,所以,不需要再修改invoke和query方法中参数,如果调用其他链码则需要修改。
最后运行成功。
三、注意的几点
- 若在本地编译器调试,网络在服务器上,需要测试本地是否能访问到服务器ip 端口(之前我所在的教育网下访问不到报错,后来将编译器放到服务器上后解决)
- resource需要设置为 Sources Root
- 如果报了一些通信的错误,可以尝试先把tls关闭,步骤如下
将在e2e/base内的两个文件里面分别做出如下修改
docker-compose-base.yaml ---- > ORDERER_GENERAL_TLS_ENABLED=false
peer-base.yaml ---- > CORE_PEER_TLS_ENABLED=false
对e2e/docker-compose-cli.yaml内的文件中同理修改
CORE_PEER_TLS_ENABLED=false
然后重新部署环境。