智慧城市公共信息平台附件七：接口与服务要求

1、word附件七智慧城市公共信息平台平台接口与服务要求试 行中华人民某某国住房和城乡建设部建筑节能与科技司二一三年三月 / 目次1 X围12 规X性引用文件23 术语与定义34 接口服务概述54.1 接口服务组成54.2 接口技术要求65 总体要求75.1 消息结构75.1.1 请求报文X例75.1.2 响应报文X例75.2 接口方式75.3 接口地址85.4 使用说明86 业务接口要求106.1 根底接口要求106.1.1 目录服务初始化106.1.2 目录服务终止116.1.3 认证授权126.2 发现接口要求136.2.1 资源目录检索136.2.2 资源目录检索结果提取156.3 资源服务接口要求176.3.1 资源内容检索176.3.2 资源内容检索结果提取186.4 管理接口要求206.4.1 目录资源元数据管理20附录A 要求所涉与的结构表23表A.1 databaseList组成23表A.2 服务功能列表23表A.3 elementSetName结果集属性24表A.4 opResult属性表24表A.5 singleRecord参数表24表A.6 元数据管理类型定义24表

2、A.7 核心元数据属性集25表A.8 关系运算符属性集27表A.9 位置运算符属性集27表A.10 资源自描述Result属性集27附录B QUERY-RES-DATA说明30B.1 dataQuery资源检索申请结构31B.1.1 结构化资源检索申请结构31B.1.2 非结构化资源申请结构32B.2 资源检索结果提取结构33B.2.1 结构化资源singleRecordX例33B.2.1 非结构化资源singleRecordX例34附录C 平台接口要求SCHEMA36附录D QUERY-RPNX例65D.1 示例一65D.2 示例二65附录E 资源目录X例68E.1 资源目录要求SCHEMA68E.2 结构化资源目录模板89E.3 非结构化资源目录模板981 X围l 本要求是智慧城市公共信息平台建设指南建设要求系列之接口与服务要求。l 本局部要求分两大局部描述平台接口要求，第一局部：总体要求，总体要求描述消息的总体结构、接口访问方、接口地址、使用说明。第二局部：业务接口要求，具体描述每个业务应用服务接口的要求。也就是每一个业务接口要求套在总体要求内。只有使用业务接口要求+总体要求才能

3、正常使用信息平台的应用服务来发现，查询，管理资源。l 本局部适用于参与公共信息平台设计和研发人员，系统维护人员与要求接入公共信息平台的外部应用的开发人员。2 规X性引用文件如下文件中的条款通过本局部的引用而成为本局部的条款。但凡注日期的引用文件，其随后所有的修改单不包括勘误的内容或修订版均不适用于本局部，鼓励根据本局部达成协议的各方研究是否可使用这些文件的最新版本。但凡不注日期的引用文件，其最新版本适用于本局部。GB/T 21063.1-2007 政务信息资源目录体系 第1局部：总体框架；GB/T 21063.2-2007 政务信息资源目录体系 第2局部：技术要求；GB/T 21063.3-2007 政务信息资源目录体系 第3局部：核心元数据；GB/T 21063.4-2007 政务信息资源目录体系 第4局部： 政务信息资源分类；GB/T 21063.5-2007 政务信息资源目录体系 第5局部：政务信息资源标识符编码方案； 本文 引用GB/T 21063.2-2007中的附录A 目录服务接口； 本文引用GB/T 21063.2-2007中的附录A 目录服务接口，与引用GB/T 210

4、63.2-2007中的附录C 政务信息资源目录服务属性集 本文引用 GB/T 21063.2-2007中的附录F 检索串示例9.3 术语与定义GB/T 19710-2005中规定的与以下术语和定义适用于本局部。l 目录针对拥有共性的数据资源/文件资源进展分类，并且为该分类赋予唯一的资源标识符，该局部分类与分类描述的集合统称为资源目录，简称目录。l 结构化资源公共信息平台共享的二维库表结构数据，统称为结构化资源。l 非结构化资源公共信息平台共享的非二维库表结构数据，例如：文本文件、视频、网络访问资源等统称为非结构化资源。l 数据交换管理者管理信息资源结点的机构。l 交换内容提供者提供信息资源交换内容的机构。l 交换内容使用者使用信息资源交换内容的机构。l 前置环境应用单位接入端系统软硬件与相关网络环境组成的应用单位前置系统的单元环境。l 目录交换按订阅模式进展目录资源数据的交换；l 桥接系统业务数据库与共享数据库的桥接器，保持交换数据库与共享数据库的同步；l 变更捕捉捕捉数据资源变更情况。l 数据转入以固定间隔时间轮询变更登记表，读取其中的记录，并将这些记录以约定的格式组成XML报文，存

5、储到共享库的换出表中；非结构化数据文件直接通过文件服务传输至交换中心文件服务器，并有中心分发非结构化数据文件。l 数据交换路由以固定时间间隔轮询应用单位换入表，拆解XML报文，根据目标库自动分拣；非结构化数据文件直接通过文件服务传输至交换中心文件服务器，并有中心分发非结构化数据文件。l 数据转出独立运行的进程，以固定间隔时间轮询交换库中的换入表，读取其中的XML报文，并将数据按定制的格式同步到共享库中。非结构化数据文件描述信息存储在信息队列中，由各服务器根据队列信息分别从中心文件服务器获取所需数据文件。l 交换管理程序完成数据交换审批流程、交换监控、交换调度、系统管理等功能一套程序，部署于中心。l Web服务基于webservice技术开放的服务接口，采用约定的XML作为交易数据接口，提供给客户端调用。l WSDLWeb服务描述文件，一个用来描述Web服务和说明如何与Web服务通信的XML语言。为用户提供详细的接口说明。l 访问认证公共信息平台提供用户认证服务，由托管应用系统的客户端调用，用于验证用户是否合法；l 应用单位接入公共信息平台的机构单位。l 主管单位公共信息平台的管理单位。

6、l 数据中心公共信息平台的组成局部，是公共信息平台数据与应用系统数据存储的地方。4 接口服务概述4.1 接口服务组成信息资源目录服务包含三种接口，即信息资源根底服务接口、资源服务接口(发现接口、资源接口)、信息资源管理服务接口。其中，根底接口是将资源服务接口和管理接口中根底性的操作定义成一个公共接口。这3类接口实现了信息资源的发现功能、检索功能和管理功能。根底接口：提供会话管理功能和服务自描述功能，包含有目录服务初始化接口、目录服务终止接口和服务自描述接口。发现接口：提供信息资源元数据检索功能和信息资源元数据检索结果提取功能，包含有目录检索接口以与目录检索结果提取接口。这些接口本身并不提供资源，而是提供资源根本信息和如何去获得这些资源的元数据。资源接口：根据发现接口获得信息资源元数据，定位、查找资源具体内容的接口，包含资源内容检索接口与资源内容结果提取接口。管理接口：提供元数据管理的功能，包含信息资源元数据管理接口。城市公共信息平台接口服务组成见图1.图1. 城市公共信息平台接口服务组成图4.2 接口技术要求a) 提供基于SOAP协议的web服务接口b) 支持跨语言、跨操作系统调用5

7、总体要求5.1 消息结构每个交易消息(包括请求和应答)有一个是名字Message Name，交易消息以XML格式表达的，根据XML的定义，每个XML文件需要有特定的Root Tag根标记，在本要求中，用交易名称+请求类别作为根节点，如初始化接口的请求包根节点为initRequest，而响应包的根节点为initResponse。根节点下之间放业务接口数据。5. 请求报文X例5.1.2 响应报文X例5.2 接口方式接口采用WebService方式，接口协议使用SOAP协议，提供标准的WSDL文件。5.3 接口地址公共信息目录服务以下简称目录服务主要有三个wsdl地址，不同的wsdl下有不同的方法，下文有说明。这是根据webservice的soap协议开放出来的wsdl地址，第三方应用可以根据实际的部署的服务器地址来使用它。1) 根底接口WSDL文件地址：:/:/es/catalogbase?wsdll 目录服务初始化 initCatalogServicel 目录服务终止 stopCatalogService2) 发现接口WSDL文件地址：:/:/es/digcatalog?wsdll 目录

8、检索 queryCatalogListl 目录检索结果提取 queryCatalogResult3) 资源服务接口：:/:/es/digresource?wsdll 资源检索 getResourceResultsetl 资源检索结果提取 getResourceResultDetail4) 发现接口WSDL文件地址：:/:/es/digcatalog?wsdll 资源元数据管理 metadataManage5.4 使用说明完成资源的检索与发现需要根据以下步骤来操作完成：1) 第一步：初始化操作。调用根底接口的“目录服务初始化获得一个会 话标识符以后每次调用接口都需要次标识符。2) 第二步：查询公共信息目录操作。调用发现接口的“目录检索组织好查询参数，发起交易，获得查询结果。注：这里的查询结果只有返回命中的查询记录数。比如：返回值是100，那么表示有100条记录符合查询条件，这个时候需要发起“公共信息目录检索结果提取交易才能提取查询的结果。如果发回值是0，表示没有符合查询条件的记录。3) 第三步：查询公共信息目录对应的资源。这里的操作也是和上面一样，调用“资源检索先要查询下是否有符合查询条件的资源。有资源记录的话，然后在调用“资源检索结果提取提取符合条件的资源信息。4) 第四步：假设调用接口完毕后，可调用根底接口里的“目录服务终止来释放会话标识符资源信息。6 业务接口要求6.1 根底接口要求6.1.1 目录服务初始化公共信息目录服务初始化用于建立客户端与服务端的会话，所有其他服务都必须依赖会话。会话的持续时间为30分钟，假设会话持续30分钟没有活动，如

《智慧城市公共信息平台附件七：接口与服务要求》由会员re****.1分享，可在线阅读，更多相关《智慧城市公共信息平台附件七：接口与服务要求》请在金锄头文库上搜索。