AuthorityIssuerService - 5. getAllAuthorityIssuerList - 《WeIdentity 文档》

5. getAllAuthorityIssuerList

5. getAllAuthorityIssuerList

基本信息

接口名称: com.webank.weid.rpc.AuthorityIssuerService.getAllAuthorityIssuerList
接口定义: ResponseData<List<AuthorityIssuer>> getAllAuthorityIssuerList(Integer index, Integer num)
接口描述: 查询指定范围内的issuer列表。

接口入参:

名称	类型	非空	说明	备注
index	Integer	Y	检索的开始位置
num	Integer	Y	检索的数据条数	单次最多可以检索50条

接口返回: com.webank.weid.protocol.response.ResponseData<List<AuthorityIssuer>>;

名称	类型	说明	备注
errorCode	Integer	返回结果码
errorMessage	String	返回结果描述
result	List<AuthorityIssuer>		授权机构信息，见下
transactionInfo	TransactionInfo	交易信息

com.webank.weid.protocol.response.TransactionInfo

名称	类型	说明
blockNumber	BigInteger	交易块高
transactionHash	String	交易hash
transactionIndex	BigInteger	交易索引

com.webank.weid.protocol.base.AuthorityIssuer

名称	类型	非空	说明
weId	String	Y	授权机构WeIdentity DID
name	String	Y	授权机构名称
created	Long	Y	创建日期
accValue	String	Y	授权方累积判定值

注意：因为Solidity 0.4.4的限制，无法正确的返回accValue，因此这里取得的accValue一定为空字符串。未来会进行修改。

此方法返回code

enum	code	desc
SUCCESS	0	成功
AUTHORITY_ISSUER_ERROR	100200	授权标准异常
ILLEGAL_INPUT	160004	参数为空

调用示例

AuthorityIssuerService authorityIssuerService = new AuthorityIssuerServiceImpl();
ResponseData<List<AuthorityIssuer>> response = authorityIssuerService.getAllAuthorityIssuerList(0, 2);

返回数据如：
result: (java.util.ArrayList)
   [0]: com.webank.weid.protocol.base.AuthorityIssuer
      weId: did:weid:101:0x39e5e6f663ef77409144014ceb063713b65600e7
      name: webank1
      created: 1560412556901
      accValue:
   [1]: com.webank.weid.protocol.base.AuthorityIssuer
      weId: did:weid:101:0x48f56f6b8cd77409447014ceb060243b914cb2a9
      name: webank2
      created: 1560632118000
      accValue:
errorCode: 0
errorMessage: success
transactionInfo:null

时序图

sequenceDiagramparticipant 调用者participant AuthorityIssuerServiceparticipant 区块链节点调用者->>AuthorityIssuerService: getAllAuthorityIssuerList()AuthorityIssuerService->>AuthorityIssuerService: 入参非空、格式及合法性检查opt 入参校验失败AuthorityIssuerService—>>调用者: 报错，提示参数不合法并退出endAuthorityIssuerService->>区块链节点: 调用查询详细信息合约区块链节点->>区块链节点: 执行合约查询指定数目的授权机构，打包返回结果区块链节点—>>AuthorityIssuerService: 返回查询结果AuthorityIssuerService—>>调用者: 返回查询结果