【GA公共安全标准】 消防公共服务平台技术规范第2部分:服务管理接口

ICS35.240
中华人民共和国公共安全行业标准GA/T1038.2-2012
消防公共服务平台技术规范
第2部分：服务管理接口
Technical specifications for the public fire service platform-Part 2:Service management interfaces2012-12-27发布
中华人民共和国公安部
2013-01-01实施
GA/T1038.2—2012
GA/T1038《消防公共服务平台技术规范》拟分部分出版，各部分将按照在消防公共服务平台的作用确立下面列出本标准的预计部分：第1部分：总体架构及功能要求；一第2部分：服务管理接口；
一第3部分：信息交换接口；
一第4部分：消防综合业务接口；第5部分：地理信息服务接口。
本部分为GA/T1038的第2部分。
本部分按照GB/T1.1—2009给出的规则起草。本部分由公安部消防局提出。
本部分由公安部计算机与信息处理标准化技术委员会归口。本部分起草单位：公安部沈阳消防研究所。本部分主要起草人：张春华、傅永财、朱春玲、姜学资、王佩青、吕建波、梁云杰、曾题。1
1范围
消防公共服务平台技术规范
第2部分：服务管理接口
GA/T1038.2—2012
GA/T1038的本部分规定了消防公共服务平台中服务管理平台（以下简称平台）对应用实体提供的软件接口（以下简称接口)功能及参数，本部分适用于服务管理平台，以及需使用服务管理平台进行服务注册发布和服务查询调用的应用实体的开发和应用。
2规范性引用文件
下列文件对于本文件的应用是必不可少的，凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GA/T1038.1一2012消防公共服务平台技术规范第1部分：总体架构及功能要求3术语、定义和缩略语
GA/T1038.1一2012界定的术语、定义和缩略语适用于本文件。4平台接口
4.1接口功能
服务管理平台提供服务注册发布和服务检索查询两类接口，接口的功能如下：服务注册发布接口：提供服务注册发布及修改、服务订阅提交及修改、服务订阅通知方式提交a
及修改等功能；
服务检索查询接口：提供服务查询、服务订阅查询和服务订阅通知方式查询等功能。b)
4.2接口参数
4.2.1类的定义
类名称和说明
平台接口使用的自定义类名称和说明见表1。表1类名称和说明
authInfoEntity
类名称
personInChargeEntity
serviceAttachmentEntity
安全验证实体，具体要求见4.2,1.2服务责任人实体，具体要求见4.2.1.3服务附件实体，具体要求见4.2.1.4GA/T1038.2—2012
类名称
serviceProxyEntity
serviceEntity
saveService
SaveServiceResult
serviceQueryCondEntity
subseriptionEntity
subscriptionQueryCondEntity
subscriptionNotifierEntity
subscriptionNotifierQueryCondEntityfindService
findServiceResult
findSubseription
findSubscriptionResult
SaveSubscription
saveSubscriptionResult
findSubscriptionNotifier
findSubscriptionNotifierResultsaveSubscriptionNotifier
saveSubscriptionNotifierResultlist(serviceEntity)
list(serviceAttachmentEntity)list(serviceProxyEntity)
list(subscriptionEntity)
list(subscriptionNotifierEntity)安全验证实体
用于封装安全验证信息，内容见表2。表2
用户名
userID
password
表1(续)
代理服务实体，具体要求见4.2.1.5服务实体，具体要求见4.2.1.6
服务注册发布及修改输人类，具体要求见4.2.1.7服务注册发布及修改输出类，具体要求见4.2.1.8服务查询条件实体，具体要求见4.2.1.9服务订阅实体，具体要求见4.2.1.10服务订阅查询条件实体，具体要求见4.2.1.11服务订阅通知方式实体，具体要求见4.2.1.12服务订阅通知方式查询条件实体，具体要求见4.2.1.13服务检索查询输人类，具体要求见4.2.1.14服务检索查询输出类，具体要求见4.2.1.15服务订阅查询输入类，具体要求见4.2.1.16服务订阅查询输出类，具体要求见4.2.1.17服务订阅提交及修改输人类，具体要求见4.2.1.18服务订阅提交及修改输出类，具体要求见4.2.1.19服务订阅通知方式查询输人类，具体要求见4,2.1.20服务订阅通知方式查询输出类，具体要求见4.2.1.21服务订阅通知方式提交及修改输入类，具体要求见4.2.1.22服务订阅通知方式提交及修改输出类，具体要求见4.2.1.23选定的服务列表
选定的服务附件列表
选定的代理服务列表
选定的服务订阅内容列表
选定的服务订阅通知方式列表
安全验证实体的内容
string
string
用户的标识符
用户的密码
服务责任人实体
用于封装服务责任人信息，内容见表3。表3服务责任人实体的内容
责任人
personName
服务附件实体
用于封装服务附件，内容见表4。序号
文件名
文件类型
文件扩展名
绝对路径
相对路径
文件内容
fileName
fiteType
fileExt
absolutePath
relativePath
fileContent
代理服务实体
用于封装代理服务，参数见表5。序号
代理服务ID
访间地址
认证方式
是否启用SSL
服务状态
服务实体
serviceID
accessPoint
authMethod
useSSL
serviceStatus
用于封装服务信息，内容见表6。类型
string
string
string
贵任人姓名
电话号码
邮件地址
表4服务附件实体的内容
string
string
string
string
string
boolean
代理服务实体参数
string
string
string
boolean
string
代理服务的ID
GA/T1038.2-2012
采用base64Bin&ry转换方式
代理服务的WSDL地址
见4.2.2的认证方式
调用代理时是否采用SSL传输
代理服务的状态
见4.2.2的服务状态
GA/T1038.2—2012
删除标志
服务D
服务名
服务版本
技术类型
业务类型
发布类型
访间类型
服务级别
所属系统
组织机构
认证方式
是否启用SSL
服务状态
访问地址
是否生成代理
发布者代码
发布者
服务责任人
服务播述
服务附件
代理服务
delFlag
servicelD
serviceName
serviceVersion
technicalType
businessType
serviceNature
serviceOwnership
serviceLevel
businessSystem
organization
authMethod
useSSL
domain
serviceStatus
accessPoint
publishProxy
publisherCode
publisherName
personInCharge
serviceDesc
serviceAttachments
serviceProxies
string
string
string
string
string
string
string
string
string
string
string
Boolean
string
string
string
Booiean
string
string
服务实体的内容
personlnChargeEntity
string
list(serviceAttachmentEntity)list(serviceProxyEntity)
服务注册发布及修改输入类
用于封装服务注册发布及修改输入信息，内容见表7。4
见4.2.2的删除标志
服务的唯一标识
服务的名称
服务版本信息
见4.2.2的技术类型
见4.2.2的业务类型
见4.2.2的发布类型
见4.2.2的访问类型
服务的优先级别
服务归属的应用系
统标识
所属组织机构
调用代理时的认证
调用代理时是否采
用SSL传输
服务归满地域标识
见4.2.2的服务状态
服务的WSDL地址
True：在服务管理平
台生成代理；
False：只在服务管理
平台注册，但不生成
服务发布人代码
服务发布人姓名
服务负责人姓名
服务描述信息
服务注册时需要上
传的附件信息
代理服务的相关
不能为空
采用UUID
名称要求唯一，不
能为空
不能为空
不能为空
不能为空
不能为空
不能为空
不能为空
不能为空，见4.2.2
的认证方式
不能为空
不能为空
安全验证信息
服务实体信息
服务注册发布及修改输入类的内容表7
authInfo
service
服务注册发布及修改输出类
authInfoEntity
serviceEntity
用于封装服务注册发布及修改输出信息，内容见表8。表8
调用结果消息代码
调用结果消息
服务实体信息
message
service
服务查询条件实体
具体的服务信息
服务注册发布及修改输出类的内容类型
string
string
serviceEntity
用于封装服务查询条件，参数见表9。表9
服务ID
服务名
发布者代码
发布者
技术类型
业务类型
发布类型
访间类型
所属系统
组织机构
所属域
servicelD
serviceName
publisherCode
publisherName
technicalType
businessType
serviceNature
serviceOwnership
businessSystem
organization
domain
服务订阅实体
用于封装服务订阅，参数见表10。说明
具体的服务信息
GA/T1038.2-2012
不能为空
包括注册的服务信息以
及生成的代理信息
服务查询条件实体参数
string
string
string
string
string
string
string
string
string
string
string
服务的唯一标识
服务的名称
服务发布人代码
服务发布人姓名
见4.2.2的技术类型
见4.2.2的业务类型
见4.2.2的发布类型
见4.2.2的访问类型
服务归属的应用系统标识
所属组织机构
服务归属的域标识
GA/T1038.2—2012
服务订阅号
服务ID
订氮类型
订间者代码
订网者
订阅者电话
订者Email
创建时间
过期时间
subscriptionID
servicelD
服务订阅实体参数
string
string
subseriptionType
subscriptorCode
subscriptorName
createDate
expiredDate
服务订阅查询条件实体
string
string
string
string
string
string
string
用于封装服务订阅查询条件，参数见表11。表11
订阅者代码
订阈者
订阅类型
subseriptorCode
subscriptorName
subscriptionType
服务订阅通知方式实体
服务订阅流水号，订阅成功
后，系统自动生成一个ID
需订阅服务的ID
订阅人代码
订阅人姓名
订阅人电话
订阅人邮件
订阅生效时间
订阅过期时间
服务订阅查询条件实体参数
string
string
string
用于封装服务订阅通知方式，参数见表12裘12
服务订阅号
服务号
业务类型
订阅类型
订阅者代码
订阅者
订阅者电话
订阅者Email
创建时间
过期时间
服务订阅通知方式实体参数
subscriptionNotifierID
servicelD
businessType
subscriptionType
subscriptorCode
subscriptorName
createDate
handleFlag
string
string
string免费标准下载网bzxz
string
string
string
string
string
string
string
不能为空
保留扩展用
不能为空
不能为空
不能为空
保留扩展用
保留扩展用
服务订阅通知方式查询条件实体用于封装服务订阅通知方式查询条件，参数见表13。表13
订阅者代码
订阅者
订阅类型
服务订阅通知方式查询条件实体参数类型
subscriptorCode
subseriptorName
subscriptionType
服务检索查询输入类
string
string
string
用于封装服务检索查询输入信息，内容见表14。表14
安全验证信息
服务查询条件
authInfo
serviceQueryCond
服务检索查询输出类
服务检索查询输入类的内容
authInfoEntity
serviceQueryCondEntity
用于封装服务检索查询输出信息，内容见表15。表15
调用结果消息代码
调用结果消息
服务列表
message
services
服务订阅查询输入类
GA/T1038.2—2012
保留扩展用
服务检案查询条件
服务检索查询输出类的内容
string
string
list(serviceEntity)
用于封装服务订阅查询输入信息，内容见表16。表16
安全验证信息
服务订阅查询条件
authInfo
返回一个服务实体列表
服务订阅查询输入类的内容
authinfoEntity
subscriptionQueryCond
服务订阅查询输出类
subscriptionQueryCondEntity
用于封装服务订阅查询输出信息，内容见表17。说明
文字描述
GA/T1038.2-2012
调用结果消息代码
调用结果消息
服务订阅列表
messege
subscriptions
服务订阅提交及修改输入类
服务订阅查询输出类的内容
string
string
list(subscriptionEntity)
用于封装服务订阅提交及修改输入信息，内容见表18。表18
安全验证信息
服务订阅
authInfo
subscription
返回一个服务订阅内容列表
服务订阅提交及修改输入类的内容类型
authInfoEntity
subscriptionEntity
服务订阅提交及修改输出类
用于封装服务订阅提交及修改输出信息，内容见表19表19
调用结果消息代码
调用结果消息
服务订间
message
subscription
服务订阅的内容
服务订阅提交及修改输出类的内容类型
string
string
subscriptionEntity
服务订阅通知方式查询输入类
用于封装服务订阅通知方式查询输人信息，内容见表20。表20
安全验证信息
服务订阅通
知方式查询
authInfo
服务订阅的内容
服务订阅通知方式查询输入类的内容标识
subscriptionNotifierQueryCond服务订阅通知方式查询输出类
authInfoEntity
subscriptionNotifierQueryCondEntity用于封装服务订阅通知方式查询输出信息，内容见表21。8
调用结果消息代码
调用结果消息
服务订阅通知方式列表
服务订阅通知方式查询输出类的内容表21
message
subscriptionNotifiers
string
string
list(subscriptionNotifierEntity)服务订阅通知方式提交及修改输入类用于封装服务订阅通知方式提交及修改输入信息，内容见表22表22服务订阅通知方式提交及修改输入类的内容序号
安全验证信息
服务订阅通知方式
authinfo
subscriptionNotifier
authInfoEntity
subscriptionNotifierEntity
服务订阅通知方式提交及修改输出类用于封装服务订阅通知方式提交及修改输出信息，内容见表23。表23
调用结果消息代码
调用结果消息
服务订阅通知方式
静态参数
服务订阅通知方式提交及修改输出类的内容标识
message
subscriptionNotifier
静态参数的标识和取值见表24。string
string
subseriptionNotifierEntity
表24静态参数
削除标志
技术类型
delFlag
technicalType
A:增加
D剧除
10：WS类型
20JMS类型
30:FTP类型
40.Socket类型
GA/T1038.2—2012
GA/T1038.2—2012
发布类型
访间类型
业务类型
服务状态
认证方式
4.3接口描述
服务注册发布接口
总体描述
serviceNature
表24（续）
10：公安部消防局统一下
发的服务
20：总队自定义的服务
serviceOwnership
businessType
serviceStatus
authMethod
10：共享服务
20：私有服务
100，灭火数授指挥
101：消防监督管理
102，部队管理
103：社会公众服务
104：基础数据服务
10:未发布
20：已启动
30：已停止
00，无认证
10：用户名密码认证
20：数据证书认证
可扩展
默认为10
可扩展
可扩展
可扩展
实现服务注册发布及修改、服务订阅提交及修改、服务订阅通知方式提交及修改等功能，描述见表25。
表25注册发布接口描述
接口名称
接口名称标识
接口提供方
服务发起方
股务接收方
接口调用时机
接口类型
服务注册发布接口
UDDIPublishService
服务管理平台
对服务注册发布及修改、服务订阅提交及修改功能服务发起方为服务提供者对服务订阅通知方式提交及修改功能服务发起方为服务使用者服务管理平台
注册发布服务、提交及修改服务订阅、提交及修改服务订阅通知方式时调用该接口WebService
4.3.1.2服务注册发布及修改
服务发起方为服务的提供者，服务注册发布及修改输人、输出参数见表26。10
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。