一体化指挥调度业务资源数据交换技术要求(T-CICC16002—2018).pdf

《一体化指挥调度业务资源数据交换技术要求(T-CICC16002—2018).pdf》由会员分享，可在线阅读，更多相关《一体化指挥调度业务资源数据交换技术要求(T-CICC16002—2018).pdf（7页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、 ICS 35.020 L60/69 中国指挥与控制学会团体标准中国指挥与控制学会团体标准 T/CICC 160022018 一体化指挥调度 业务资源 数据交换 技术要求 Integrated command and dispatch-Business resources-Technical requirements for data exchange 2018-07-02 发布 2018-08-02 实施 中国指挥与控制学会中国指挥与控制学会 发布发布 T/CICC 160022018 I 目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语、定义和缩略语.1 3.1 术语和定

2、义.1 3.2 缩略语.1 4 数据项属性.2 5 数据交换格式.2 6 数据服务接口访问路径格式.2 7 数据操作要求.3 7.1 数据操作动作.3 7.2 数据操作返回状态.3 T/CICC 160022018 II 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。本标准由中国指挥与控制学会提出并归口。本标准起草单位：一体化指挥调度技术国家工程实验室、博康智能信息技术有限公司、中国电子科技集团公司第二十八研究所、中国电子技术标准化研究院、中国航天科工集团第四研究院指挥自动化技术研发与应用中心、中国航空综合技术研究所、北京大学。本标准主要起草人：金贵霞、刘胜杰、马文学、王亮、

3、张阳、李寒、高展、温晓萍，赵文涛、呼延龙、代红、施媛、王嘉宇、刘宝辉、季光、李伟平、莫同、张荣、卢思远。T/CICC 160022018 1 一体化指挥调度 业务资源 数据交换技术要求 1 范围 本标准规定了一体化指挥调度业务资源轻量级数据交换的数据项属性、数据交换格式、数据服务接口访问路径格式和数据操作要求。本标准适用于一体化指挥调度应用系统的开发建设。2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 17295 国际贸易计量单位代码 SJ/T 11676-

4、2017 信息技术 元数据属性 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。3.1.1 一体化指挥调度业务资源 resources of integrated command and dispatch 支撑一体化指挥调度活动的相关要素。3.1.2 表示状态转移 representational state transfer 为分布式超媒体系统提供了架构约束与架构风格，从整体上一方面强调组件交互的可伸缩性、接口的通用性、组件的独立部署性，另一方面强调中间组件要减少交互延迟、增强安全性和封装遗留系统。3.1.3 JavaScript 对象标记 javascript ob

5、ject notation 基于 JavaScript Programming Language,Standard ECMA-262 3rd Edition-December 1999 的一个子集，完全独立于程序语言的轻量级的数据交换格式。3.2 缩略语 下列缩略语适用于本文件。API：应用程序编程接口(Application Program Interface)T/CICC 160022018 2 HTTP：超文本传输协议(Hyper Text Transfer Protocol)HTTPS：基于安全套接字层的超文本传输协议(Hyper Text Transfer Protocol over

6、 Secure socket layer)REST：表述性状态转移(Representational State Transfer)JSON：JavaScript 对象标记(JavaScript Object Notation)SQL：结构化查询语言(Structured Query Language)URL：统一资源定位符(Uniform Resource Locator)4 数据项属性 一体化指挥调度业务资源数据交换的数据项属性包括英文名称、数据类型、数据格式、值域和计量单位，具体内容如表1所示。其中，“名称”即数据项属性；“定义”是对数据项属性的解释；“约束”即数据库字段的非空约束性特征

7、；“数据类型”即数据值的集合。表1 数据项属性 序号 名称 定义 约束 数据类型 备注 1 英文名称 数据条目名称 必选 字符串 名称长度不能大于30个字符。2 数据类型 用于表示数据条目的符号、字符或其他表示类型 必选 字符串 数据类型应符合 SJ/T 11676-2017表 3 中规定的数据类型可能的取值，但不限于此表中所列。3 数据格式 从业务角度规定的数据条目值的格式需求，包括所允许的最大和/或最小字符长度、数据条目值的表示格式 必选 字符串 数据格式应符合 SJ/T 11676-2017表 4 中规定的数据格式。4 值域 根据相应属性中所规定的数据类型、数据格式而确定的数据条目的允许

8、值的集合 可选 字符串 值域按SJ/T 11676-2017，6.5.4中第六段的规定。5 计量单位 属于数值型的数据条目值的计量单位 可选 字符串 见 GB/T 17295 中的计量单位的名称。5 数据交换格式 一体化指挥调度应用系统所交换的业务资源数据采用轻量级数据交换格式，如JSON。6 数据服务接口访问路径格式 一体化指挥调度业务资源数据交换的数据服务接口访问路径格式应符合以下要求：a)数据服务提供方与数据操作方之间使用 HTTP 作为通信协议，如果考虑数据传输安全，应使用HTTPS 作为保密通信协议；b)数据传输采用 REST 格式的 HTTP 请求；T/CICC 160022018

9、 3 c)每个路径代表一种资源，路径中不能有动词，只能有名词，并且所用的名词通常与数据库的表名或视图名对应；d)数据服务接口访问路径中的资源名称如果是英语时应使用复数；示例：某数据服务接口提供用户的信息，则它的访问路径应设计为：https:/ URL 中。示例：某 URL 为：https:/ 数据操作要求 7.1 数据操作动作 一体化指挥调度业务资源数据交换的数据操作动作按HTTP动词表示资源的具体操作类型来划分，常用的数据操作动作如表2所示。其中，中“HTTP动词”即HTTP操作命令；“HTTP动词对应的SQL命令”即HTTP操作命令对应的SQL语句的命令；“SQL命令释义”即HTTP操作命

10、令对应的SQL语句的命令释义。表2 数据操作动作 序号 HTTP动词 HTTP动词对应的SQL命令 SQL命令释义 1 GET SELECT 从服务器中取出业务资源的一项或多项记录。2 POST CREATE 在服务器中新建一项业务资源记录。3 PUT UPDATE 在服务器中更新业务资源记录。数据操作方提供改变后的完整业务资源记录。4 PATCH UPDATE 在服务器中更新业务资源记录。数据操作方提供改变的业务资源记录的属性数据。5 DELETE DELETE 从服务器中删除业务资源记录。7.2 数据操作返回状态 一体化指挥调度业务资源数据交换的数据操作结束后，数据服务提供方向数据操作方返

11、回的状态包括状态码和提示信息，状态提示如表3所示。其中，“状态码”即数据服务提供方响应的状态；“提示信息”即状态码对应的提示信息，指明具体请求是否已成功，还可以揭示请求失败的确切原因；“提示信息释义”是对提示信息的详细解释。T/CICC 160022018 4 表3 数据操作返回状态 序号 状态码 提示信息 提示信息释义 1 200 OK 数据服务提供方成功返回数据操作方请求的数据。2 201 CREATED 数据操作方新建或修改数据成功。3 202 ACCEPTED 一个请求已经进入后台排队。4 204 NO CONTENT 数据操作方删除数据成功。5 400 INVALID REQUEST

12、 数据操作方发出的请求有错误，数据服务提供方没有进行新建或修改数据的操作。6 401 UNAUTHORIZED 数据操作方没有权限。7 403 FORBIDDEN 数据操作方得到授权，但是访问是被禁止的。8 404 NOT FOUND 数据操作方发出的请求针对的资源记录不存在，数据服务提供方没有进行操作。9 406 NOT ACCEPTABLE 数据操作方请求的格式不可得。10 410 GONE 数据操作方请求的资源记录被永久删除，且不会再得到的。11 422 UNPROCESSABLE ENTITY 当创建一个对象时，发生一个验证错误。12 500 INTERNAL SERVER ERROR 数据服务提供方发生错误，数据操作方将无法判断发出的请求是否成功。_