2024年4月1日发(作者：)

系统对接设计

1.1.1

对接方式

系统与外部系统的对接方式以webservice方式进行.

系统接口标准：

本系统采用SOA体系架构,通过服务总线技术实现数据交换以及实现各业务子系统

间、外部业务系统之间的信息共享和集成,因此SOA体系标准就是我们采用的接口核心

标准.主要包括：

服务目录标准：服务目录API接口格式参考国家以及服务目录的元数据指导规范,

对于W3CUDDIv2API结构规范,采取UDDIv2的API的模型,定义UDDI的查询和发布服务

接口,定制基于Java和SOAP的访问接口.除了基于SOAP1.2的WebService接口方式,

对于基于消息的接口采用JMS或者MQ的方式.

交换标准：基于服务的交换,采用HTTP/HTTPS作为传输协议,而其消息体存放基于

SOAP1.2协议的SOAP消息格式.SOAP的消息体包括服务数据以及服务操作,服务数据和

服务操作采用WSDL进行描述.

Web服务标准：用WSDL描述业务服务,将WSDL发布到UDDI用以设计/创建服

务,SOAP/HTTP服务遵循WS-IBasicProfile1.0,利用J2EESessionEJBs实现新的业务服

务,根据需求提供SOAP/HTTPorJMSandRMI/IIOP接口.

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

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

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

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

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

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

1.1.2

接口规范性设计

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

的接口模型进行设计.接口模型除了遵循工程统一的数据标准和接口规范标准,实现接口规

范定义的功能外,需要从数据管理、完整性管理、接口安全、接口的访问效率、性能以及可

扩展性多个方面设计接口规格.

1.1.2.1

接口定义约定

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

口实现,协议栈如图4-2所示.

图表-接口消息协议栈示意图

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

过配置数据对象的序列化和反序列化的实现组件来实现通信数据包的编码和解码.

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

间接口协作的升级和扩展.一个服务提供者可通过版本区别同时支持多个版本的客户端,从

而使得组件服务的提供者和使用者根据实际的需要,独立演进,降低系统升级的复杂度,保