标准规范下载简介：

内容预览由机器从pdf转换为word，准确率92%以上，供参考

T／ZSA 80-2021 大数据应用平台 公用组件开发技术要求.pdf

表5.请求消息头标准元素

表6.请求消息体分页参数

请求消息体分页示例如下：

隧道施工方案2表7.响应消息头标准元素

表8.响应消息体元素

对于分页查询接口，响应消息体中分页参数统一定义如表9所示

表9.响应消息体分页参数

6.2.4数据库设计要求

各组件数据库逻辑上相互独立，虽然可以部署在同一数据库中，但严禁组件之间在数据库层面进行 直接的库表关联查询，组件之间的数据关联应通过调用相关的组件服务接口来实现． 组件开发者负责提供建库、建表、初始化脚本，在组件设计时应考虑不同组件之间的数据同步、数 据π余与数据一致性问题 1 所有对数据（包括结构化、非结构化数据源）的访问必须使用数据服务组件

开发包组件可使用但不限于JAVA语言，当开发包组件为非JAVA语言实现时，应提供JAVA接口， 如果该组件只提供给相同语言的其他组件使用，可不提供JAVA接口，但应予以说明。 公用组件的组件前端页面由HTML、CSS、JS代码组成，可使用成熟的前端框架（如：VUE框架等） 同时应提供用于页面集成的JS接口./■ 公用组件的组件后端应以REST接口对外提供服务，可使用主流的后端开发语言实现，如：JAVA 语言、Python语言等。 1 1

应充分考虑组件的可测试性，为组件测试提供便利条件，如：提供必要的测试界面、测试模拟数据 系统日志、接口测试程序、性能测试程序、压力测试程序等。在开发过程中应完成组件的单元测试、接 口测试，在组件发布前应完成功能测试、性能测试。为更好的保证组件质量，应扩展进行其它类型的测 试。

应提供基于Junit框架或类似框架的单元测试代码，以利于进行自动测试以及后续的回归测试 盖被测试单元的正常流和异常流，还应考虑组件的鲁棒性、自检能力、运维可行性。

对于公用组件提供的REST接口，应提供在线API调用界面用于对接口进行手动测试，并提供相应 的模拟接口返回数据。同时，应提供组件接口自动化测试代码，以便于进行自动测试以及后续的回归测 试。

同时提供必婴的系统目志输出，

试人员检查系统运行状况及评估测试结果，

公用组件应提供性能测试程序，方便测试人员执行性能测试、采集性能测试指标。性能指标包括但 不限于以下内容：响应时间、并发数、每秒处理事务数、吞吐量及资源利用率，可支持通用的第三方压 力测试工具，如loadrunner。

6.4.6其它类型测试

为确保组件上线后的长期稳定的提供服务，除上述测试外，组件可选择性的完成如下类型的测试： 可靠性测试、稳定性测试、过程测试、兼容性测试等。

6.5.1版本发布包要求

公用组件版本发布包需满足以下要求： a)开发者应提交详细的组件使用说明、接口描述说明等信息 ? b)发布前应对部署所需修改的配置信息进行清理，删除无用信息，做到简洁清晰 c)需要独立部署的组件，在开发完成后应提供自动部署程序所必需的相关配置。 d)如系统需要初始化数据，则应提供数据导入脚本。 e)使用手册中应包含对外部系统操作依赖的详细说明。 f）应确保部署包、配置信息、代码、文档版本的一致性

6.5.2版本号发布规则

版本发布采用如下版本发布规则： 主版本号.子版本号.（修正版本号） 其中： 一 a）主版本号代表了组件的一个主要版本，当主版本号不变时，说明组件的主要功能和接口没有变 化；主版本号不同的组件在使用中一般不可以相互替换，但可以尽可能考虑接口向下兼容，即主版本号 高的组件兼容主版本号低的组件的接口， b）子版本号代表了组件的一个次要版本，主版本号相同时，子版本号不同，代表组件增加了部分 功能，但这些增加的功能还不足以形成一个新的主要版本，主版本号相同、子版本号不同的组件在使用 中应该可以直接升级替换，当组件升级为更高的子版本号时，组件使用方可以不做任务修改，但如果需 要使用新增加的部分功能，则可能需要增加相应的调用代码。 c）修正版本号代表了组件的一个BUG修复版本，主版本号和子版本号相同、修正版本号不同组件 可以直接相互替换，通常使用方不需要做任何修改。 版本号示例如下： 1.0：组件初始版本，代表了该组件是发布的第一个主版本，还没有产生子版本， 1.1：组件第一个主版本的第一个子版本。 1.2.1：组件第一个主版本的第二个子版本的第一个修正版本

版本号设置规则如下： a)组件初版时，版本号为1.0.0； b)当组件进行了局部修改或漏洞修复时，主版本号和子版本号都不变，修正版本号加1； c)当组件在原有的基础上增加了部分功能时，主版本号不变，子版本号加1，修正版本号复位

为0； d)当组件进行了重大修改或局部修正累积较多，而导致组件发生全局变化时，主版本号加1； e)根据情况可以在版本号后面加人英文后缀，在这些后缀后面还可以加入1位数字的版本号 常用的后缀及说明如表10所示。

表10.版本号常用后缀及说明

公用组件应能够同时支持基于X86和ARM架构的服务器环境，并支持部署运行于物理机环境、虚 拟机环境以及云平台环境 为最大限度的简化部署，提高软件可移植性并提升可运维性，公用组件的标准部署方式为Docke 部署，使用公用组件的相关应用也推荐优先考虑Docker部署。

A.1组件功能类型代码

表A.1.组件功能类型代码

DB63T 1985-2021标准下载表A.2.组件形态代码

A.3组件接口类型代码

表A.3组件接口类型代码

A.4组件来源类型代码

表A.4组件来源类型代码

表A.5组件状态代码

T／CECS689-2020 固废基胶凝材料应用技术规程及条文说明.pdf表A.6文档类型代码