JR/T 0314—2024

7

附录A

（资料性）

应用环境参考示例

图A.1 是区域性股权市场跨链技术规范应用环境的参考示例。在该参考示例中，区域性股权市场跨

链技术规范用于地方业务链与监管链之间数据对象的跨链处理。

图Ａ.1应用环境参考

JR/T 0314—2024

8

附录B

（资料性）

数据对象数据头参考示例

图B.1 是区域性股权市场跨链技术规范业务数据对象数据头的参考示例。在该参考示例中，数据对

象数据头主要字段含义如下：

——header.content.object_id

解释：地方业务链业务数据对象唯一标识。

——header.content.operation

解释：标识当前对业务数据对象所做的操作行为。

——header.content.timestamp

解释：标识当前业务数据对象操作发生时刻的Unix 时间戳。

——header.content.type

解释：标识当前业务数据对象类型。

——header.content.version

解释：标识业务数据对象版本号。

——header.model.protocol

解释：标识数据模型协议名称，固定为“区域性股权市场跨链业务数据模型”。

——header.model.version

解释：标识当前所使用的数据模型版本号。

——header.source

解释：标识当前业务数据对象来源。

——header.body

解释：标识当前业务数据对象内容。

图B.1数据对象数据头参考

JR/T 0314—2024

9

附录C

（资料性）

数据对象生命周期管理参考示例

图C.1 是区域性股权市场跨链技术规范数据对象生命周期管理的示例参考。

在该参考示例中，对数据对象操作的说明如下：

——创建：业务数据第一次生成，则需要创建数据对象；

——更新：业务执行过程导致数据对象内容变更，则需要更新业务数据对象；

——重写：因业务操作原因导致业务数据对象内容错误，则需要重写业务数据对象；

——删除：因业务变化导致业务数据过期或无用，则需要删除业务数据对象。

图C.1数据对象生命周期管理参考

JR/T 0314—2024

10

附录D

（资料性）

数据对象JSON 模式参考示例

D.1数据对象JSON模式基本使用流程

区域性股权市场跨链技术规范对数据对象JSON模式的参考示例仅用于演示JSON模式的基本使用流

程，不对JSON 模式工具的选择构成建议和要求，可根据技术特点和需求进行评估。更多工具请参考：

https://json-schema.org/tools。

在区域性股权市场区块链试点场景中，数据对象JSON 模式的基本使用流程为：

a)使用JSON 模式生成代码；

b)基于JSON 模式生成的代码构造业务数据对象；

c)将业务数据对象序列化为JSON 结构体（快照）；

d)使用JSON 模式校验序列化后的JSON 结构体。

D.2代码生成工具

使用工具生成业务数据对象代码的示例如下：

工具网址：https://app.quicktype.io/#l=schema。

通过以上网址在浏览器中打开在线代码生成工具，在网页左侧“Name”输入根对象名称

“InterChainObject”，“Source type”选择“JSON Schema”，然后在文本域中输入完整的数据对象

Schema 内容；

在网页右侧悬浮框中，选择对应的开发语言等属性，即能够自动生成对应语言的代码。注意生成

Java 代码时：

——可能出现非必填日期/时间格式字段没有正确添加JsonFormat 注解的情况，此系工具本身对

Java 语言代码生成支持存在缺陷导致，日期/时间格式字段需要手动在代码中添加；

——右侧选项框“Date time provider type”选择“Legacy”，则生成的代码中，日期会使用

“java.utils.Date”类。

D.3代码检验工具

D.3.1在线格式校验

使用工具校验JSON结构及各属性值合法性的示例如下：

工具网址：https://www.jsonschemavalidator.net。

使用示例如图D.1：

JR/T 0314—2024

11

图D.1在线格式校验参考

D.3.2本地代码验证

使用代码校验JSON 结构及各属性值合法性的示例如下：

GitHub: https://github.com/everit-org/json-schema。

使用方法：

Maven 依赖可见上述GitHub 链接。

代码示例如图D.2：

图D.2本地格式校验参考

JR/T 0314—2024

12

图D.2本地格式校验参考（续）

当JSON 格式或其属性值不符合JSON 模式中定义的规范时，会得到如图D.3 的报错信息，通过报错

信息可以轻松定位到错误原因并进行修复：

图D.3校验报错信息参考

JR/T 0314—2024

13

附录E

（资料性）

数据对象快照存证参考示例

以下是区域性股权市场跨链技术规范对数据对象快照存证的参考示例。在该参考示例中，地方业务

链暂时无法将所有业务数据实时记录在链上，按以下步骤采用链上存证的临时过渡方案：

a)在关键业务流程执行完毕时，按照业务逻辑触达的先后顺序生成所有被影响的快照，并将它们

存储于链外（如：OSS）；

b)每个链外存储成功的快照都要在链上存证；

c)存证记录应该至少包含图Ｅ.1 所示的属性（以JSON 格式为例）。

图E.1存证记录包含属性参考

每个存证记录可包含多个数据项，每个数据项对应一个快照的链上存证。