分析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,或者在账本上写入更复杂的数据，从而开发出适合自己项目的智能合约
