GA/T 1038.2-2012 消防公共服务平台技术规范 第2部分：服务管理接口

ICS35.240

A90

中华人民共和国公共安全行业标准

/—

GAT1038.22012

消防公共服务平台技术规范

:

第部分服务管理接口

2

ㅤㅤㅤㅤ

Technicalsecificationsfortheublicfireservicelatform—

ppp

:

Part2Servicemanaementinterfaces

g

2012-12-27发布2013-01-01实施

中华人民共和国公安部发布

/—

GAT1038.22012

消防公共服务平台技术规范

:

第部分服务管理接口

2

1范围

/()

GAT1038的本部分规定了消防公共服务平台中服务管理平台以下简称平台对应用实体提供

()。

的软件接口以下简称接口功能及参数

,

本部分适用于服务管理平台以及需使用服务管理平台进行服务注册发布和服务查询调用的应用

实体的开发和应用。

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—:

消防公共服务平台技术规范第部分总体架构及功能要求

GAT1038.120121

、

3术语定义和缩略语

ㅤㅤㅤㅤ

/—、。

GAT1038.12012界定的术语定义和缩略语适用于本文件

4平台接口

4.1接口功能

,:

服务管理平台提供服务注册发布和服务检索查询两类接口接口的功能如下

):、、务订阅通知方式提交

a服务注册发布接口提供服务注册发布及修改服务订阅提交及修改服

及修改等功能;

):、。

b服务检索查询接口提供服务查询服务订阅查询和服务订阅通知方式查询等功能

4.2接口参数

4.2.1类的定义

类名称和说明

平台接口使用的自定义类名称和说明见表1。

表1类名称和说明

序号类名称说明

,

1authInfoEntit安全验证实体具体要求见

y

,

2ersonInChareEntit服务责任人实体具体要求见

pgy

,

3serviceAttachmentEntit服务附件实体具体要求见

y

1

/—

GAT1038.22012

()

表续

1

序号类名称说明

,

4serviceProxEntit代理服务实体具体要求见

yy

,

5serviceEntit服务实体具体要求见

y

,

6saveService服务注册发布及修改输入类具体要求见

,

7saveServiceResult服务注册发布及修改输出类具体要求见

,

8serviceQuerCondEntit服务查询条件实体具体要求见

yy

,

9subscritionEntit服务订阅实体具体要求见0

py

,

10subscritionQuerCondEntit服务订阅查询条件实体具体要求见1

pyy

,

11subscritionNotifierEntit服务订阅通知方式实体具体要求见2

py

,

12subscritionNotifierQuerCondEntit服务订阅通知方式查询条件实体具体要求见3

pyy

,

13findService服务检索查询输入类具体要求见4

,

14findServiceResult服务检索查询输出类具体要求见5

,

15findSubscrition服务订阅查询输入类具体要求见6

p

,

16findSubscritionResult服务订阅查询输出类具体要求见7

p

,

17saveSubscrition服务订阅提交及修改输入类具体要求见8

p

ㅤㅤㅤㅤ,

18saveSubscritionResult服务订阅提交及修改输出类具体要求见9

p

,

19findSubscritionNotifier服务订阅通知方式查询输入类具体要求见0

p

,

20findSubscritionNotifierResult服务订阅通知方式查询输出类具体要求见1

p

,

21saveSubscritionNotifier服务订阅通知方式提交及修改输入类具体要求见2

p

,

22saveSubscritionNotifierResult服务订阅通知方式提交及修改输出类具体要求见3

p

<>选定的服务列表

23listserviceEntit

y

<>选定的服务附件列表

24listserviceAttachmentEntit

y

<>选定的代理服务列表

25listserviceProxEntit

yy

<>选定的服务订阅内容列表

26listsubscritionEntit

py

<>选定的服务订阅通知方式列表

27listsubscritionNotifierEntit

py

安全验证实体

,。

用于封装安全验证信息内容见表2

表2安全验证实体的内容

序号名称标识类型说明备注

1用户名userIDstring用户的标识符

2密码passwordstring用户的密码

2

/—

GAT1038.22012

服务责任人实体

,。

用于封装服务责任人信息内容见表3

表3服务责任人实体的内容

序号名称标识类型说明备注

1责任人personNamestring责任人姓名

2电话phonestring电话号码

3Emailemailstring邮件地址

服务附件实体

,。

用于封装服务附件内容见表4

表4服务附件实体的内容

序号名称标识类型说明备注

1文件名fileNamestring

2文件类型fileTestrin

ypg

3文件扩展名fileExtstring

ㅤㅤㅤㅤ

4绝对路径absolutePathstring

5相对路径relativePathstring

6文件内容fileContentboolean采用base64Binar转换方式

y

代理服务实体

,。

用于封装代理服务参数见表5

表5代理服务实体参数

序号名称标识类型说明备注

1代理服务IDserviceIDstring代理服务的ID

2访问地址accessPointstring代理服务的WSDL地址

3认证方式authMethodstring见4.2.2的认证方式

4是否启用SSLuseSSLboolean调用代理时是否采用SSL传输

5服务状态serviceStatusstring代理服务的状态见4.2.2的服务状态

服务实体

,。

用于封装服务信息内容见表6

3

/—

GAT1038.22012

表6服务实体的内容

序号名称标识类型说明备注

1删除标志delFlastrin见4.2.2的删除标志不能为空

gg

2服务IDserviceIDstring服务的唯一标识采用UUID

,

名称要求唯一不

3服务名serviceNamestring服务的名称

能为空

4服务版本serviceVersionInt服务版本信息

5技术类型technicalTestrin见4.2.2的技术类型不能为空

ypg

6业务类型businessTestrin见4.2.2的业务类型不能为空

ypg

7发布类型serviceNaturestring见4.2.2的发布类型不能为空

8访问类型serviceOwnershistrin见4.2.2的访问类型不能为空

pg

9服务级别serviceLevelstring服务的优先级别

服务归属的应用系

10所属系统businessSstemstrin不能为空

yg

统标识

11组织机构oranizationstrin所属组织机构不能为空

gg

,

调用代理时的认证不能为空见4.2.2

12认证方式authMethodstring

方式的认证方式

调用代理时是否采

13是否启用SSLuseSSLBoolean