想了解相關區塊鏈開發,技術提問,請加QQ群:538327407
1、基礎合約處理
https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/tutorial/sdk_application.html#id2
將官方的Asset.sol 程式碼copy,使用vim Asset.sol 命令建立,copy 到裡面。
上一小節,我們根據業務需求設計了合約Asset.sol的儲存與介面,給出了完整實現,但是Java程式無法直接呼叫Solidity合約,需要先將Solidity合約檔案編譯為Java檔案。
控制檯提供了編譯工具,可以將Asset.sol合約檔案存放在console/contracts/solidity目錄。利用console目錄下提供的sol2java.sh指令碼進行編譯,操作如下:
# 切換到fisco/console/目錄 $ cd ~/fisco/console/ # 編譯合約,後面指定一個Java的包名引數,可以根據實際專案路徑指定包名 $ ./sol2java.sh org.fisco.bcos.asset.contract
2、合約轉化
用官方的asset_app,自己生成的在sdk 那邊用有問題
執行成功之後,將會在console/contracts/sdk目錄生成java、abi和bin目錄,如下所示。
|-- abi # 生成的abi目錄,存放solidity合約編譯生成的abi檔案 | |-- Asset.abi | |-- Table.abi |-- bin # 生成的bin目錄,存放solidity合約編譯生成的bin檔案 | |-- Asset.bin | |-- Table.bin |-- contracts # 存放solidity合約原始碼檔案,將需要編譯的合約拷貝到該目錄下 | |-- Asset.sol # 拷貝進來的Asset.sol合約,依賴Table.sol | |-- Table.sol # 預設提供的系統CRUD合約介面檔案 |-- java # 存放編譯的包路徑及Java合約檔案 | |-- org | |--fisco | |--bcos | |--asset | |--contract | |--Asset.java # Asset.sol合約生成的Java檔案 | |--Table.java # Table.sol合約生成的Java檔案 |-- sol2java.sh
java目錄下生成了org/fisco/bcos/asset/contract/包路徑目錄,該目錄下包含Asset.java和Table.java兩個檔案,其中Asset.java是Java應用呼叫Asset.sol合約需要的檔案。
3、SDK配置
我們提供了一個Java工程專案供開發使用,首先獲取Java工程專案:
# 獲取Java工程專案壓縮包 $ cd ~ $ curl -LO https://github.com/FISCO-BCOS/LargeFiles/raw/master/tools/asset-app.tar.gz # 解壓得到Java工程專案asset-app目錄 $ tar -zxf asset-app.tar.gz
asset-app專案的目錄結構如下:
|-- build.gradle // gradle配置檔案 |-- gradle | |-- wrapper | |-- gradle-wrapper.jar // 用於下載Gradle的相關程式碼實現 | |-- gradle-wrapper.properties // wrapper所使用的配置資訊,比如gradle的版本等資訊 |-- gradlew // Linux或者Unix下用於執行wrapper命令的Shell指令碼 |-- gradlew.bat // Windows下用於執行wrapper命令的批處理指令碼 |-- src | |-- main | | |-- java | | |-- org | | |-- fisco | | |-- bcos | | |-- asset | | |-- client // 放置客戶端呼叫類 | | |-- AssetClient.java | | |-- contract // 放置Java合約類 | | |-- Asset.java | |-- test | |-- resources // 存放程式碼資原始檔 | |-- applicationContext.xml // 專案配置檔案 | |-- ca.crt // 鏈證照 | |-- node.crt // 節點證照 | |-- node.key // 節點私鑰 | |-- contract.properties // 儲存部署合約地址的檔案 | |-- log4j.properties // 日誌配置檔案 | |-- contract //存放solidity約檔案 | |-- Asset.sol | |-- Table.sol | |-- tool |-- asset_run.sh // 專案執行指令碼
3、使用sdk進行開發
將asset_app 的sol、指定的合約的java、abi、bin等檔案copy 到專案中,使用winscp等軟體copy
4、底層部署和測試
· 編譯
# 切換到專案目錄 $ cd ~/asset-app # 編譯專案 $ ./gradlew build
編譯成功之後,將在專案根目錄下生成dist目錄。dist目錄下有一個asset_run.sh指令碼,簡化專案執行。現在開始一一驗證本文開始定下的需求。
· 部署Asset.sol合約
# 進入dist目錄 $ cd dist $ bash asset_run.sh deploy Deploy Asset succesfully, contract address is 0xd09ad04220e40bb8666e885730c8c460091a4775
· 註冊資產
$ bash asset_run.sh register Alice 100000 Register account succesfully=> account: Alice, value: 100000 $ bash asset_run.sh register Bob 100000 Register account succesfully=> account: Bob, value: 100000
· 查詢資產
$ bash asset_run.sh query Alice account Alice, value 100000 $ bash asset_run.sh query Bob account Bob, value 100000
· 資產轉移
$ bash asset_run.sh transfer Alice Bob 50000 Transfer successfully=> from_account: Alice, to_account: Bob, amount: 50000 $ bash asset_run.sh query Alice account Alice, value 50000 $ bash asset_run.sh query Bob account Bob, value 150000
5、本地編寫單元測試
1 package customTest; 2 3 import javafx.concurrent.Service; 4 import org.fisco.bcos.Application; 5 import org.fisco.bcos.solidity.Asset; 6 import org.fisco.bcos.temp.HelloWorld; 7 import org.fisco.bcos.web3j.crypto.Credentials; 8 import org.fisco.bcos.web3j.crypto.gm.GenCredential; 9 import org.fisco.bcos.web3j.protocol.Web3j; 10 import org.fisco.bcos.web3j.protocol.core.methods.response.TransactionReceipt; 11 import org.fisco.bcos.web3j.tuples.generated.Tuple2; 12 import org.fisco.bcos.web3j.tx.gas.StaticGasProvider; 13 import org.junit.After; 14 import org.junit.Before; 15 import org.junit.Test; 16 import org.junit.runner.RunWith; 17 import org.springframework.beans.factory.annotation.Autowired; 18 import org.springframework.boot.test.context.SpringBootTest; 19 import org.springframework.context.ApplicationContext; 20 import org.springframework.context.support.ClassPathXmlApplicationContext; 21 import org.springframework.test.context.junit4.SpringRunner; 22 23 import java.math.BigInteger; 24 25 import static org.junit.Assert.assertTrue; 26 27 @RunWith(SpringRunner.class) 28 @SpringBootTest(classes = Application.class) 29 public class AssetTest { 30 private Credentials credentials; 31 private static BigInteger gasPrice = new BigInteger("300000000"); 32 private static BigInteger gasLimit = new BigInteger("300000000"); 33 @Autowired 34 Web3j web3j; 35 36 //這很重要,沒有這個無法通過 37 @Before 38 public void setUp() throws Exception { 39 /* credentials = 40 GenCredential.create( 41 "b83261efa42895c38c6c2364ca878f43e77f3cddbc922bf57d0d48070f79feb6"); 42 if (credentials == null) { 43 throw new Exception("create Credentials failed"); 44 }*/ 45 46 credentials = GenCredential.create(); 47 } 48 49 @After 50 public void tearDown() { 51 } 52 53 @Test 54 public void DoAsset() throws Exception { 55 AssetRegisterAndQuery(); 56 //DeployAsset(); 57 58 } 59 @Test 60 //部署合約 61 public void DeployAsset() throws Exception { 62 // 部署合約 63 Asset asset = Asset.deploy(web3j, credentials, new StaticGasProvider(gasPrice, gasLimit)).send(); 64 65 if (asset != null) { 66 System.out.println("HelloWorld address is: " + asset.getContractAddress()); 67 } 68 69 } 70 @Test 71 //使用者註冊 資產查詢 72 public void AssetRegisterAndQuery()throws Exception { 73 String contractAddress = "0xf9343346a8d80c3d2f2026bf72fff3aec48a4133"; 74 // 載入合約地址 75 Asset asset = Asset.load(contractAddress, web3j, credentials, new StaticGasProvider(gasPrice, gasLimit)); 76 77 if (asset != null) { 78 System.out.println("Asset address is: " + asset.getContractAddress()); 79 // call set function 80 System.out.println("1、註冊使用者,並註冊資產--------------------------------------"); 81 String assetAccount1="0x608153babb8b00f11523f6b1b2b225ea9e7dfd8b"; 82 String assetAccount2="0x86f17b879ce121e5d00351a120de0bd39867bf4c"; 83 // register介面呼叫 84 TransactionReceipt receipt1 = asset.register(assetAccount1, new BigInteger("121210000") ).send(); 85 TransactionReceipt receipt2 = asset.register(assetAccount2, new BigInteger("121121213") ).send(); 86 87 System.out.println("receipt1="+receipt1.toString()); 88 System.out.println("receipt2="+receipt2.toString()); 89 90 System.out.println("2、查詢使用者資產----------------------------------------------"); 91 // select介面呼叫 92 Tuple2<BigInteger, BigInteger> result1 = asset.select("abc").send(); 93 Tuple2<BigInteger, BigInteger> result2 = asset.select("ddd").send(); 94 System.out.println("Tuple2<BigInteger, BigInteger> result1="+result1.toString()); 95 System.out.println("Tuple2<BigInteger, BigInteger> result2="+result2.toString()); 96 //assertTrue("Hello, World!".equals(result)); 97 } 98 99 100 } 101 102 // 資產交易 103 @Test 104 public void AssetTransfer() throws Exception{ 105 106 String contractAddress = "0xf9343346a8d80c3d2f2026bf72fff3aec48a4133"; 107 // 載入合約地址 108 Asset asset = Asset.load(contractAddress, web3j, credentials, new StaticGasProvider(gasPrice, gasLimit)); 109 110 String fromAssetAccount="0x608153babb8b00f11523f6b1b2b225ea9e7dfd8b"; 111 String toAssetAccount="0x86f17b879ce121e5d00351a120de0bd39867bf4c"; 112 BigInteger amount = new BigInteger("121210000"); 113 if (asset != null) { 114 // transfer介面 115 TransactionReceipt receipt = asset.transfer( fromAssetAccount,toAssetAccount, amount).send(); 116 System.out.println("AssetTest.AssetTransfer receipt="+receipt.toString()); 117 } 118 119 } 120 }