富查询的使用

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

认识第一个富查询语句

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

copy
{
  "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方法查询结果