标准规范下载简介
T／ZSA 80-2021 大数据应用平台 公用组件开发技术要求.pdfDataApplicationPl
TechnicalRequirementsforDevelopmentofCommonBuildingBlock
ZJ／ZN 2019-14 公路钢结构桥梁制造指南中关村标准化协会 发布
1范围.. 2规范性引用文件. 3术语和定义 4缩略语.. 5公用组件分类及描述要求. 5.1公用组件分类. 5.2公用组件描述信息， 6公用组件开发要求， 6.1开发环境要求.. 6.2设计要求 .8 6.3编码要求. 12 6.4测试要求 12 6.5发布要求. 13 6.6部署要求. .14 附录A(规范性) 相关代码表 15
本文件规定了大数据应用平台中公用组件定义以及开发技术要求。 本文件适用于大数据应用平台中公用组件的设计与开发。
大数据应用平台公用组件开发技术要求
是一种将一个单一应用程序开发为一组小型服务的方法，每个服务运行在自已的进程中，服务间通 信采用轻量级通信机制（通常用HTTP资源API）。这些服务围绕业务能力构建并且可通过全自动部署机 制独立部署。这些服务共用一个最小型的集中式的管理，服务可用不同的语言开发，使用不同的数据存 储技术。这些服务称之为微服务。微服务架构中将组件定义为可被独立替换和升级的软件单元，在应用 架构设计中通过将整体应用切分成可独立部署及升级的微服务方式进行组件化设计。 3.3 POST请求POSTrequest 人 是HTTP协议中的一个重要组成部分，一般用来向目的服务器发出更新请求，并附有请求实体，
种将一个单一应用程序开发为一组小型服务的方法，每个服务运行在自已的进程中，服务间通 量级通信机制（通常用HTTP资源API）。这些服务围绕业务能力构建并且可通过全自动部署机 署。这些服务共用一个最小型的集中式的管理，服务可用不同的语言开发，使用不同的数据存 这些服务称之为微服务。微服务架构中将组件定义为可被独立替换和升级的软件单元，在应用 中通过将整体应用切分成可独立部署及升级的微服务方式进行组件化设计。
VUE框架VUEframe
VUE框架VUEframework
是一个开源的应用容器引擎，开发者可以打包他们的应用以及依赖包到一个可移植的容器中，然后 发布到任何Linux机器或Windows机器上.也可以实现虚拟化
下列缩略语适用于本文件。 API：应用程序接口（ApplicationProgrammingInterface） X86:intel微处理器执行的计算机语言指令集架构（TheX86architecture） ARM：进阶精简指令集机器（AdvancedRISCMachine） CBB：公用组件（CommonBuildingBlock） CSS：层叠样式表(CascadingStyleSheets) GIS：地理信息系统（GeographicInformationSystem） HTML：超文本标记语言(HyperText MarkupLanguage) HTTP：超文本传输协议(HyperTextTransferProtocol) JS：一种脚本语言(JavaScript) JSON：脚本语言对象简谱(JavaScriptObjectNotation) REST：资源表述状态转移(ResourcepresentationalStateTransfer) URL：统一资源定位器（UniformResourceLocator) VUE：VUE前端框架（VUEframework)
5公用组件分类及描述要求
5.1.1按组件性质分类
按组件性质将公用组件分为技术类组件和应用类组件。 技术类组件是为解决技术性问题而提供，包括但不限于各类工具包、算法组件包、技术框架、适配 器、各类引擎组件（如报表引擎、流程引擎、地图引擎、可视化引擎）、通用页面展示组件（如表格展 示组件、时间轴组件）. 应用类组件是为解决某类应用问题而提供，如：系统通知组件、身份核查组件。
5.1.2按组件形态分类
按组件形态将公用组件分为开发包组件、前端组件、后端组件和前后端组件
5.1.2.2开发包组件
开发包组件是为辅助开发应用软件而提供的开发工具包，如封装访问第三方系统的客户端工具包、 日志处理包等。开发包组件以各类开发依赖包形式提供本地接口调用服务，通常包括jar包、动态库、 脚本、工具包等多种形式。开发包组件不可独立运行，使用者需要将该类组件整体导人到自已的开发工 程中使用。 相对于后端组件，开发包组件具备以下特点： a)不包含复杂的业务逻辑，功能相对简单、清晰； b)功能需求相对固定，代码、方法、接口不会频繁改动； c)不便于使用接口等形式发布成可访问服务
5.1.2.3前端组件
前端组件是针对前端界面的通用业务展示逻辑、数据渲染及丰富的展示效果而提取的通用程序模 ，前端组件可由以下两部分组成（其中前端控制器是可选项）： a)前端页面：负责组件的前端页面渲染和交互。 b)前端控制器：主要负责与后端数据交互、跨系统（组件）数据调度和服务器端渲染，如页面交互 带来的复杂数据呈现处理逻辑（不涉及与数据层交互），页面公用组件之间数据交互带来的业 务处理等。 前端组件可独立运行，以接口调用或者页面嵌入的形式提供服务。 当前端组件只包含前置页面时不可独立运行，使用者应将该组件导人到开发工程中使用，
5.1.2.4后端组件
后端组件是为提供基础技术能力输出、数据服务、通用业务逻辑处理等而提炼的公用服务程月 组件采用微服务架构，提供独立运行的纯后端服务，后端组件以REST接口调用的形式提供服务
5.1.2.5前后端组件
前后端组件是由前端组件和后端组件组合而成的组件。前后端组件的前端和后端业务逻辑联系更为 a)前置页面：负责组件的前端页面渲染和交互， b)前置控制器：主要负责与后端数据交互、跨系统（组件）数据调度和服务器端渲染，如页面交互 带来的复杂数据呈现处理逻辑（不涉及与数据层交互），页面公用组件之间数据交互带来的业 务处理等。 ? c)后置服务：负责与数据处理、业务计算相关的业务逻辑，如对底层资源的处理、与底层数据的交 互等。 1 从业务角度看，组件的前端对后端有强业务依赖关系，从技术角度而言这二者可以视为两个各自独 立的组件分别发布部署，但需要开发者明确描述二者之间的业务关联关系。前后端组件一般是以页面嵌 入的形式提供一组相对完整的功能服务。
5.1.3按组件功能分类
按组件功能可将公用组件分为基础组件、数据服务组件、通用应用组件、行业应用组件， a)基础组件：提供基础技术能力支撑的组件，如算法组件、声音处理、图像处理、GIS信息处理等 此类组件通常没有业务属性。 b)数据服务组件：依托行业数据资源提供的各类与数据存储、获取和处理相关的服务，如数据查询 服务、数据操作服务、数据推送服务等。 c)通用应用组件：在数据服务和基础服务之上，具备一定业务属性，但在多个行业通用。如：语义 检索、人脉分析等。 d)行业应用组件：构建在数据服务组件和通用应用组件之上，具有特定行业的业务属性，如：路况 分析、身份核查、资金流向分析等
5.2公用组件描述信息
公用组件注册时应具备的主要数据项，包括公用组件基本信息、公用组件发布包信息、公用组件环 境依赖信息、公用组件相关文档信息等。
5.2.2公用组件基本信息
公用组件基本信息数据项如表1所示
公用组件基本信息数据项如表1所示
表1.公用组件基本信息
5.2.3公用组件发布包信息
公用组件发布包信息数据项如表2所示，
表2.公用组件发布包信息
5.2.4公用组件运行环境信息
公用组件运行环境信息数据项如表3所示
表3.公用组件运行环境信息
5.2.5公用组件文档信息
生文档信息数据项如表4月
表4.公用组件文档信息
6.2.2架构设计要求
公用组件架构设计应遵循前后端分离架构和微服务架构。 遵循前后端分离架构，公用组件由组件前端和组件后端组成。其中，只有组件前端的组件称为前端 组件，只有组件后端的组件称为后端组件，同时包含了组件前端和组件后端的组件称为前后端组件。组 件前端负责页面的展示与谊染，仅处理与页面展示相关的逻辑以及认证和鉴权，页面功能所需的数据则 通过请求后端的REST接口获取；组件后端负责业务逻辑处理并向组件前端提供处理后的数据，不提供 任何和界面展现有关的内容和处理逻辑。 公用组件运行架构包括前置运行环境和后置运行环境，如图1所示，前置运行环境支撑公用组件前 端组件和前后端组件的前置页面及前置控制器的运行，包含公用组件页面运行环境和公用组件前置控制 器运行环境。后置运行环境支撑公用组件前后端组件的后置服务及后端组件的运行，而开发包组件则直 接以API调用的方式分别集成到前端组件的前置控制器、前后端组件的后置服务及后端组件中
6.2.3接口设计要求
图1公用组件运行架构
表5.请求消息头标准元素
表6.请求消息体分页参数
请求消息体分页示例如下：
表7.响应消息头标准元素
DB37T 4430-2021 退役军人服务中心（站）场所建设和设施配备指南.pdf表8.响应消息体元素
对于分页查询接口，响应消息体中分页参数统一定义如表9所示
表9.响应消息体分页参数
双向四车道高速公路施工组织设计6.2.4数据库设计要求
各组件数据库逻辑上相互独立，虽然可以部署在同一数据库中，但严禁组件之间在数据库层面进行 直接的库表关联查询，组件之间的数据关联应通过调用相关的组件服务接口来实现． 组件开发者负责提供建库、建表、初始化脚本，在组件设计时应考虑不同组件之间的数据同步、数 据π余与数据一致性问题 1 所有对数据（包括结构化、非结构化数据源）的访问必须使用数据服务组件
开发包组件可使用但不限于JAVA语言，当开发包组件为非JAVA语言实现时，应提供JAVA接口， 如果该组件只提供给相同语言的其他组件使用，可不提供JAVA接口，但应予以说明。 公用组件的组件前端页面由HTML、CSS、JS代码组成，可使用成熟的前端框架（如：VUE框架等） 同时应提供用于页面集成的JS接口./■ 公用组件的组件后端应以REST接口对外提供服务，可使用主流的后端开发语言实现，如：JAVA 语言、Python语言等。 1 1