系统对接方案及系统对接接口设计.docx

系统对接设计 1.1.1 对接方式 系统与外部系统的对接方式以web service 方式进行。 系统接口标准： 本系统采用SOA 体系架构，通过服务总线技术实现数据交换以及实现各 业务子系统间、外部业务系统之间的信息共享和集成，因此SOA 体系标准 就是我们采用的接口核心标准。主要包括： 服务目录标准：服务目录API 接口格式参考国家以及关于服务目录的元 数据指导规范，对于W3CUDDIv2API 结构规范，采取UDDIv2 的 API 的 模型，定义UDDI 的查询和发布服务接口，定制基于Java和SOAP 的访问接 口。除了基于SOAP1.2 的Web Service接口方式，对于基于消息的接口采用JMS 或者MQ 的方式。 交换标准：基于服务的交换，采用HTTP/HTTPS 作为传输协议，而其消 息体存放基于SOAP1.2 协议的SOAP 消息格式。 SOAP 的消息体包括服务数 据以及服务操作，服务数据和服务操作采用WSDL 进行描述。 Web 服务标准：用WSDL 描述业务服务，将WSDL 发布到UDDI 用以设 计/创建服务， SOAP/HTTP 服务遵循 WS-I Basic Profile 1.0, 利 用J2EE Session EJBs实现新的业务服务，根据需求提供SOAP/HTTP or JMS and RMI/IOP 接口。 业务流程标准：使用没有扩展的标准的BPEL4WS, 对于业务流程以SOAP 服务形式进行访问，业务流程之间的调用通过SOAP。 原创力文档 下 载 原创力文档 下 载 高 清 无 水 印 单、SSL 认证等方式保证集成互访的合法性与安全性。 数据交换标准：制定适合双方系统统一的数据交换数据标准，支持对增 量的数据自动进行数据同步，避免人工重复录入的工作。 1.1.2接口规范性设计 系统平台中的接口众多，依赖关系复杂，通过接口交换的数据与接口调用必须遵循统 一的接口模型进行设计。接口模型除了遵循工程统一的数据标准和接口规范标准，实现接口 规范定义的功能外，需要从数据管理、完整性管理、接口安全、接口的访问效率、性能以及 可扩展性多个方面设计接口规格。 接口定义约定 客户端与系统平台以及系统平台间的接口消息协议采用基于HTTP 协议的REST 风格 接口实现，协议栈如图4-2所示。 业务消息 业务消息 会话数据 HTTP/ HTTPS TCP/IP 底层承载 图表1-接口消息协议栈示意图 系统在http协议中传输的应用数据采用具有自解释、自包含特征的JSON 数据格式， 通过配置数据对象的序列化和反序列化的实现组件来实现通信数据包的编码和解码。 在接口协议中，包含接口的版本信息，通过协议版本约束服务功能规范，支持服务平 台间接口协作的升级和扩展。 一个服务提供者可通过版本区别同时支持多个版本的客户端， 从而使得组件服务的提供者和使用者根据实际的需要，独立演进，降低系统升级的复杂度， 保证系统具备灵活的扩展和持续演进的能力。 业务消息约定 请求消息URI 中的参数采用UTF-8 编码并经过URLEncode 编码。 请求接口URL 格式：{htp|https}://{host):{port}/ {app name}/{business component name}/{action}; 其中： √ 协议： HTTP REST形式接口 √ host: 应用支撑平台交互通信服务的IP 地址或域名 √ port: 应用支撑平台交互通信服务的端口 √ app name: 应用支撑平台交互通信服务部署的应用名称 √ business component name: 业务组件名称 √ action: 业务操作请求的接口名称，接口名字可配置 应答的消息体采用JSON 数据格式编码，字符编码采用UTF-8。 应答消息根节点为"response",每个响应包含固定的两个属性节点： “status”和 "message"。 它们分别表示操作的返回值和返回消息描述，其他的同级子节点为业务返回对 象属性，根据业务类型的不同，有不同的属性名称。 当客户端支持数据压缩传输时，需要在请求的消息头的 “Accept-Encoding”字段中指 定压缩方式(gzip),如消息可以被压缩传输则平台将应答的数据报文进行压缩作为应答数据 返回，Content-Length为压缩后的数据长度。详细参见HTTP/1.1 RFC2616。 响应码规则约定 响应结果码在响应消息的“status”属性中，相应的解释信息在响应消息的 “message” 属性中。解释消息为终端用户可读的消息，终端应用不需要解析可直接呈现给最终用户。响 应结果码为6位数字串。根据响应类型，包括以下几类响应