某某房产项交换系统的接口规范.docVIP

文档编号： WHFC-JZTSJ-JKGF-031215 版本号： V1.0 正本 ××市房产管理局电子政务系统项目 数据交换系统的接口规范 （V1.0） 二零零八年十二月 目 录 ××市房产管理局电子政务系统项目 1 数据交换系统的接口规范 1 数据交换接口规范 3 一、 制定数据交换接口规范的目的 3 二、数据交换的接口消息规范与交换控制协议 3 2.1数据交换协议 3 2.2 消息规范 6 2.2.1交换控制信息 6 2.2.2业务请求信息 8 2.2.3处理状态信息 8 2.2.4业务结果信息 9 2.2.5综合结果信息 9 三、数据交换过程中消息的通讯承载协议 9 四、客户层业务系统访问数据交换系统接口的技术要求 9 五、数据交换的代码体系 10 5.1 消息类型代码表 11 5.2 服务类型代码表 11 5.3 请求方/服务方单位代码 11 5.4 交换状态代码表 12 5.5 结果情况代码表 12 数据交换接口规范 制定数据交换接口规范的目的 由于××房产局电子政务系统的业务需求中，各个分散的C/S业务系统需要进行跨局的服务访问和数据交换，数据交换系统与业务管理系统之间存在互动关系，这就要求业务系统与数据交换系统之间的交互过程采用统一规范，完成系统的服务互访和信息传递。在总体设计报告中，我们已经确定了采用Webservices技术标准的远程访问机制，基于此，为了满足××房产局电子政务系统设计的需要，还须定义如下内容： 数据交换协议； 消息规范； XML消息的通讯承载协议； 语义代码表。 制定这些规范的目的，在于明确业务系统与数据交换系统之间是采用何种方式、何种信息进行服务访问和数据传递的。下一章开始我们就此问题进行阐述。 二、数据交换的接口消息规范与交换控制协议 2.1数据交换协议 在××房产管理局电子政务系统中，涉及到数据交换的通讯实体可分为远程客户层、数据交换层、远程服务层三个层次。 a．远程客户层中的实体：一般是业务系统，负责向数据交换层实体提交业务请求； b．数据交换层中实体：一般是完成交换控制的数据交换系统，即接收远程客户层 的业务请求并按照路由规则向远程服务层实体转发，接收远程服务层的处理结果并 将其返回给提交业务请求的远程客户层实体。 c．远程服务层中的实体：提供业务服务的远程服务系统。 我们首先用活动图来描述一下数据交换过程中各系统的处理内容与消息交换内容： 下面，我们用时序图描述一下消息传递的时序过程（下面的各种消息，在网络通讯过程中都是采用符合XML国际标准的格式）： 远程客户层实体向数据层实体提交如下消息，是由两部分信息构成的二元组： a. 交换控制信息 , 业务请求信息 根据交换层实体接收远程客户层提交来的业务请求消息，进行语法语义检查和权限验证、获取服务访问信息、执行服务等路由控制处理。如果确认不能向远程服务层提交业务请求信息，则向远程客户层实体返回如下消息： b. 综合结果信息 = 处理状态信息 + (Null) 业务结果信息 如果该业务的远程服务层实体不会向数据交换层返回任何信息，则数据交换层 实体则将如下消息返回给客户层： c. 综合结果信息 = 处理状态信息 否则，继续执行； 数据交换层实体向远程服务层提交如下信息： d. 业务请求信息 远程服务层实体接收数据交换层发送的业务请求消息，并进行合并处理后得到业务结果；然后，分两种情况进行， A: 某些业务的远程服务层向数据交换层返回如下信息： e. 业务结果信息； 则数据交换层实体对接收到的业务结果信息进行合并处理后，数据交换层实体构造如下返回消息，并返回给远程客户层实体： f. 综合结果消息 = 处理状态信息 + 业务结果信息 B: 某些业务远程服务层不会向数据交换层返回任何信息。数据交换层实体则 将如下消息返回给客户层： g. 综合结果信息 = 处理状态信息 上述通讯过程与相关处理如下图所示： 2.2 消息规范 数据交换的接口消息规范用于描述在数据交换过程中,远程客户层实体为了得到所需服务，需要根据具体的服务需求来向交换系统提交特定信息结构和内容；交换层实体则对客户层发来的信息进行分析，并将特定业务请求信息发送给远程服务层实体处理。同样，远程客户层实体向客户层实体反馈的结果信息。 在通讯中我们采用统一的符合国际标准的XML消息格式，而对于客户层实体与服务层实体的设计开发，则需要了解在进行XML封装之前采用的信息结构，这里我们约定采用标准的Java语言进行描述。 2.2.1交换控制信息 交换控制信息由远程客户层实体生成，并提交给系统用于权限验证、语法语义检查、路由控制、会话管理等功能。其消息数据报的结构和数据元素类型定义如下： 消息类型 代码 业务类型 代码 请求方单位 代码 服务方单位 代码 用户 I