ICS 35.240 06 V GA 中华人民共和国公共安全行业标准 GA/T 1038.2—2012 消防公共服务平台技术规范 第2部分：服务管理接口 Technical specifications for the public fire service platform- Part 2:Service management interfaces 2012-12-27发布 2013-01-01实施 中华人民共和国公安部 发布 GA/T 1038.2-2012 GA/T1038《消防公共服务平台技术规范》拟分部分出版，各部分将按照在消防公共服务平台的作 用确立。下面列出本标准的预计部分： 一第1部分：总体架构及功能要求 ——第2部分：服务管理接口； 一第3部分：信息交换接口； 一第4部分：消防综合业务接口； 一第5部分：地理信息服务接口。 本部分为GA/T1038的第2部分。 本部分按照GB/T1.1一2009给出的规则起草。 本部分由公安部消防局提出。 本部分由公安部计算机与信息处理标准化技术委员会归口。 本部分起草单位：公安部沈阳消防研究所。 本部分主要起草人：张春华、傅永财、朱春玲、姜学赞、王佩青、吕建波、梁云杰、曾颖。 I GA/T1038.2—2012 消防公共服务平台技术规范 第2部分：服务管理接口 1范围 GA/T1038的本部分规定了消防公共服务平台中服务管理平台（以下简称平台）对应用实体提供 的软件接口（以下简称接口功能及参数。 本部分适用于服务管理平台，以及需使用服务管理平台进行服务注册发布和服务查询调用的应用 实体的开发和应用。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GA/T1038.1一2012消防公共服务平台技术规范第1部分：总体架构及功能要求 3术语、定义和缩略语 GA/T1038.1一2012界定的术语、定义和缩略语适用于本文件。 4平台接口 4.1接口功能 服务管理平台提供服务注册发布和服务检索查询两类接口，接口的功能如下： a) 服务注册发布接口：提供服务注册发布及修改、服务订阅提交及修改、服务订阅通知方式提交 及修改等功能； b）服务检索查询接口：提供服务查询、服务订阅查询和服务订阅通知方式查询等功能。 4.2接口参数 4.2.1类的定义 4.2.1.1类名称和说明 平台接口使用的自定义类名称和说明见表1。 表1类名称和说明 序号 类名称 说明 authInfoEntity 1 安全验证实体，具体要求见4.2.1.2 2 personInChargeEntity 服务责任人实体，具体要求见4.2.1.3 3 serviceAttachmentEntity 服务附件实体，具体要求见4.2.1.4 A GA/T1038.2—2012 表1(续) 类名称 说 明 4 serviceProxyEntity 代理服务实体，具体要求见4.2.1.5 serviceEntity 服务实体，具体要求见4.2.1.6 5 6 saveService 服务注册发布及修改输人类，具体要求见4.2.1.7 7 saveServiceResult 服务注册发布及修改输出类，具体要求见4.2.1.8 serviceQueryCondEntity 服务查询条件实体，具体要求见4.2.1.9 t subscriptionEntity 服务订阅实体，具体要求见4.2.1.10 10 subscriptionQueryCondEntity 服务订阅查询条件实体，具体要求见4.2.1.11 11 subscriptionNotifierEntity 服务订阅通知方式实体，具体要求见4.2.1.12 12 subscriptionNotifierQueryCondEntity 服务订阅通知方式查询条件实体，具体要求见4.2.1.13 13 findService 服务检索查询输人类，具体要求见4.2.1.14 14 findServiceResult 服务检索查询输出类，具体要求见4.2.1.15 15 findSubscription 服务订阅查询输人类，具体要求见4.2.1.16 16 findSubscriptionResult 服务订阅查询输出类，具体要求见4.2.1.17 17 saveSubscription 服务订阅提交及修改输入类，具体要求见4.2.1.18 18 saveSubscriptionResult 服务订阅提交及修改输出类，具体要求见4.2.1.19 19 findSubscriptionNotifier 服务订阅通知方式查询输入类，具体要求见4.2.1.20 20 findSubscriptionNotifierResult 服务订阅通知方式查询输出类，具体要求见4.2.1.21 21 saveSubscriptionNotifier 服务订阅通知方式提交及修改输入类，具体要求见4.2.1.22 22 saveSubscriptionNotifierResult 服务订阅通知方式提交及修改输出类，具体要求见4.2.1.23 23 list(serviceEntity) 选定的服务列表 24 list(serviceAttachmentEntity) 选定的服务附件列表 25 list( serviceProxyEntity) 选定的代理服务列表 26 list<subscriptionEntity> 选定的服务订阅内容列表 list(subscriptionNotifierEntity) 选定的服务订阅通知方式列表 4.2.1.2 安全验证实体 用于封装安全验证信息，内容见表2。 表2 安全验证实体的内容 序号 名称 标识 类型 说明 备注 1 用户名 userID string 用户的标识符 2 密码 password string 用户的密码 2 GA/T1038.2—2012 4.2.1.3服务责任人实体 用于封装服务责任人信息，内容见表3。 表3服务责任人实体的内容 序号 名称 标识 类型 说明 备注 责任人 personName string 任人姓名 1 电话 phone string 电话号码 Email 3 email string 邮件地址 4.2.1.4 服务附件实体 用于封装服务附件，内容见表4。 表4服务附件实体的内容 序号 名称 标识 类型 说明 备注 文件名 1 fileName string fileType 2 文件类型 string 文件扩展名 fileExt string 4 绝对路径 absolutePath string 相对路径 string 5 relativePath 文件内容 fileContent boolean 6 采用base64Binary转换方式 4.2.1.5 代理服务实体 用于封装代理服务，参数见表5。 表5代理服务实体参数 序号 名称 标识 类型 说明 备注 string 代理服务ID servicelD 代理服务的ID 1 访间地址 accessPoint string 代理服务的WSDL地址 2 认证方式 authMethod string 见4.2.2的认证方式 3 是否启用SSL useSSL boolean 调用代理时是否采用SSL传输 服务状态 serviceStatus string 代理服务的状态 见4.2.2的服务状态 5 4.2.1.6 服务实体 用于封装服务信息，内容见表6。 GA/T1038.2—2012 表6服务实体的内容 名称 序号 标识 类型 说明 备注 删除标志 delFlag string 见4.2.2的删除标志 不能为空 1 serviceID string 服务的唯一标识 采用UUID 2 服务ID 名称要求唯一，不 服务名 3 serviceName string 服务的名称 能为空 服务版本信息 4 服务版本 serviceVersion Int 技术类型 technicalType 5 string 见4.2.2的技术类型 不能为空 6 业务类型 businessType string 见4.2.2的业务类型 不能为空 7 发布类型 serviceNa 见4.2.2的发布类型 不能为空 string 访问类型 见4.2.2的访间类型 不能为空 8 string string 9 服务级别 serviceLevel 服务的优先级别 服务归属的应用系 10 所属系统 snessSystem string 不能为空 统标识 不能为空 11 组织机构 organiza 所厨组织机构 iot string 调用代理时的认证 不能为空，见4.2.2 12 认证方式 authMetho 的认证方式 调用代理时是否采 13 是否启用SSL usesSL Boole 用SSL传锁 14 所属域 domain string 15 服务状 serviceSta 的服务状态 16 访间地址 服务的WSDL地址 accessPoit 不能为空 le：在服务管理平 台生成代理； 17 publishProxy 是否生成代理 Boolean False：只在服务管理 不能为空 平台注册，但不生成 代理 18 publisherCode 服务发布人代码 发布者代码 string 19 发布者 publisherName string 服务发布人姓名 20 服务责任人 personInCharge perso