分析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());
    }

query方法提供对账户余额的查询

最后有一个main方法，作为程序入口，将我们的链码跑起来

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

了解了这个例子，我们可以在这个结构的基础上，增加更多方法，例如增加一个查询所有账户的方法getAllAccounts,或者在账本上写入更复杂的数据，从而开发出适合自己项目的智能合约