Hyperledger Fabric学习(十二)智能合约(链码)使用富查询

08/21 11:28
阅读数 404

富查询的使用

      链码中的数据存储都是基于K-V键值对的形式,一般来说,是保存在LevelDB中。但是目前Fabric支持链码使用couchDB进行存储数据、通过编写富查询的方式查询数据

认识第一个富查询语句

​ 富查询语句是一种特定的json格式,如下所示:

{
  "selector": {
    "coin": 100 
  }
}

selector对应一个列表,列表包含多个单元,每个单元匹配一个字段,譬如上述中匹配的是满足余额为100的User数据

在链码中实现富查询
  • 在first_cc目录下,创建couchDB索引目录和索引文件
# 创建索引目录
mkdir -p META-INF/statedb/couchdb/indexes
# 创建基于coin字段的索引文件
touch META-INF/statedb/couchdb/indexes/indexCoin.json
  • 给索引文件indexCoin.json添加如下内容
{
  "index": {
    "fields": [
      "coin"
    ]
  },
  "ddoc": "indexCoinDoc",
  "name": "indexCoin",
  "type": "json"
}
  • 在first_cc.go文件中实现基于coin值进行富查询的UserQueryByCoin函数
// 基于coin值进行用户查询
func UserQueryByCoin(stub shim.ChaincodeStubInterface, args []string) pb.Response {
  // 判断参数个数
  if len(args) != 1 {
		return shim.Error("args must be one")
	}

  // 编写富查询语句,根据coin值进行匹配查询
  var queryString = fmt.Sprintf(`{"selector":{"coin": %v}}`, args[0])
  // 查询结果的变量定义
  var users = make([]User, 0)
  // 富查询操作,返回一个迭代器
  iterator, err := stub.GetQueryResult(queryString)
  if err != nil {
	fmt.Println(err.Error())
	return shim.Error("data get failed: " + err.Error())
  }
  // defer后面的操作是函数执行退出之前的会进行的操作,这里是关闭迭代器
  defer iterator.Close()
  
  // 循环获取迭代器中的值
  for ; iterator.HasNext(); {
	resp, err := iterator.Next()
	if err != nil {
		fmt.Println(err.Error())
		return shim.Error("data get failed: " + err.Error())
	}
   
    // 将迭代器的值取出反序列化,存入查询结果中
    var user User
    if err := json.Unmarshal(resp.Value, &user); err != nil {
	  fmt.Println(err.Error())
	  return shim.Error("data unmarshal failed: " + err.Error())
    }
    users = append(users, user)
  }

  // 将查询结果序列化
  data, err := json.Marshal(users)
  if err != nil {
	fmt.Println(err.Error())
	return shim.Error("data marshal failed: " + err.Error())
  }
  fmt.Println(string(data))

  return shim.Success(data)
}
  • 在Invoke中添加函数调用
// 修改之前实现的Invoke()方法
func (t *FirstChainCode) Invoke(stub shim.ChaincodeStubInterface) pb.Response {
  /*
  		获取参数,分解为调用方法名,以及传入的参数列表
  		然后根据具体的function,调用对应的之前写过的函数
  */
  function, args := stub.GetFunctionAndParameters()
	switch function {
	case "UserRegister":
		return UserRegister(stub, args)
	case "UserQuery":
		return UserQuery(stub, args)
  case "UserQueryByCoin":
    return UserQueryByCoin(stub, args)
	default:
		return shim.Error("no this function name.")
	}
}
测试使用了couchDB的链码

​ MockStub测试不能支持使用了couchDB的链码,因此如果需要测试富查询的相关函数是否正确,需要模拟搭建一套fabric网络,peer使用dev调试模式,对链码进行实时调式并测试。相关说明请见
Hyperledger Fabric学习(十)智能合约(链码)devplat工具测试

  • 使用devplat搭建fabric平台,并安装实例化部署好first_cc链码
  • 调用UserQueryByCoin方法查询结果
展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部