4.5.1 队列事件定义概述
各个业务系统通过http调用中间件服务的接口,中间件服务端处理完业务,并同步区块数据,根据具体的情况选择合适的消息模式将数据传到RocketMQ队列中。业务系统再调用相应约定好的消息模式取得相应的数据。队列事件会将区块链所有业务数据返回回来,用户可通过相应字段过滤和自己有关的数据。返回结果中的状态码code在API服务错误码中解释。注意,在下列队列事件类型中,标题名即是队列事件类型Tag名,具体使用方法请参考开源的RocketMQ说明。
4.5.1.1 EVENT_BLOCKNUMBER
消息类型:String
描述:区块链块基本信息,可通过该事件判断交易是否超时,即块号大于超时块号blockLimit,还没有交易结果,交易超时。
事件返回:
名称 | 类型 | 描述 |
---|---|---|
blockNumber | BigInteger | 块号 |
blockHash | String | 块hash |
preBlockHash | String | 前置块hash |
blockTime | long | 出块时间 |
事件返回:
{
"blockNumber": 461429,
"blockHash": "6baff293e52eb64c8f08af1e979a0232799f7e4099af22b7777afca4f995ec21",
"preBlockHash": "1b20b6fa1eb1882d1b3b78f21219064a42b50c8d3a7b1a6b4edf298c16f6115b",
"blockTime": 1523258534000
}
4.5.1.2 EVENT_TX_RECORDED
消息类型:String
描述:交易上链结果
事件返回:
名称 | 类型 | 描述 |
---|---|---|
success | boolean | 交易是否成功 |
bizId | String | 业务ID |
txHash | String | 交易hash |
code | int | 状态码 |
contractList | List<String> | 交易调用的合约地址列表 |
blockNumber | BigInteger | 交易所属块块号 |
regionId | String | 专区编号(专区链才有) |
regionPageHash | String | 专区页哈希(专区链才有) |
事件示例:
{
"txHash": "bfa38721a1329b62c86d3d89eb29bf50066ab7248051d8e46c2ff6d72f5f61e6",
"success": true,
"bizId": "15232584904663177560751671767456",
"code": 0,
"blockNumber": 461416,
"signer": "aaaffeb54c563c3eee2eec1ada933fdb5c07122b",
"contractList": [
"55086cef9e6bd12bc9d98c80f268b7fb9a6ca00b"
]
}
4.5.1.3 EVENT_CONTRACT_CREATE
消息类型:String
描述:收到合约创建事件,比如创建存证记录
事件返回:
名称 | 类型 | 描述 |
---|---|---|
bizId | String | 业务ID |
contractAddress | String | 合约地址 |
data | Object | 合约内容:tableName(合约名,“Record” :存证记录合约)、create(是否是新建合约)、tableColumn(合约字段) |
timestamp | long | 事件生成时间 |
blockNumber | BigInteger | 块号 |
txHash | String | 交易hash |
regionId | String | 专区编号(专区链才有) |
regionPageHash | String | 专区页哈希(专区链才有) |
事件示例:
{
"contractAddress": "687f8d1c6e87892ad431c58ed23193f2a206d34c",
"bizId": "15232584398987404768042364175660",
"timestamp": 1523258444000,
"blockNumber": 461399,
"txHash": "d69e14de28455821f8b01142c314337d6cdc568d90c16eda240b73299b838dc5",
"data": [
{
"tableName": "Record",
"create": true,
"tableColumn": {
"updatorAddress": "ab4b0a79df5f1d710fe3fd4613312bc60e1fbcf7",
"registryAddress": "55086cef9e6bd12bc9d98c80f268b7fb9a6ca00b",
"preSeqId": null,
"bizId": "15232584398987404768042364175660",
"contractAddress": "687f8d1c6e87892ad431c58ed23193f2a206d34c",
"recordData": "recordData",
"creatorAddress": "ab4b0a79df5f1d710fe3fd4613312bc60e1fbcf7",
"seqId": "record-1523258439898",
"customString": "customString"
}
}
]
}
4.5.1.4 EVENT_CONTRACT_UPDATED
消息类型:String
描述:收到智能合约更新事件,比如更新存证记录
事件返回:
名称 | 类型 | 描述 |
---|---|---|
contractAddress | String | 合约地址 |
bizId | String | 业务ID |
timestamp | long | 事件生成时间 |
data | Object | 合约内容:tableName(合约名,“Record” :存证记录合约)、create(是否是新建合约)、tableColumn(合约字段) |
blockNumber | BigInteger | 块号 |
txHash | String | 交易hash |
regionId | String | 专区编号(专区链才有) |
regionPageHash | String | 专区页哈希(专区链才有) |
事件示例:
{
"contractAddress": "c8375c01b56024276206d342d9c7902ad7e3207d",
"bizId": "15232609064943480557577484125530",
"timestamp": 1523260910000,
"blockNumber": 462221,
"txHash": "13aef81b2ff6d80ddfa326bba1853f908857aca4843d6fef85f1c029cd56877e",
"data": [
{
"tableName": "Record",
"create": false,
"tableColumn": {
"updatorAddress": "ab4b0a79df5f1d710fe3fd4613312bc60e1fbcf7",
"registryAddress": "b6ae9b3d32a5dfc6e5403c7c27f31d3994dc54fc",
"preSeqId": null,
"bizId": "15232609064943480557577484125530",
"contractAddress": "c8375c01b56024276206d342d9c7902ad7e3207d",
"recordData": "recordData",
"creatorAddress": "ab4b0a79df5f1d710fe3fd4613312bc60e1fbcf7",
"seqId": "record-1523260907043",
"customString": "customString"
}
}
]
}
4.5.1.5 EVENT_AUTOTXRETRY_SUCCESS
消息类型:String
描述:收到重试交易成功事件
事件返回:
名称 | 类型 | 描述 |
---|---|---|
flowNumber | String | 交易流水号 |
blockLimit | long | 超时块号 |
bizId | String | 业务ID |
contractAddress | String | 合约地址 |
txHash | String | 交易哈希 |
blockNumber | long | 交易存储的块号 |
retryTimes | int | 重试次数 |
txStatus | String | 交易状态 |
description | String | 错误描述 |
createTime | String | 创建时间 |
updateTime | String | 修改时间 |
regionId | String | 专区编号(专区链才有) |
事件示例:
{
"flowNumber": "15232584904663177560751671767456",
"blockLimit": 10021,
"bizId": "12937492347927937",
"contractAddress": "e3772c2001aca5cf6a098523442d8692b98b2e8f",
"txHash": "fae20e7c0b906f050063b3e9840f62f3b46f80369306e6e24d4e217ab4e0e181",
"blockNumber": 12838,
"retryTimes": 1,
"txStatus": "SUCCESS",
"description": "",
"createTime": "2018-09-19 14:20:00",
"updateTime": "2018-09-19 19:20:00"
}
4.5.1.6 EVENT_AUTOTXRETRY_INVALID
消息类型:String
描述:收到重试交易失效事件
事件返回:
名称 | 类型 | 描述 |
---|---|---|
flowNumber | String | 交易流水号 |
blockLimit | long | 超时块号 |
bizId | String | 业务ID |
retryTimes | int | 重试次数 |
txStatus | String | 交易状态 |
txHash | String | 交易哈希 |
description | String | 错误描述 |
createTime | String | 创建时间 |
updateTime | String | 修改时间 |
regionId | String | 专区编号(专区链才有) |
事件示例:
{
"flowNumber": "15232584904663177560751671767456",
"blockLimit": 10021,
"bizId": "12937492347927937",
"retryTimes": 1,
"txStatus": "INVALID",
"txHash": "fae20e7c0b906f050063b3e9840f62f3b46f80369306e6e24d4e217ab4e0e181",
"description": "",
"createTime": "2018-09-19 14:20:00",
"updateTime": "2018-09-19 19:20:00"
}