天天看點

分析fabric的官方示例鍊碼

fabric鍊碼要實作兩個方法:init 和 invoke

init用來執行個體化鍊碼,invoke用來調用方法

示例代碼可以在github上搜尋fabric-samples,找到你想要的版本下載下傳,這裡用1.4版本的做示例

進入chaincode目錄

我們就來看最基礎的實作了賬戶兩兩轉賬的鍊碼chaincode_example02

裡面有node版本go版本和java版本

我們分析java版本

點開目錄,發現這個鍊碼是一個grandle項目

我們分析一下它的配置

我們也可以用Maven來建構這個項目,這裡不加贅述

//項目需要的依賴
dependencies {
    compile group: 'org.hyperledger.fabric-chaincode-java', name: 'fabric-chaincode-shim', version: '1.+'
    testCompile group: 'junit', name: 'junit', version: '4.12'
}

shadowJar {
    baseName = 'chaincode'
    version = null
    classifier = null
	打包時将org.hyperledger.fabric.example.SimpleChaincode設定為Main-Class
    manifest {
        attributes 'Main-Class': 'org.hyperledger.fabric.example.SimpleChaincode'
    }
}
           

我們來看init方法

//執行個體化Log對象
private static Log _logger = LogFactory.getLog(SimpleChaincode.class);

@Override
	//傳入一個ChaincodeStub對象,對象中有方法名,和方法參數
    public Response init(ChaincodeStub stub) {
        try {
            _logger.info("Init java simple chaincode");
            //擷取使用的方法名
            String func = stub.getFunction();
            //如果不是init方法
            if (!func.equals("init")) {
                return newErrorResponse("function other than init is not supported");
            }
            //擷取方法參數
            List<String> args = stub.getParameters();
            if (args.size() != 4) {
                newErrorResponse("Incorrect number of arguments. Expecting 4");
            }
            // Initialize the chaincode
            //取出4個參數中的兩個賬戶,2個初始金額
            String account1Key = args.get(0);
            int account1Value = Integer.parseInt(args.get(1));
            String account2Key = args.get(2);
            int account2Value = Integer.parseInt(args.get(3));

            _logger.info(String.format("account %s, value = %s; account %s, value %s", account1Key, account1Value, account2Key, account2Value));
            //将賬戶狀态到鍊上
            stub.putStringState(account1Key, args.get(1));
            stub.putStringState(account2Key, args.get(3));
			
            return newSuccessResponse();
        } catch (Throwable e) {
            return newErrorResponse(e);
        }
    }
           

這個init方法接收4個參數,賬戶1和他賬戶上的錢,賬戶2和他賬戶上的錢,存傳入連結上,我們可以修改這個方法,用來初始化我們的賬本

invoke方法

//invoke方法負責調用其他查詢或操作賬本上資料的方法:invoke,delete,query	
@Override
    public Response invoke(ChaincodeStub stub) {
        try {
            _logger.info("Invoke java simple chaincode");
            String func = stub.getFunction();
            List<String> params = stub.getParameters();
            if (func.equals("invoke")) {
                return invoke(stub, params);
            }
            if (func.equals("delete")) {
                return delete(stub, params);
            }
            if (func.equals("query")) {
                return query(stub, params);
            }
            return newErrorResponse("Invalid invoke function name. Expecting one of: [\"invoke\", \"delete\", \"query\"]");
        } catch (Throwable e) {
            return newErrorResponse(e);
        }
    }
           

第二個invoke方法,這個invoke方法執行賬戶之間的轉賬操作,由上一級invoke把stub和參數傳進來,分析參數是否符合條件,然後完成轉帳更新資料

//接收一個stub對象和若幹參數
private Response invoke(ChaincodeStub stub, List<String> args) {
        if (args.size() != 3) {
            return newErrorResponse("Incorrect number of arguments. Expecting 3");
        }
    	//取得轉賬人和收款人的賬戶名
        String accountFromKey = args.get(0);
        String accountToKey = args.get(1);
		//擷取轉賬人賬戶餘額,字元串形式
        String accountFromValueStr = stub.getStringState(accountFromKey);
        if (accountFromValueStr == null) {
            return newErrorResponse(String.format("Entity %s not found", accountFromKey));
        }
    	//擷取轉賬人餘額,整數形式
        int accountFromValue = Integer.parseInt(accountFromValueStr);
		//擷取收款人餘額,字元串形式
        String accountToValueStr = stub.getStringState(accountToKey);
        if (accountToValueStr == null) {
            return newErrorResponse(String.format("Entity %s not found", accountToKey));
        }
    	//擷取收款人餘額,
        int accountToValue = Integer.parseInt(accountToValueStr);
		//擷取轉賬金額
        int amount = Integer.parseInt(args.get(2));

        if (amount > accountFromValue) {
            return newErrorResponse(String.format("not enough money in account %s", accountFromKey));
        }
    
        accountFromValue -= amount;
        accountToValue += amount;

        _logger.info(String.format("new value of A: %s", accountFromValue));
        _logger.info(String.format("new value of B: %s", accountToValue));
		//把雙方轉帳後剩多少,更新上去
        stub.putStringState(accountFromKey, Integer.toString(accountFromValue));
        stub.putStringState(accountToKey, Integer.toString(accountToValue));

        _logger.info("Transfer complete");

        return newSuccessResponse("invoke finished successfully", ByteString.copyFrom(accountFromKey + ": " + accountFromValue + " " + accountToKey + ": " + accountToValue, UTF_8).toByteArray());
    }
           

delete

// Deletes an entity from state
//從賬本中删除實體
    private Response delete(ChaincodeStub stub, List<String> args) {
        if (args.size() != 1) {
            return newErrorResponse("Incorrect number of arguments. Expecting 1");
        }
        String key = args.get(0);
        // Delete the key from the state in ledger
        stub.delState(key);
        return newSuccessResponse();
    }
           

query。query方法提供對賬戶餘額的查詢

// query callback representing the query of a chaincode
    private Response query(ChaincodeStub stub, List<String> args) {
        if (args.size() != 1) {
            return newErrorResponse("Incorrect number of arguments. Expecting name of the person to query");
        }
        String key = args.get(0);
        //byte[] stateBytes
        String val	= stub.getStringState(key);
        if (val == null) {
            return newErrorResponse(String.format("Error: state for %s is null", key));
        }
        _logger.info(String.format("Query Response:\nName: %s, Amount: %s\n", key, val));
        return newSuccessResponse(val, ByteString.copyFrom(val, UTF_8).toByteArray());
    }

           
public static void main(String[] args) {
        System.out.println("OpenSSL avaliable: " + OpenSsl.isAvailable());
        new SimpleChaincode().start(args);
}