系统对接设计对接方式系统与外部系统的对接方式以 web service方式进行系统接口标准:本系统采用SOA体系架构,通过服务总线技术实现数据交换以及实现各业务子系统间、外部业务系统之间的信息共享和集成,因此 SOA体系标准就是我们采用的接口核心标准主要包括:服务目录标准:服务目录 API接口格式参考国家以及关于服务目录的元数据指导规范,对于 W3C UDDI v2 API结构规范,采取 UDDI v2的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 EJB实现新的业务服务, 根据需求提供 SOAP/HTTP or JMS and RMI/IIOF接 口。
业务流程标准:使用没有扩展的标准的 BPEL4WS对于业务流程以SOAP服务形式进行 访问,业务流程之间的调用通过 SOAR数据交换安全:与外部系统对接需考虑外部访问的安全性,通过 IP白名单、SSL认证等方式保证集成互访的合法性与安全性数据交换标准:制定适合双方系统统一的数据交换数据标准, 支持对增量的数据自动进行数据同步,避免人工重复录入的工作接口规范性设计系统平台中的接口众多,依赖关系复杂,通过接口交换的数据与接口调用必须遵循统一的接口模型进行设计接口模型除了遵循工程统一的数据标准和接口 规范标准,实现接口规范定义的功能外,需要从数据管理、完整性管理、接口安 全、接口的访问效率、性能以及可扩展性多个方面设计接口规格1. 1.2, 1接口定义约定客户端与系统平台以及系统平台间的接口消息协议采用基于 HTTP协议的REST风格接口实现,协议栈如图4-2所示业务消息会话数据HTTP/HTTPSTCP/IP底层承载图表 错误!文档中没有指定样式的文字1接口消息协议栈示意图系统在http协议中传输的应用数据采用具有自解释、自包含特征的JSON数 据格式,通过配置数据对象的序列化和反序列化的实现组件来实现通信数据包的 编码和解码。
在接口协议中,包含接口的版本信息,通过协议版本约束服务功能规范, 支 持服务平台间接口协作的升级和扩展一个服务提供者可通过版本区别同时支持 多个版本的客户端,从而使得组件服务的提供者和使用者根据实际的需要, 独立演进,降低系统升级的复杂度,保证系统具备灵活的扩展和持续演进的能力L 1.2,2业务消息约定请求消息URI中的参数采用UTF-8编码并经过URLEncode编码请求接口 URL格式:{http|https}://{host}:{port}/{app n ame}/{bus in ess comp onent n ame}/{acti on} ; 其中:?协议:HTTP RES■形式接口 ? host :应用支撑平台交互通信服务的IP地址或域名? port :应用支撑平台交互通信服务的端口? app name:应用支撑平台交互通信服务部署的应用名称? bus in ess comp onent n ame :业务组件名称? action :业务操作请求的接口名称,接口名字可配置应答的消息体采用JSON数据格式编码,字符编码采用 UTF-8应答消息根节点为“response ”,每个响应包含固定的两个属性节点:“ status 和“message'。
它们分别表示操作的返回值和返回消息描述, 其他的同级子节点 为业务返回对象属性,根据业务类型的不同,有不同的属性名称当客户端支持数据压缩传输时,需要在请求的消息头的“Accept-Encoding ” 字段中指定压缩方式(gzip),如消息可以被压缩传输则平台将应答的数据报文进 行压缩作为应答数据返回,Con te nt-Le ngth 为压缩后的数据长度详细参见 HTTP/1.1 RFC2616Ll.2,3响应码规则约定响应结果码在响应消息的“status ”属性中,相应的解释信息在响应消息的 “message属性中解释消息为终端用户可读的消息,终端应用不需要解析可 直接呈现给最终用户响应结果码为6位数字串根据响应类型,包括以下几类 响应码如表4-1中的定义表4-1响应码对应表响应码描述0成功1XXXXX系统错误2XXXXX输入参数不合法错误3XXXXX应用级返回码,定义应用级的异常返回4XXXXX正常的应用级返回码,定义特定场景的应用级返回说明1- 1-2.4数据管理m |业务数据检查接口应提供业务数据检查功能,即对接收的数据进行合法性检查,对非法数。