Fabric2.2 java类型chaincode的编译和启动

1 .java chaincode支持gradle和mave了两种构建方式

其判断的依据是chaincode package目录下面是包含build.gradle还是pom.xml

fabric会在两个目录下面检查build.gradle和pom.xml，即chancode package的根目录，或者根目录下面的src子目录。大致流程如下：

if [ -f {CCPACKAGE}/build.gradle ]; then
    build gradle
elif [ -f {CCPACKAGE}/pom.xml ]; then
    build maven
elif [ -f {CCPACKAGE}/src/build.gradle ]; then
    build gradle
elif [ -f {CCPACKAGE}/src/pom.xml ]; then
    build maven
fi

上述代码还应该有一个else分支，即如果build.gradle和pom.xml均不存在怎么办？答案是fabric就不进行build过程，会直接返回编译成功的结果，也就是会认为用户安装的是已经编译好的二进制jar包。当然fabric会检查用户是否提供了jar包(可能包含多个)，如果一个jar文件也没有找到，那么fabric会报错，如果找到jar文件，则会把所有的jar文件找出来，假装是编译的结果，并把所有其他非jar类型文件全部丢弃。

这里可以看出java类型的chaincode，fabric是支持源代码安装和二进制安装两者方式的；我一直认为源代码安装是不科学的，不能让用户提交源代码啊，这是用户的业务逻辑，是用户的私密信息。

编译的输出

对应gradle build，fabric采用的命令是：
$ gradlew build shadowJar -x test
构建结果是生成一个大的jar文件：
build/libs/chaincode.jar
这个文件包含所有的项目文件和依赖包。

如果是maven build，fabric采用的命令是：
$ mvn compile package -DskipTests -Dmaven.test.skip=true
构建结果是生成一个大的jar文件：
target/chaincode.jar

因为fabric编译的结果是要生成一个uber JAR类型的chaincode.jar文件；关于uber JAR的定义是这样的：

An uber-JAR—also known as a fat JAR or JAR with dependencies—is
a JAR file that contains not only a Java program,
but embeds its dependencies as well.
This means that the JAR functions as an "all-in-one" distribution of the software,
without needing any other Java code.
(You still need a Java runtime, and an underlying operating system, of course.)

运行

区分chaincode编译出来的是不是uber JAR

if [ <is-uber-jar> ]; then
    exec java -jar ${CHAINCODE_JARS} "$@"
else
    exec java -cp ${CHAINCODE_JARS}:${LIB_JARS} org.hyperledger.fabric.contract.ContractRouter "$@"
fi

对于uber JAR来说，CHAINCODE_JARS只能有一个jar文件，即编译出来的chaincode.jar文件，而对于非uber JAR来说，CHAINCODE_JARS可以包含多个chaincode的jar文件，这完全依赖于用户如何编译chaincode，LIB_JARS是fabric-javaenv image里面自带的系统依赖库，已经被打倒fabric-javaenv image里面了，不需要再用户chaincode里面安装；包含例如：

animal-sniffer-annotations-1.18.jar
annotations-4.1.1.4.jar
bcpkix-jdk15on-1.62.jar
bcprov-jdk15on-1.62.jar
checker-compat-qual-2.5.5.jar
classgraph-4.8.47.jar
commons-cli-1.4.jar
commons-collections-3.2.2.jar
commons-digester-1.8.1.jar
commons-logging-1.2.jar
commons-validator-1.6.jar
error_prone_annotations-2.3.4.jar
fabric-chaincode-protos-2.2.1.jar
fabric-chaincode-shim-2.2.1.jar
failureaccess-1.0.1.jar
grpc-api-1.31.1.jar
grpc-context-1.31.1.jar
grpc-core-1.31.1.jar
grpc-netty-shaded-1.31.1.jar
grpc-protobuf-1.31.1.jar
grpc-protobuf-lite-1.31.1.jar
grpc-stub-1.31.1.jar
gson-2.8.6.jar
guava-29.0-android.jar
handy-uri-templates-2.1.8.jar
j2objc-annotations-1.3.jar
javax.annotation-api-1.3.2.jar
joda-time-2.10.2.jar
json-20190722.jar
jsr305-3.0.2.jar
listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar
org.everit.json.schema-1.12.1.jar
perfmark-api-0.19.0.jar
proto-google-common-protos-1.17.0.jar
protobuf-java-3.12.0.jar
protobuf-java-util-3.11.1.jar
re2j-1.3.jar

参考资料：
image: hyperledger/fabric-javaenv:2.2
file: /root/chaincode-java/build.sh
file: /root/chaincode-java/start

最后编辑于：2021.05.23 02:20:31