基于ESB系统的服务接口规范全解
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
Webservice
4
Web service是一套标准，它定义了应用程序如何在Web上实现互操作性。可以使用任何语言，在任何平台上编写Web service。可以通过Web service标准对这些服务进行查询和访问。
ESB服务提供方
4
是指ESB服务接口的开发提供方，为调用方提供接口服务。
ESB服务调用方
5)
6)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
7)
8)关于请求编码详见“5.4 请求编码规范”章节；
AppID
应用编码
字符型
1)应用编码，即发起请求的应用系统的编码；
2)
3)关于应用编码详见“5.6 应用编码规范”章节；
HTTP Header：
相关标准：
服务提供者运行时需要使用SOAP报文与ESB进行交互，并遵循如下相关标准：
标准
版本
SOAP
SOAP1.1
WS-I
WS-I Basic Profile1.1
1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
yy
zzz5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
aaa
bbb6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
SOAP Header：
服务提供者返回结果时还需设置SOAP Header内容，具体如下：
ESB SAM
4
ESB软件资产管理模块，提供服务注册、服务查找、SLA管理等功能。
ESB SSM
4
ESB服务监控模块，提供ESB Server运行时数据的存储、分析能力，增强客户感知度。
ESB Console
4Hale Waihona Puke Baidu
ESB控制台，对独立和集群环境中的ESB Server进行管理，同时对于服务全生命周期进行管理。
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
AppID
应用编码
字符型
1)应用编码，即发起请求的应用系统的编码；
2)
3)关于应用编码详见“5.6 应用编码规范”章节；
SOAP Body：
10——
11——TDM：试验数据管理系统TestDataManagement
12——
13——RTX：腾讯通（企业实时通讯平台）Real Time eXpert
14——
15——AD：域活动目录Active Directory
16——
信息系统接口开发原则
5
信息系统之间的接口开发应采用ESB总线集成方式。
属性
名称
数据类型
说明
RequestID-BIZ
RequestID-ESB
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现SOAP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
ss
tt2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
uu
vv3)xsd - "http://www.w3.org/2001/XMLSchema"
ww
xx4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
请求报文的SOAP Body内容由具体的服务描述文件WSDL来定义。
响应报文规范
相关标准：
服务提供者运行时需要使用SOAP报文与ESB进行交互，并遵循如下相关标准：
kk标准
ll版本
mmSOAP
nnSOAP1.1
ooWS-I
ppWS-I Basic Profile1.1
qq
rr1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
基于ESB的
5
基于ESB的信息系统集成总体架构见下图。
架构模式图
ESB总线服务
5
基于ESB的信息系统服务接口工作原理见下图。
统一服务工作原理图
服务提供方负责处理本系统的业务逻辑，将业务处理进行封装，以webservice形式对外发布。
服务管理方负责将服务接口在ESB总线服务管理平台中进行集中管理。
服务调用方负责调用统一服务注册中心中的服务。
属性
名称
数据类型
说明
Version
版本
字符型
1)被调用服务操作的版本标识；
2)
3)关于版本编码详见“5.5 版本编码规范”章节；
RequestID-BIZ
1)
RequestID-ESB
请求编码
字符型
2)服务调用客户端提交的请求的唯一标识；
3)
4)应用系统和服务总线任何一方发现SOAP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
3——PLM：产品生命周期管理Product LifeCycle Management
4——
5——OA：办公自动化Office Automation
6——
7——HCM：人力资本管理系统HumanCapitalManagement
8——
9——ITSM：IT服务管理系统IT Service Management
备注：对于业务系统如何规划WSDL文件不在本规范讨论范围内。
请求报文规范
相关标准：
服务消费者[服务客户端]运行时需要使用SOAP报文与ESB上暴露的服务进行交互，需遵循如下相关标准：
s标准
t版本
uSOAP
vSOAP1.1
wWS-I
xWS-I Basic Profile1.1
y
zz1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
Q/TXN
南车株洲电机有限公司企业标准
Q/TXN**-***.*-2015
基于ESB系统的服务接口规范
2015-11–**发布
2015-11–**实施
南车株洲电机有限公司发布
前
本标准按照GB/T 1.1-2009给出的规则起草。
目前公司内部上线应用的系统较多（例如ERP、PDM、HCM、AD域等），各系统间接口集成技术不统一，交换信息格式差异大，接口集成欠缺规范化和标准化，在业务系统接口需求不断增加的情况下，系统集成更趋复杂化，将造成大量的系统开发及维护工作，也很难确保数据的一致性。因此，无论从管理或技术角度考虑，都必须建立公司的服务接口规范，从而按照规范要求进行现有系统集成接口的改造及统一管理，严格要求新的接口必须按照规范要求进行开发及管理，从而使各业务系统接口集成趋于规范化。
gg
hh5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
ii
jj6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
SOAP Header：
服务消费者[服务客户端]调用服务的还需设置SOAP Header内容，具体如下：
4
是指ESB服务接口的调用方，调用注册在ESB平台上的服务接口。
ESB服务管理方
4
是指ESB服务接口的集中管理方，负责ESB服务的注册、发布、监控等。
基于ESB的服务接口规范
5
核心业务系统范围
5
公司核心业务系统如下：
1——ERP：企业资源计划Enterprise Resource Planning
2——
SOAP Header
服务提供者返回结果时还需设置SOAP Header内容，具体如下：
属性
名称
数据类型
说明
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
aa
bb2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
cc
dd3)xsd - "http://www.w3.org/2001/XMLSchema"
ee
ff4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
HTTP Header：
服务提供者返回结果时还需设置HTTP Header内容，具体如下：
属性
名称
数据类型
说明
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现HTTP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
“服务调用方”和“服务提供方”是一对抽象的逻辑概念。对于一个具体的应用系统来说，它既可能是服务调用方，也可能是服务提供方，或者同时具备两种角色。
ESB服务规范
5
服务描述规范
服务描述规范主要说明接口服务的描述形式，服务使用者就可以根据服务描述了解服务的技术实现形式、功能和输入/输出等信息 。
业务系统向外暴露的服务和ESB向外暴露的服务都需要通过WSDL的方式进行描述，这样使得相关人员可以根据WSDL开发服务调用客户端，WSDL需遵循如下相关标准：
k
l3)xsd - "http://www.w3.org/2001/XMLSchema"
m
n4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
o
p5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
q
r6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
a标准
b版本
cWSDL
dWSDL1.1
eWS-I
fWS-I Basic Profile1.1
g
h1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
i
j2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
SOAP Body：
响应报文的SOAP Body内容由具体的服务描述文件WSDL来定义 。
确认报文规范
确认报文主要使用在异步调用场景，有请求报文的接受方向报文的发送方确认已经正确收到报文。
3)xsd - "http://www.w3.org/2001/XMLSchema"
4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
3
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
术语及定义
4
ESB
4
Enterprise Service Bus 企业服务总线
ESB SERVER
4
提供多协议的支持以及为服务运行提供了高性能、高可靠的运行环境和方便的扩展机制，为Primeton ESB 融入企业IT环境提供了有效支撑及管控手段，不依赖于J2EE容器的特性大大提升了性能。
服务消费者[服务客户端]调用服务的还需设置HTTP Header内容，具体如下：
属性
名称
数据类型
说明
Version
版本
字符型
1)被调用服务操作的版本标识；
2)
3)关于版本编码详见“5.5 版本编码规范”章节；
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现HTTP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
本标准由信息技术部提出。
本标准由技术中心（研究院）技术管理部归口。
本标准由信息技术部负责起草。
本标准主要起草人：何小红、王浩亮、张凯。
基于ESB
1
2
本规范规定了公司信息系统间数据交互的技术要求，确保信息系统间数据交互的安全与稳定。
本规范适用于株洲电机及其下属业务单元信息业务系统间数据的交互、共享。
规范性引用文件
4
Web service是一套标准，它定义了应用程序如何在Web上实现互操作性。可以使用任何语言，在任何平台上编写Web service。可以通过Web service标准对这些服务进行查询和访问。
ESB服务提供方
4
是指ESB服务接口的开发提供方，为调用方提供接口服务。
ESB服务调用方
5)
6)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
7)
8)关于请求编码详见“5.4 请求编码规范”章节；
AppID
应用编码
字符型
1)应用编码，即发起请求的应用系统的编码；
2)
3)关于应用编码详见“5.6 应用编码规范”章节；
HTTP Header：
相关标准：
服务提供者运行时需要使用SOAP报文与ESB进行交互，并遵循如下相关标准：
标准
版本
SOAP
SOAP1.1
WS-I
WS-I Basic Profile1.1
1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
yy
zzz5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
aaa
bbb6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
SOAP Header：
服务提供者返回结果时还需设置SOAP Header内容，具体如下：
ESB SAM
4
ESB软件资产管理模块，提供服务注册、服务查找、SLA管理等功能。
ESB SSM
4
ESB服务监控模块，提供ESB Server运行时数据的存储、分析能力，增强客户感知度。
ESB Console
4Hale Waihona Puke Baidu
ESB控制台，对独立和集群环境中的ESB Server进行管理，同时对于服务全生命周期进行管理。
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
AppID
应用编码
字符型
1)应用编码，即发起请求的应用系统的编码；
2)
3)关于应用编码详见“5.6 应用编码规范”章节；
SOAP Body：
10——
11——TDM：试验数据管理系统TestDataManagement
12——
13——RTX：腾讯通（企业实时通讯平台）Real Time eXpert
14——
15——AD：域活动目录Active Directory
16——
信息系统接口开发原则
5
信息系统之间的接口开发应采用ESB总线集成方式。
属性
名称
数据类型
说明
RequestID-BIZ
RequestID-ESB
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现SOAP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
ss
tt2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
uu
vv3)xsd - "http://www.w3.org/2001/XMLSchema"
ww
xx4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
请求报文的SOAP Body内容由具体的服务描述文件WSDL来定义。
响应报文规范
相关标准：
服务提供者运行时需要使用SOAP报文与ESB进行交互，并遵循如下相关标准：
kk标准
ll版本
mmSOAP
nnSOAP1.1
ooWS-I
ppWS-I Basic Profile1.1
rr1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
基于ESB的
5
基于ESB的信息系统集成总体架构见下图。
架构模式图
ESB总线服务
5
基于ESB的信息系统服务接口工作原理见下图。
统一服务工作原理图
服务提供方负责处理本系统的业务逻辑，将业务处理进行封装，以webservice形式对外发布。
服务管理方负责将服务接口在ESB总线服务管理平台中进行集中管理。
服务调用方负责调用统一服务注册中心中的服务。
属性
名称
数据类型
说明
Version
版本
字符型
1)被调用服务操作的版本标识；
2)
3)关于版本编码详见“5.5 版本编码规范”章节；
RequestID-BIZ
1)
RequestID-ESB
请求编码
字符型
2)服务调用客户端提交的请求的唯一标识；
3)
4)应用系统和服务总线任何一方发现SOAP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
3——PLM：产品生命周期管理Product LifeCycle Management
4——
5——OA：办公自动化Office Automation
6——
7——HCM：人力资本管理系统HumanCapitalManagement
8——
9——ITSM：IT服务管理系统IT Service Management
备注：对于业务系统如何规划WSDL文件不在本规范讨论范围内。
请求报文规范
相关标准：
服务消费者[服务客户端]运行时需要使用SOAP报文与ESB上暴露的服务进行交互，需遵循如下相关标准：
s标准
t版本
uSOAP
vSOAP1.1
wWS-I
xWS-I Basic Profile1.1
y
zz1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
Q/TXN
南车株洲电机有限公司企业标准
Q/TXN**-***.*-2015
基于ESB系统的服务接口规范
2015-11–**发布
2015-11–**实施
南车株洲电机有限公司发布
前
本标准按照GB/T 1.1-2009给出的规则起草。
目前公司内部上线应用的系统较多（例如ERP、PDM、HCM、AD域等），各系统间接口集成技术不统一，交换信息格式差异大，接口集成欠缺规范化和标准化，在业务系统接口需求不断增加的情况下，系统集成更趋复杂化，将造成大量的系统开发及维护工作，也很难确保数据的一致性。因此，无论从管理或技术角度考虑，都必须建立公司的服务接口规范，从而按照规范要求进行现有系统集成接口的改造及统一管理，严格要求新的接口必须按照规范要求进行开发及管理，从而使各业务系统接口集成趋于规范化。
gg
hh5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
ii
jj6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
SOAP Header：
服务消费者[服务客户端]调用服务的还需设置SOAP Header内容，具体如下：
4
是指ESB服务接口的调用方，调用注册在ESB平台上的服务接口。
ESB服务管理方
4
是指ESB服务接口的集中管理方，负责ESB服务的注册、发布、监控等。
基于ESB的服务接口规范
5
核心业务系统范围
5
公司核心业务系统如下：
1——ERP：企业资源计划Enterprise Resource Planning
2——
SOAP Header
服务提供者返回结果时还需设置SOAP Header内容，具体如下：
属性
名称
数据类型
说明
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
aa
bb2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
cc
dd3)xsd - "http://www.w3.org/2001/XMLSchema"
ee
ff4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
HTTP Header：
服务提供者返回结果时还需设置HTTP Header内容，具体如下：
属性
名称
数据类型
说明
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现HTTP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
“服务调用方”和“服务提供方”是一对抽象的逻辑概念。对于一个具体的应用系统来说，它既可能是服务调用方，也可能是服务提供方，或者同时具备两种角色。
ESB服务规范
5
服务描述规范
服务描述规范主要说明接口服务的描述形式，服务使用者就可以根据服务描述了解服务的技术实现形式、功能和输入/输出等信息 。
业务系统向外暴露的服务和ESB向外暴露的服务都需要通过WSDL的方式进行描述，这样使得相关人员可以根据WSDL开发服务调用客户端，WSDL需遵循如下相关标准：
k
l3)xsd - "http://www.w3.org/2001/XMLSchema"
m
n4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
o
p5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
q
r6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
a标准
b版本
cWSDL
dWSDL1.1
eWS-I
fWS-I Basic Profile1.1
g
h1)soap - "http://schemas.xmlsoap.org/soap/envelope/"
i
j2)xsi - "http://www.w3.org/2001/XMLSchema-instance"
4)
5)RequestID作为端到端全路径跟踪的基础，所以需要在其产生之后，端到端服务调用结束之前在相关的应用系统之间传递；
6)
7)关于请求编码详见“5.4 请求编码规范”章节；
SOAP Body：
响应报文的SOAP Body内容由具体的服务描述文件WSDL来定义 。
确认报文规范
确认报文主要使用在异步调用场景，有请求报文的接受方向报文的发送方确认已经正确收到报文。
3)xsd - "http://www.w3.org/2001/XMLSchema"
4)soapenc - "http://schemas.xmlsoap.org/soap/encoding/"
5)wsdl - "http://schemas.xmlsoap.org/wsdl/"
6)soapbind - "http://schemas.xmlsoap.org/wsdl/soap/"
3
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
术语及定义
4
ESB
4
Enterprise Service Bus 企业服务总线
ESB SERVER
4
提供多协议的支持以及为服务运行提供了高性能、高可靠的运行环境和方便的扩展机制，为Primeton ESB 融入企业IT环境提供了有效支撑及管控手段，不依赖于J2EE容器的特性大大提升了性能。
服务消费者[服务客户端]调用服务的还需设置HTTP Header内容，具体如下：
属性
名称
数据类型
说明
Version
版本
字符型
1)被调用服务操作的版本标识；
2)
3)关于版本编码详见“5.5 版本编码规范”章节；
RequestID
请求编码
字符型
1)服务调用客户端提交的请求的唯一标识；
2)
3)应用系统和服务总线任何一方发现HTTP Header中没有RequestID或RequestID为空，都要生成有效的RequestID；
本标准由信息技术部提出。
本标准由技术中心（研究院）技术管理部归口。
本标准由信息技术部负责起草。
本标准主要起草人：何小红、王浩亮、张凯。
基于ESB
1
2
本规范规定了公司信息系统间数据交互的技术要求，确保信息系统间数据交互的安全与稳定。
本规范适用于株洲电机及其下属业务单元信息业务系统间数据的交互、共享。
规范性引用文件