admin 管理员组

文章数量: 1184232


2024年3月22日发(作者:scroll翻译)

系统对接设计

1.1.1对接方式

系统与外部系统的对接方式以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 EJBs实现新的业务服

务,根据需求提供SOAP/HTTP or JMS and RMI/IIOP接口。

业务流程标准:使用没有扩展的标准的BPEL4WS,对于业务流程以SOAP服务形

式进行访问,业务流程之间的调用通过SOAP。

数据交换安全:与外部系统对接需考虑外部访问的安全性,通过IP白名单、SSL

认证等方式保证集成互访的合法性与安全性。

数据交换标准:制定适合双方系统统一的数据交换数据标准,支持对增量的数据

自动进行数据同步,避免人工重复录入的工作。

1.1.2接口规范性设计

系统平台中的接口众多,依赖关系复杂,通过接口交换的数据与接口调用

必须遵循统一的接口模型进行设计。接口模型除了遵循工程统一的数据标准和

接口规范标准,实现接口规范定义的功能外,需要从数据管理、完整性管理、

接口安全、接口的访问效率、性能以及可扩展性多个方面设计接口规格。

1.1.2.1接口定义约定

客户端与系统平台以及系统平台间的接口消息协议采用基于HTTP协议的

REST风格接口实现,协议栈如图4-2所示。

业务消息

会话数据

HTTP/

HTTPS

TCP/IP

底层承载

图表Error! No text of specified style in document.-2接口消息协议

栈示意图

系统在http协议中传输的应用数据采用具有自解释、自包含特征的JSON

数据格式,通过配置数据对象的序列化和反序列化的实现组件来实现通信数据

包的编码和解码。

在接口协议中,包含接口的版本信息,通过协议版本约束服务功能规范,

支持服务平台间接口协作的升级和扩展。一个服务提供者可通过版本区别同时

支持多个版本的客户端,从而使得组件服务的提供者和使用者根据实际的需要,

独立演进,降低系统升级的复杂度,保证系统具备灵活的扩展和持续演进的能

力。

1.1.2.2业务消息约定

请求消息URI中的参数采用UTF-8编码并经过URLEncode编码。


本文标签: 接口 服务 数据