螞蟻區塊鏈合約平台 Java SDK 是通過服務(Service)的形式對外提供功能,具體包括賬戶服務(Account Service)、合約服務(Contract Service)、事件服務(Event Service)、查詢服務(Query Service)和本地服務(Local Service)。SDK 提供以同步或非同步方式發送交易、查詢交易、訂閱事件等的介面。無論以同步或非同步方式發送交易,SDK 封裝了發送交易後查詢收據的邏輯,以便您查看交易的執行結果。
Java SDK 的 Jar 包依賴 Netty,不同的運行系統需要選擇不同的 Netty 依賴包配置到 Maven 檔案中。
Java SDK 版本說明
版本號碼 | 更新功能 | 對應鏈版本 | 下載連結 |
|---|---|---|---|
0.10.2.6 | 支援合約平台所有用戶端功能。 | V0.10.2.4.4 |
Netty 依賴包說明
下表所列的 Netty 依賴包均包含在 Java SDK 壓縮包中。JAVA SDK 需通過 BaaS 控制台鏈管理頁面下載。
檔案 | 說明 | 下載連結 |
|---|---|---|
netty-tcnative-openssl-static-2.0.17-Final-mychain-linux-x86_64.jar | Linux 作業系統下 SDK 所依賴的運行庫 | |
netty-tcnative-openssl-static-2.0.17-Final-mychain-windows-x86_64.jar | Windows 作業系統下 SDK 所依賴的運行庫 | |
netty-tcnative-openssl-static-2.0.17-Final-mychain-osx-x86_64.jar | macOS 作業系統下 SDK 所依賴的運行庫 |
運行環境說明
JDK 7 及以上版本在終端運行
java -version查看當前 Java 版本。Maven 3.5.4 及以上版本在終端運行
mvn -v查看當前 Maven 版本。
在 Maven 檔案中引入 SDK 包
安裝下載的 Jar 包到本地倉庫。
從命令終端進入到下載的檔案根目錄,執行以下命令:
//安裝 SDK 到本地倉庫
mvn install:install-file -Dfile=mychainx-sdk-0.10.2.6.jar -DgroupId=com.alipay.mychainx -DartifactId=mychainx-sdk -Dversion=0.10.2.6 -Dpackaging=jar
//安裝 Netty 依賴到本地倉庫,注意選擇對應平台 netty-tcnative-openssl-static 版本,注意修改 classifier,macOS :osx-x86_64、linux:linux-x86_64、windows:windows-x86_64
mvn install:install-file -Dfile=netty-tcnative-openssl-static-2.0.17-Final-mychain-osx-x86_64.jar -DgroupId=io.netty -DartifactId=netty-tcnative-openssl-static -Dversion=2.0.17-Final-mychain -Dpackaging=jar -Dclassifier=osx-x86_64<dependencies>
<dependency>
<groupId>com.alipay.mychainx</groupId>
<artifactId>mychainx-sdk</artifactId>
<!--請使用最新 SDK 版本 -->
<version>0.10.2.6</version>
</dependency>
</dependencies>
<build>
<extensions>
<extension>
<groupId>kr.motd.maven</groupId>
<artifactId>os-maven-plugin</artifactId>
<version>1.6.1</version>
</extension>
</extensions>
</build>