AuthorityIssuerService - 4. queryAuthorityIssuerInfo - 《WeIdentity 文档》

4. queryAuthorityIssuerInfo

4. queryAuthorityIssuerInfo

基本信息

接口名称:com.webank.weid.rpc.AuthorityIssuerService.queryAuthorityIssuerInfo
接口定义:ResponseData<AuthorityIssuer> queryAuthorityIssuerInfo(String weId)
接口描述: 根据WeIdentity DID查询权威机构信息。

接口入参: String

名称	类型	非空	说明	备注
weId	String	Y	WeIdentity DID	用于搜索权限发布者

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

名称	类型	说明	备注
errorCode	Integer	返回结果码
errorMessage	String	返回结果描述
result	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	成功
WEID_INVALID	100101	无效的WeIdentity DID
AUTHORITY_ISSUER_ERROR	100200	授权标准异常
TRANSACTION_TIMEOUT	160001	超时
TRANSACTION_EXECUTE_ERROR	160002	交易错误
AUTHORITY_ISSUER_CONTRACT_ERROR_NOT_EXISTS	500202	实体不存在

调用示例

AuthorityIssuerService authorityIssuerService = new AuthorityIssuerServiceImpl();
String weId = "did:weid:101:0x39e5e6f663ef77409144014ceb063713b65600e7";
ResponseData<AuthorityIssuer> response = authorityIssuerService.queryAuthorityIssuerInfo(weId);

返回数据如：
result:(com.webank.weid.protocol.base.AuthorityIssuer)
   weId: did:weid:101:0x39e5e6f663ef77409144014ceb063713b65600e7
   name: webank1
   created: 1560412556901
   accValue:
errorCode: 0
errorMessage: success
transactionInfo:null

时序图

sequenceDiagramparticipant 调用者participant AuthorityIssuerServiceparticipant 区块链节点调用者->>AuthorityIssuerService: 调用queryAuthorityIssuerInfo()AuthorityIssuerService->>AuthorityIssuerService: 入参非空、格式及合法性检查opt 入参校验失败AuthorityIssuerService—>>调用者: 报错，提示参数不合法并退出endAuthorityIssuerService->>区块链节点: 调用查询详细信息合约区块链节点->>区块链节点: 执行合约通过WeIdentity DID查询区块链节点—>>AuthorityIssuerService: 返回查询结果AuthorityIssuerService—>>调用者: 返回查询结果（非授权机构则无）