GB/T 29191-2025 共性服务信息描述

　　ICS 35.240. 01 CCS L 70

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 29191—2025代替 GB/T29191—2012

　　共性服务信息描述

　　Information description ofcommon service

　　2025-08-01发布 2025-11-01实施

　　国家市场监督管理总局国家标准化管理委员会

　　

　　发

　　

　　布

　　GB/T 29191—2025

　　目 次

　　前言 Ⅲ

　　1 范围 1

　　2 规范性引用文件 1

　　3 术语 、定义和缩略语 1

　　3. 1 术语和定义 1

　　3. 2 缩略语 2

　　4 描述模型基础 2

　　4. 1 关系及符号说明 2

　　4. 2 描述方法 3

　　4. 3 数据类型及格式 4

　　5 描述模型 4

　　5. 1 总体框架 4

　　5. 2 服务概要 6

　　5. 3 服务接 口 8

　　5. 4 服务质量 11

　　5. 5 服务策略 13

　　6 扩展方式和规则 15

　　6. 1 扩展方式 15

　　6. 2 扩展规则 15

　　附录 A (资料性) 即时通信共性服务信息描述扩展 16

　　A. 1 概述 16

　　A. 2 服务类别值域代码 16

　　A. 3 接口名称代码 16

　　A. 4 消息参数描述 16

　　参考文献 21

　　Ⅰ

　　GB/T 29191—2025

　　前 言

　　本文件按照 GB/T 1. 1—2020《标准化工作导则 第 1部分 :标准化文件的结构和起草规则》的规定起草 。

　　本文件代替 GB/T 29191—2012《共性服务信息描述规范》, 与 GB/T 29191—2012相比 , 除结构调整和编辑性改动外 ,主要技术变化如下 :

　　a) 删除了概述的内容(见 2012年版的 5. 1) ;

　　b) 更改了 “信息实体 ”和 “元素 ”的描述方法(见 4. 2,2012年版的 5. 3) ;

　　c) 更改了数据类型和格式的内容(见 4. 3,2012年版的 5. 4) ;

　　d) 将“组织机构代码 ”更改为“统一社会信用代码 ”(见 5. 2. 5,2012年版的 6. 2) ;

　　e) 将“错误 ”更改为“出错 ”(见 5. 3. 3,2012年版的 6. 3. 2) 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别专利的责任 。

　　本文件由全国电子业务标准化技术委员会(SAC/TC83)提出并归 口 。

　　本文件起草单位 :衢州立维网络科技有限公司 、江西金虎保险设备集团有限公司 、浙江新再灵科技股份有限公司 、嘉兴聚水潭智能科技有限公司 、福建理工大学 、杭州瑞盈文化传播有限公司 、中国标准化研究院 、云图数据科技(郑 州) 有 限 公 司 、湖 北 华 中 电 力 科 技 开 发 有 限 责 任 公 司 、浪 潮 智 慧 供 应 链 科 技 (山东)有限公司 、北京华科众合科技有限公司 、常州良旭车辆配件有限公司 、宁波正海科技有限公司 、贵州丰茂供应链管理股份有限公司 、中国铁道科学研究院集团有限公司铁路 12306科创中心 、中国轻工业信息中心 、上海聚货通电子商务有限公司 、广东烟草中山市有限责任公司 、上海聚水潭网络科技有限公司 、浪潮智慧科技创新(山东)有限公司 、杭州物必连科技有限公司 、贵州大学 、贵州优联博睿科技有限公司 、北京中科标准科技集团有限公司 、福建省中科标准科技有限责任公司 。

　　本文件主要起草人 : 洪茜 、刘颖 、李慈女 、周含奕 、张弛 、方凯 、金冰 、孙世国 、周洋 、王奕标 、潘金良 、朱立柏 、谢明浩 、赵阳 、孟慧敏 、汪 健 雄 、熊 波 林 、张 宜 红 、廖 博 文 、许 诚 、李 丽 辉 、颜 嘉 梁 、林 莹 、郝 禾 琼 、杨小林 、杜红伟 、王志民 、曾小凡 、李晖 、闵圣天 、刘湘怡 。

　　本文件及其所代替文件的历次版本发布情况为 :

　　— 2012年首次发布为 GB/T 29191—2012;

　　— 本次为第一次修订 。

　　Ⅲ

　　GB/T 29191—2025

　　共性服务信息描述

　　1 范围

　　本文件规定了信息化领域中共性服务信息描述模型 ,包括服务概要 、服务接口 、服务质量和服务策略 ,并给出了信息描述的扩展方式和规则 。

　　本文件适用于信息化领域中共性服务的开发 、调用和应用 。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中 , 注 日期的引用文件 ,仅该日期对应的版本适用于本文件 ;不注日期的引用文件 ,其最新版本(包括所有的修改单) 适用于本文件 。

　　GB/T 7408. 1 日期和时间 信息交换表示法 第 1部分 :基本原则

　　GB 32100 法人和其他组织统一社会信用代码编码规则

　　3 术语、定义和缩略语

　　3. 1 术语和定义

　　下列术语和定义适用于本文件 。

　　3. 1. 1

　　服务 service

　　由某个实体 , 以约定的接口提供的满足特定需求的功能或功能的集合 。

　　注 : 服务在技术上能有多种表现形式和使用方式 。如 Web服务等 。

　　[来源 :GB/T 25530—2010,4. 1,有修改] 3. 1.2

　　共性服务 common service

　　跨行业 、领域普遍使用的 、可重用的服务(3. 1. 1) 。

　　注 : 一般通过标准开放的网络协议和标准接口被外部访问和使用 。

　　3. 1.3

　　值域 valuedomain

　　允许值的集合 。

　　3. 1.4

　　操作 operation

　　被执行的某一转换或查询的规范说明 。

　　注 1: 操作是对信息系统相关实体执行的行为 。

　　注 2: 某个操作具有一个名称和一列参数 。

　　3. 1.5

　　接口 interface

　　表征实体行为的操作(3. 1. 4)的命名集合 。

　　注 : 实体或实体的某种代表(如服务)通过接口来实现功能 。

　　1

　　GB/T 29191—2025

　　3.2 缩略语

　　下列缩略语适用于本文件 。

　　UML:统一建模语言(Unified Modeling Language)

　　URL:统一资源定位符(Uniform Resource Locator)

　　4 描述模型基础

　　4. 1 关系及符号说明

　　本文件采用 UML方法给出共性服 务 信 息 描 述 模 型 , 用 UML 中 “类 ”的 概 念 表 示 “信 息 实 体 ”, 用UML 中 “类的属性 ”的概念表示 “信息实体的元素 ”(简称 “元素 ”) 。

　　本文件涉及 UML定义的以下两种模型关系 ,并采用 UML静态结构图表示信息实体之间的关系 。

　　a) 关联 ,用于描述两个或更多信息实体之间的一般关系 。

　　1) 关联的方向说明 ,如果不指明方向 ,则假定为双向关联 ,见图 1b) ;如果是单向关联 ,关联方向在线段终点用箭头来标记 ,见图 1a) 。

　　2) 模型中使用 “角色名称 ”说明源对象与 目标对象之间的关系 ,见图 1c) 。在双向关联中 ,提供两个角色名称 。角色名称“角色 1”表示信息实体 1对信息实体 2 的关系 ,“角色 2”表示信息实体 2对信息实体 1 的关系 。“基数 1”表示信息实体 1 与信息实体 2 单个实例关联的实例的数量 ,“基数 2”表示信息实体 2 与信息实体 1 单个实例关联的实例的数量 。基数的取值可为 N ,也可为 M. . N ,其中 N是正整数 ,M是非负整数 ,M小于或等于 N。基数取值为 1 时 ,可省略不写 。

　　a) b) c)

　　图 1 关联关系

　　b) 聚合 ,用于说明两个信息实体之间的部分与整体的关系 。在聚合关系中 ,一个信息实体(H)包含另外的信息实体(J、K) ,J、K 可认为是 H 的子信息实体 ,见图 2。对于子信息实体 J、K,可标注 “基数 ”,表示 H 包含的 J 的实例数量 、K 的实例数量 。基数的取值可为 N ,也可为 M. . N ,其中 N是正整数 ,M是非负整数 ,M小于或等于 N。基数取值为 1 时 ,可省略不写 。

　　2

　　GB/T 29191—2025

　　a) b)

　　图 2 聚合关系

　　4.2 描述方法

　　信息实体和元素按表 1、表 2进行描述 ,信息实体和元素描述属性见表 3,表 3 中 :

　　a) 描述属性 :信息实体或元素的属性 ;

　　b) 是否必备 :该描述属性是必备属性还是可选属性 ,“M”表示必备属性 ,“O”表示可选属性 ;

　　c) 定义及说明 :属性含义的解释和说明 。

　　表 1 信息实体描述方法

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　表 2 元素描述方法

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　表 3 信息实体和元素描述属性

　　序号

　　描述属性

　　是否必备

　　定义及说明

　　1

　　中文名称

　　M

　　信息实体或元素的中文名称

　　2

　　英文名称

　　O

　　信息实体或元 素 的 英 文 名 称 。英 文 名 称 以《牛 津 英 语 词 典》的 英 文 拼 写 为 准 。信息实体的英文名称 采 用 UCC(大 驼 峰 式 命 名 法 , Upper Camel Case) 方 式 , 即每个单词 的 首 字 母 都 用 大 写 ; 元 素 的 英 文 名 称 采 用 LCC(小 驼 峰 式 命 名 法 , LowerCamelCase) 方式 , 即第一个单词用小写字母 ,后续每个单词的首字母 都大写

　　3

　　数据类型及格式

　　O

　　对元素的有效值域和允许对该值域内的值进行有效操作 的 规 定 ,元 素 的 数 据 类型及格式的表示见 4. 3

　　4

　　约束/条件

　　M

　　说明信息实体或元素是否为描述共性服务所必选(M) 、条件必选(C) 或可选(O)的表示

　　3

　　GB/T 29191—2025

　　表 3 信息实体和元素描述属性 (续)

　　序号

　　描述属性

　　是否必备

　　定义及说明

　　5

　　最大出现次数

　　M

　　信息实体或元素可具有的最大实例数目

　　6

　　值域

　　O

　　元素所允许的值的集合

　　7

　　说明

　　O

　　对信息实体或元素含义的解释

　　4.3 数据类型及格式

　　4.3. 1 数据类型

　　信息实体的数据类型为复合型 ,元素的数据类型表示方法和说明见表 4。

　　表 4 元素的数据类型表示方法和说明

　　数据类型

　　数据类型的表示方法

　　说明

　　字符型

　　C

　　包括字符 、数字字符或汉字等在内的任意字符

　　数值型

　　N

　　数值

　　日期型

　　YYYYMMDD

　　格式按 GB/T 7408. 1 的规定

　　日期时间型

　　YYYYMMDDhhmmss

　　格式按 GB/T 7408. 1 的规定

　　布尔型

　　BL

　　是/否 ,on/off,true/false

　　二进制流

　　BY

　　图像 、音频 、WAN、RM、AVI、MPEG等二进制流文件格式

　　4.3.2 数据格式

　　元素的数据格式使用以下形式表达 :

　　a) 字符型和数值型后加正整数表示定长格式 ;

　　示例 1: C6表示 6位定长的字符 。

　　示例 2: N16表示 16位定长的数值 。

　　b) 字符型和数值型后加“x.. y”表示从最小到最大长度的格式 ;

　　示例 3: C1. . 10表示最短 1位 、最长 10位的字符 。

　　示例 4: N1. . 6表示最短 1位 、最长 6位的数值 。

　　c) 字符型后加“.. ul”表示长度不确定的格式 ;

　　示例 5: C. . ul表示长度不确定的字符 ,一般多为大量的文本内容 。

　　d) 数值型后加“.. x,y”表示小数位 ;

　　示例 6: N. . 17,2 表示最长 17位 、小数点后 2位的数值 。

　　e) 二进制流(BY)后加具体的媒体格式 。

　　示例 7: BY-JPEG表示“JPEG”格式的文件 。

　　5 描述模型

　　5. 1 总体框架

　　共性服务信息描述模型的总体框架见图 3。

　　4

　　GB/T 29191—2025

　　图 3 共性服务信息描述模型的总体框架

　　共性服务信息通过基本元素和其包含的信息实体给出完整的描述 。共性服务的基本元素见表 5,信息实体见表 6。

　　表 5 共性服务的基本元素

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　服务中文名称

　　serviceCName

　　C. . 100

　　M

　　1

　　—

　　服务的中文名称

　　服务英文名称

　　serviceEName

　　C. . 200

　　M

　　1

　　—

　　服务的英文名称

　　服务标识符

　　serviceID

　　C. . 600

　　C

　　1

　　—

　　服务的唯一标识 ,按 照 一 定 规 则 组 成 。 服 务 向注册中心注册时 ,注册中心应设定服务标识

　　表 6 共性服务信息实体

　　中文名称

　　英文名称

　　约束/条件

　　最大出

　　现次数

　　说明

　　服务概要

　　ServiceProfile

　　M

　　1

　　服务的简要描述 ,定义服务所属 的 类 别 、服 务 执 行 成 功 的 前 提 条 件 、服务执行的可能结果等 。模型的详细描述见 5. 2

　　服务接 口

　　ServiceInterface

　　M

　　1

　　描述服务的调用 ,表 达 服 务 的 相 关 操 作 及 输 入 和 输 出 信 息 , 服 务 部署的访问点,绑定的协议等 。模型的详细描述见 5. 3

　　服务质量

　　ServiceQuality

　　O

　　1

　　描述服务的稳定性 和 性 能 , 包 括 可 用 性 、可 访 问 性 、可 靠 性 、故 障 恢复时间 、响应时间 、吞吐量 、并 发 性 等 方 面 的 内 容 。模 型 的 详 细 描 述见 5. 4

　　服务策略

　　ServicePolicy

　　O

　　1

　　包含安全性 、事务性 、约束等策略 ,通 知 服 务 请 求 者 需 要 某 些 补 充 性要求方可成功调用 。模型的详细描述见 5. 5

　　5

　　GB/T 29191—2025

　　5.2 服务概要

　　5.2. 1 描述模型

　　服务概要是对服务的简要描述 ,包含基本信息 、服务功能 、服务提供者和服务更新信息 。 服务概要描述模型见图 4。

　　图 4 服务概要描述模型

　　5.2.2 信息实体描述

　　服务概要信息实体描述见表 7。

　　表 7 服务概要信息实体描述

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　基本信息

　　BasicInformation

　　M

　　1

　　服务的基本信息 ,包 括 服 务 类 别 、常 用 的 关 键字 、版本 、注册日期等内容

　　服务功能

　　ServiceFunction

　　M

　　1

　　说明服务的功能 ,包 括 服 务 的 功 能 描 述 , 服 务执行的前提条件和结果

　　服务提供者

　　ServiceProvider

　　O

　　1

　　服务提供者的相关信息

　　服务更新信息

　　InformationOfServiceUpdate

　　O

　　1

　　提供服务更新的相关信息

　　5.2.3 基本信息的元素描述

　　基本信息的元素描述见表 8。

　　6

　　GB/T 29191—2025

　　表 8 基本信息的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　服务类别

　　serviceCategory

　　C. . 128

　　O

　　N

　　—

　　服务的类别

　　关键字

　　keyword

　　C. . 128

　　O

　　N

　　—

　　服务 关 键 特 性 的 词 , 用 于 服 务 检 索 。 如 认证 、计费

　　版本

　　version

　　C. . 128

　　M

　　1

　　—

　　服务的 当 前 版 本 , 一 般 用 v1. 0、v1. 1、v2. 0…形式表示

　　注册日期

　　registerDate

　　YYYYMMDD

　　hhmmss

　　C

　　1

　　—

　　服务向注册中心 注 册 时 , 注 册 中 心 应 记 录 注册日期

　　5.2.4 服务功能的元素描述

　　服务功能的元素描述见表 9。

　　表 9 服务功能的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　功能描述

　　functionDescription

　　C. . 128

　　M

　　1

　　—

　　描述服务的功能

　　前提条件

　　precondition

　　C. . 128

　　O

　　N

　　—

　　执行服务所需的必要条件的描述或标识

　　结果

　　result

　　C. . 2000

　　O

　　N

　　—

　　服务执行结果的描述或标识

　　5.2.5 服务提供者的元素描述

　　服务提供者的元素描述见表 10。

　　表 10 服务提供者的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　名称

　　name

　　C. . 128

　　O

　　1

　　—

　　提供服务的机构名称

　　统一社会信用代码

　　unifiedSocialCreditCode

　　C18

　　O

　　1

　　符合 GB 32100

　　服务 提 供 者 的 统 一 社 会信用代码

　　联系人

　　contact

　　C. . 128

　　O

　　1

　　—

　　联系人的姓名

　　联系方式

　　phone

　　C. . 20

　　O

　　1

　　—

　　联系人的联系方式

　　电子邮件地址

　　e-mail

　　C. . 128

　　O

　　1

　　—

　　联系人的电子邮件地址

　　5.2.6 服务更新信息的元素描述

　　服务更新信息的元素描述见表 11。

　　7

　　GB/T 29191—2025

　　表 11 服务更新信息的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　位置

　　location

　　C. . 100

　　O

　　1

　　—

　　给出可查阅有 关 服 务 更 新 信 息 的 网 络

　　地址,以 URL方式描述

　　5.3 服务接口

　　5.3. 1 描述模型

　　服务接口表达服务执行时在服务提供者和服务请求者之间进行服务交互的接 口 。服务接口包括多个信息实体 。从抽象的角度来看 ,服务由一个或多个接口提供 ,接口是服务接口的核心信息实体 。接 口和消息给出抽象消息模型 ,未限定到特定消息交换协议和通信端点 ;服务部署和绑定将抽象服务限定到特定协议和通信端点 。服务接口描述模型见图 5。

　　图 5 服务接口描述模型

　　5.3.2 信息实体描述

　　服务接口信息实体描述见表 12。

　　表 12 服务接口信息实体描述

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　接口

　　Interface

　　M

　　N

　　将 与 操 作 相 关 的 消 息 组 织 到 对 应 的 操 作 , 由 此 描 述 了 一个服务发送和(或)接收的消息集

　　8

　　GB/T 29191—2025

　　表 12 服务接口信息实体描述 (续)

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　消息

　　Message

　　O

　　N

　　用 来 描 述 服 务 发 出 或 收 到 的 一 个 特 定 消 息 的 抽 象 格 式 ,是一系列具有指定数 据 类 型 的 参 数 的 集 合 。定 义 了 作 为操作的一部分进行交换的数据

　　服务部署

　　ServiceDeployment

　　O

　　N

　　服务具体实现的描述

　　绑定

　　Binding

　　O

　　N

　　描述了接口与具有特定 消 息 格 式 和 传 输 协 议 的 操 作 之 间的具体绑定

　　5.3.3 接口的元素描述

　　接口的元素描述见表 13。

　　表 13 接口的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出

　　现次数

　　值域

　　说明

　　接口名称

　　interfaceName

　　C. . 128

　　M

　　1

　　—

　　接口的名称

　　操作名称

　　operationName

　　C. . 128

　　M

　　N

　　—

　　接 口 中操作的名称

　　操作支持事务性

　　operationSupport Transaction

　　BL

　　M

　　N

　　1,0 或

　　true,

　　false

　　取值为 1(true) 时 , 支 持 事 务 性 ; 取值为 0(false) 时 ,不 支 持 事 务 性 ,该元素出 现 次 数 与 操 作 名 称 出 现 次数保持一致

　　补偿操作名称

　　compensationName

　　C. . 128

　　C

　　N

　　已定义

　　操作的名称

　　操作支持 事 务 性 取 值 为 1 时 , 应 选择该 元 素 。 此 时 该 元 素 代 表 原 子事务或长事务的补偿操作

　　输入名称

　　inputName

　　C. . 128

　　O

　　N

　　—

　　输入的名称

　　输入消息

　　inputMessage

　　C. . ul

　　C

　　N

　　已定义的消息

　　输入 名 称 存 在 时 , 应 选 择 该 元 素 ,该元素 出 现 次 数 与 输 入 名 称 出现次数 保 持 一 致 。 对 已 定 义 的 消 息的引用 ,见表 14

　　输出名称

　　outputName

　　C. . 128

　　O

　　N

　　—

　　输出的名称

　　输出消息

　　outputMessage

　　C. . ul

　　C

　　N

　　已定义的消息

　　输出 名 称 存 在 时 , 应 选 择 该 元 素 ,该元素 出 现 次 数 与 输 出 名 称 出现次数 保 持 一 致 。 对 已 定 义 的 消 息的引用 ,见表 14

　　出错名称

　　faultName

　　C. . 128

　　O

　　N

　　—

　　出错的名称

　　出错消息

　　faultMessage

　　C. . ul

　　C

　　N

　　已定义的消息

　　出错 名 称 存 在 时 , 应 选 择 该 元 素 ,该元素 出 现 次 数 与 出 错 名 称 出现次数 保 持 一 致 。 对 已 定 义 的 消 息的引用 ,见表 14

　　9

　　GB/T 29191—2025

　　5.3.4 消息的元素描述

　　消息的元素描述见表 14。

　　表 14 消息的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　消息名称

　　messageName

　　C. . 128

　　M

　　1

　　—

　　消息的名称

　　参数名称

　　parameterName

　　C. . 128

　　O

　　N

　　—

　　消息参数的名称

　　参数类型

　　parameterType

　　C. . 128

　　C

　　N

　　—

　　参数名称存在时 ,应 选 择 该 元 素 ,该 元 素 出 现次数与参数名称出现次数保持一致

　　5.3.5 服务部署的元素描述

　　服务部署包含一系列端点 。服务部署中如果定义了关联的接 口 ,则在绑定中可不定义接 口 ,这时绑定的元素接口的缺省值在服务部署中定义 。服务部署的元素描述见表 15。

　　表 15 服务部署的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出

　　现次数

　　值域

　　说明

　　服务部署名称

　　serviceDeployment

　　Name

　　C. . 128

　　M

　　1

　　—

　　服务部署的名称

　　服务部署接口

　　serviceDeployment Interface

　　C. . ul

　　O

　　1

　　已定义的接口

　　对已定义接口的引用 ,见表 13

　　端点名称

　　endPointName

　　C. . 128

　　O

　　N

　　—

　　服务部署端点的名称

　　端点绑定

　　endPointBinding

　　C. . ul

　　M

　　N

　　已定义的绑定

　　对已定义绑定的引用 ,见表 16

　　端点地址

　　endPointAddress

　　C. . ul

　　M

　　N

　　—

　　该元素 出 现 次 数 与 端 点 地 址 出 现 次数保持 一 致 , 服 务 端 点 的 访 问 地 址 ,用 URL方式表示

　　5.3.6 绑定的元素描述

　　接口是通过为其提供绑定来实现服务 。绑定的元素描述见表 16。

　　表 16 绑定的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　绑定名称

　　bindingName

　　C. . 128

　　M

　　1

　　—

　　绑定的名称

　　绑定接 口

　　bindingInterface

　　C. . ul

　　C

　　1

　　已定义的接 口

　　对已 定 义 接 口 的 引 用 , 见 表 13;服 务 部 署 信息实体 中 未 选 择 绑 定 接 口 元 素 时 , 该 元 素必选

　　10

　　GB/T 29191—2025

　　表 16 绑定的元素描述 (续)

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　绑定类型

　　bindingType

　　C. . 128

　　M

　　1

　　—

　　绑定的协议类型 , 即 访 问 服 务 的 消 息 格 式 和通信协议 , 如 消 息 SOAP 协 议(简 单 对 象 访问 协 议 , Simple Object Access Protocol) 、通信 http协议等

　　5.4 服务质量

　　5.4. 1 描述模型

　　服务质量是服务满足规定或潜在要求(或需要)的特征和特性的总和 。服务质量描述模型见图 6。

　　图 6 服务质量描述模型

　　5.4.2 信息实体描述

　　服务质量主要从性能和稳定性两方面来说明 。服务提供者应对服务的平均响应时间 、可用性 、可访问性 、可靠性等统计量是在什么运行环境下 、多长时间或频次下测量和估算得到的进行申明 , 描 述 见表 17。服务质量信息实体描述见表 18。

　　表 17 服务质量的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　声明

　　declaration

　　C. . 1000

　　M

　　1

　　—

　　对所给 出的 服 务 质 量 的 在 什 么 运行环境下 、多 长 时 间 或 频 次 下 如 何测量和估算得到的进行申明

　　11

　　GB/T 29191—2025

　　表 18 服务质量信息实体描述

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　性能

　　Performance

　　O

　　1

　　用于描述服务的性能和并 发 服 务 的 能 力 ,包 括 服 务 执 行 所支持的并发请求数量 、服 务 吞 吐 量 以 及 服 务 响 应 时 间 等 关键内容

　　稳定性

　　Stability

　　O

　　1

　　用来 描 述 服 务 稳 定 性 方 面 的 能 力 , 包 括 服 务 可 用 性 、可 靠性 、可访问性及故障恢复时间等

　　5.4.3 性能的元素描述

　　性能的元素描述见表 19。

　　表 19 性能的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　最大响应时间

　　maxResponseTime

　　C. . 128

　　O

　　1

　　—

　　发送请求到接收响应之间的最大往返时间

　　最小响应时间

　　minResponseTime

　　C. . 128

　　O

　　1

　　—

　　发送请求到接收响应之间的最小往返时间

　　平均响应时间

　　averageResponseTime

　　C. . 128

　　O

　　1

　　—

　　发送请求到接收响应之间的平均往返时间

　　并发数

　　concurrency

　　C. . 128

　　O

　　1

　　—

　　表示在同一时刻 执 行 服 务 请 求 数 , 描 述 了 服务的并发请求处理能力

　　吞吐量

　　throughput

　　C. . 128

　　O

　　1

　　—

　　表示在单位时间 内 完 成 的 服 务 请 求 处 理 数 ,描述了服务的请求处理能力

　　5.4.4 稳定性的元素描述

　　稳定性的元素描述见表 20,各元素按公式计算 。

　　表 20 稳定性的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　可用性

　　availability

　　C. . 612

　　O

　　1

　　—

　　服务是否存在或 是 否 已 就 绪 可 供 立 即 使 用 ,

　　较大的值表示服 务 具 有 较 高 的 可 用 性 , 较 小

　　的值意味 着 无 法 预 知 在 某 个 特 定 时 刻 服 务

　　是否可用 。 计 算 公 式 : 可 用 性 = 可 用 时 间/

　　服务总时间

　　12

　　GB/T 29191—2025

　　表 20 稳定性的元素描述 (续)

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　可访问性

　　accessibility

　　C. . 612

　　O

　　1

　　—

　　服务响应请求的 概 率 ,较 大 的 值 表 示 服 务 具

　　有较高的可靠性 ,较 小 的 值 意 味 着 服 务 请 求

　　的成功率较低 。计 算 公 式 : 可 访 问 性= 响 应

　　次数/请求次数

　　可靠性

　　reliability

　　C. . 612

　　O

　　1

　　—

　　对请求服务进行 有 效 响 应 的 概 率 , 较 大 的 值表示服务具有较 高 的 可 靠 性 , 较 小 的 值 意 味着服务有效响应 的 概 率 较 低 。计 算 公 式 : 可靠性= 有效响应次数/请求次数

　　故障恢复时间

　　faultRecoveryTime

　　C. . 612

　　O

　　1

　　—

　　因发生故 障 不 能 提 供 服 务 到 系 统 恢 复 正 常服务的时间

　　5.5 服务策略

　　5.5. 1 描述模型

　　服务策略是表示服务的能力 、要求和一般特性的约定 ,用来为服务消费者和服务提供者之间传递交互条件 。如服务的安全 、事务等方面的行为要求或能力的约定等 。服务策略描述模型见图 7。

　　图 7 服务策略描述模型

　　5.5.2 信息实体描述

　　服务策略信息实体描述见表 21。

　　13

　　GB/T 29191—2025

　　表 21 服务策略信息实体描述

　　中文名称

　　英文名称

　　约束/条件

　　最大出现次数

　　说明

　　事务性

　　Transaction

　　O

　　1

　　服务的事务性要 求 相 关 策 略 , 服 务 提 供 的 操 作 是 否 支 持 事务性要求 ,如原子性 、完整性及补偿事务等

　　安全性

　　Security

　　O

　　N

　　能被合法并 正 确 授 权 用 户 所 使 用 的 能 力 。包 括 用 户 鉴 别 、用户访问控制 、数据机密性 、数据完整性等

　　约束

　　Restriction

　　O

　　1

　　对使用服务的一些限制条件

　　5.5.3 事务性的元素描述

　　事务性的元素描述见表 22。

　　表 22 事务性的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　支持事务性

　　supportTransaction

　　BL

　　M

　　1

　　1、0 或 true、 false

　　取值为 1(true) 时 , 支 持 事 务 性 ; 取值为 0(false)时 ,不支持事务性

　　5.5.4 安全性的元素描述

　　安全性的元素描述见表 23。

　　表 23 安全性的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　安全类别

　　safetyType

　　C. . 256

　　M

　　N

　　—

　　描 述 该 服 务 所 采 用 的 安 全类别

　　用户鉴别机制描述

　　userAuthenticationDescription

　　C. . ul

　　O

　　N

　　—

　　描述用户身份的鉴别机制

　　用户访问控制机制描述

　　userAccessControlDescription

　　C. . ul

　　O

　　N

　　—

　　描述用户的访问控制机制

　　机密性处理机制描述

　　confidentialityDescription

　　C. . ul

　　O

　　N

　　—

　　描述服务的机密性处理机制

　　完整性处理机制描述

　　integrityDescription

　　C. . ul

　　O

　　N

　　—

　　描述服务的完整性处理机制

　　5.5.5 约束的元素描述

　　约束的元素描述见表 24。

　　14

　　GB/T 29191—2025

　　表 24 约束的元素描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　使用者条件

　　restrictionOnConsumer

　　C. . 256

　　M

　　1

　　—

　　描述能使用该服务的用户应符合的条件

　　6 扩展方式和规则

　　6. 1 扩展方式

　　本文件的内容是对各行业领域所涉及的共性服务的主要特征进行描述 ,各行业各领域所具有的特定的 、专有的特征可按照本章中的扩展方式进行扩展 ,具体扩展方式如下 :

　　a) 可增加新的或扩展现有的信息实体 ;

　　b) 可在信息实体中增加新的元素 ;

　　c) 可对现有信息实体或元素的可选性进行更严格的限制 ;

　　d) 可对现有信息实体或元素的最大出现次数进行更严格的限制 ;

　　e) 可创建新的代码表 ,作为现有元素的值域 ;

　　f) 可调整现有元素的值域 。

　　6.2 扩展规则

　　按本文件的扩展方式进行扩展时 ,遵循以下扩展规则 :

　　a) 不应改变本文件中现有信息实体和元素的名称 、定义 ;

　　b) 增加的信息实体和元素应与本文件所确定的结构相兼容 ;

　　c) 值域中可用代码替换现有元素的自由文本 ;

　　d) 扩充后的代码表应与扩充前的代码表保持结构一致 。

　　附录 A 给出了即时通信共性服务信息描述扩展示例 。

　　15

　　GB/T 29191—2025

　　附 录 A

　　(资料性)

　　即时通信共性服务信息描述扩展

　　A. 1 概述

　　即时通信服务可实现网络上两人或多人之间信息接近于实时交互 。 即时通信共性服务信息描述在满足本文件第 5 章描述模型基础上 ,按第 6 章进行扩展 ,服务概要中基本信息(5. 2. 3) 的服务类别原值域 、服务接口中接口(5. 3. 3)的接口名称原值域皆为 自 由文本 ,结合即时通信共性服务特点创建新的代码表作为服务类别 、服务接口的值域 ,见 A. 2、A. 3。A. 4 给出了即时通信服务的服务接口消息(5. 3. 4)的参数描述 。

　　A.2 服务类别值域代码

　　服务类别值域代码见表 A. 1。

　　表 A. 1 服务类别值域代码

　　代码

　　名称

　　10

　　状态订阅服务

　　20

　　状态通知服务

　　30

　　消息发送服务

　　A.3 接口名称代码

　　接口名称代码见表 A. 2。

　　表 A.2 接口名称代码

　　代码

　　名称

　　10

　　状态订阅服务接 口

　　11

　　批量状态订阅接 口

　　12

　　单个状态订阅接 口

　　13

　　取消订阅服务接 口

　　20

　　状态通知接 口

　　21

　　批量状态通知接 口

　　22

　　单个状态通知接 口

　　30

　　消息发送接 口

　　A.4 消息参数描述

　　A.4. 1 状态订阅服务

　　A.4. 1. 1 批量状态订阅接口

　　A.4. 1. 1. 1 批量状态订阅接口请求

　　批量状态订阅接口请求参数描述见表 A. 3。

　　16

　　GB/T 29191—2025

　　表 A.3 批量状态订阅接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　使用者条件

　　userConditions

　　C. . 64

　　M

　　1

　　—

　　描述 能 使 用 该 服 务 的 用 户 应符合的条件

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　SUBSCRIBE等

　　订阅者 ID

　　subscriberID

　　C. . 64

　　M

　　1

　　—

　　—

　　被订阅者 ID

　　subscribedToID

　　C. . 64

　　O

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调用方可 输 入 操 作 的 标 识 , 系统会返回给调用者

　　被订阅者表示列表

　　subscribedToRepresentationList

　　C. . 100000

　　M

　　1

　　—

　　—

　　A.4. 1. 1.2 批量状态订阅接口应答

　　批量状态订阅接口应答参数描述见表 A. 4。

　　表 A.4 批量状态订阅接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　A.4. 1.2 单个状态订阅接口

　　A.4. 1.2. 1 单个状态订阅接口请求

　　单个状态订阅接口请求参数描述见表 A. 5。

　　表 A.5 单个状态订阅接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　SUBSCRIBE等

　　订阅者 ID

　　subscriberID

　　C. . 64

　　M

　　1

　　—

　　—

　　被订阅者 ID

　　subscribedToID

　　C. . 64

　　M

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调用方可输入操 作 的 标 识 , 系 统 会 返 回 给调用者

　　A.4. 1.2.2 单个状态订阅接口应答

　　单个状态订阅接口应答参数描述见表 A. 6。

　　17

　　GB/T 29191—2025

　　表 A.6 单个状态订阅接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　A.4. 1.3 取消状态订阅接口

　　A.4. 1.3. 1 取消状态订阅接口请求

　　取消状态订阅接口请求参数描述见表 A. 7。

　　表 A.7 取消状态订阅接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　SUBSCRIBE等

　　订阅者 ID

　　subscriberID

　　C. . 64

　　M

　　1

　　—

　　—

　　被订阅者 ID

　　subscribedToID

　　C. . 64

　　M

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调用方可 输 入 操 作 的 标 识 , 系 统 会返回给调用者

　　A.4. 1.3.2 取消状态订阅接口应答

　　取消状态订阅接口应答参数描述见表 A. 8。

　　表 A. 8 取消状态订阅接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　A.4.2 状态通知服务

　　A.4.2. 1 批量状态通知接口

　　A.4.2. 1. 1 批量状态订阅接口请求

　　批量状态通知接口请求参数描述见表 A. 9。

　　18

　　GB/T 29191—2025

　　表 A.9 批量状态通知接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　—

　　发起通知者 ID

　　initiatorNotificationID

　　C. . 64

　　M

　　1

　　—

　　—

　　收到通知者 ID

　　recipientNotificationID

　　C. . 64

　　O

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调用方 可 输 入 操 作 的 标 识 ,系统会返回给调用者

　　通知 ID列表

　　notificationIDList

　　C. . 100000

　　M

　　1

　　—

　　—

　　A.4.2. 1.2 批量状态通知接口应答

　　批量状态通知接口应答参数描述见表 A. 10。

　　表 A. 10 批量状态通知接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　A.4.2.2 单个状态通知接口

　　A.4.2.2. 1 单个状态通知接口请求

　　单个状态通知接口请求参数描述见表 A. 11。

　　表 A. 11 单个状态通知接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　—

　　发起通知者 ID

　　initiatorNotificationID

　　C. . 64

　　M

　　1

　　—

　　—

　　收到通知者 ID

　　recipientNotificationID

　　C. . 64

　　M

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调用方可 输 入 操 作 的 标 识 , 系统会返回给调用者

　　A.4.2.2.2 单个状态通知接口应答

　　单个状态通知接口应答参数描述见表 A. 12。

　　19

　　GB/T 29191—2025

　　表 A. 12 单个状态通知接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　A.4.3 消息发送服务

　　A.4.3. 1 消息发送接口请求

　　消息发送接口请求参数描述见表 A. 13。

　　表 A. 13 消息发送接口请求参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　接口操作

　　interfaceOperation

　　C. . 64

　　M

　　1

　　—

　　—

　　发送 ID

　　sendID

　　C. . 64

　　M

　　1

　　—

　　—

　　接收 ID

　　receiveID

　　C. . 64

　　M

　　1

　　—

　　—

　　调用方标志

　　callerFlag

　　C. . 64

　　O

　　1

　　—

　　调 用 方 可 输 入 操 作 的 标识 ,系统会返回给调用者

　　通知 ID列表

　　notificationIDList

　　C. . 100000

　　M

　　1

　　—

　　—

　　A.4.3.2 消息发送接口应答

　　消息发送接口应答参数描述见表 A. 14。

　　表 A. 14 消息发送接口应答参数描述

　　中文名称

　　英文名称

　　数据类型及格式

　　约束/条件

　　最大出现次数

　　值域

　　说明

　　返回结果

　　returnResult

　　C. . 64

　　M

　　1

　　—

　　是否成功

　　结果说明

　　resultDescription

　　C. . 2000

　　M

　　1

　　—

　　结果说明

　　20

　　GB/T 29191—2025

　　参 考 文 献

　　[1] GB/T 25530—2010 地理信息 服务

　　21