ESB-服务规范标准[详]

银行企业服务总线服务接

口规

版本：v1.0

目录

第1章服务规 (3)

1.1基本规 (3)

1.2SOAP格式规 (3)

1.3报文总体组成 (4)

固定字段 (5)

扩展字段 (5)

请求报文 (6)

响应报文 (7)

出错报文 (8)

1.4XML格式规 (9)

请求报文 (10)

响应报文 (11)

第2章接口规 (12)

2.1服务操作定义 (12)

2.2消息定义 (13)

2.3字段定义 (13)

2.5命名空间定义 (14)

第1章服务规

1.1基本规

?消息格式：SOAP

?SOAP绑定模式：document/literal

?字符编码：UTF-8

1.2SOAP格式规

先看一个SOAP报文示例：

0

A6002

2003

1001000

9999

20080929

095050

1

1

10

9

011

weikai

SOAP消息的根元素是信封，信封报文主要由报文头（Header）和报文本（Body）构成，ESB的Web-Service将不使用Header，服务调用者可以忽略对Header的关注。

因此，ESB的有效载荷在SOAP的Body，每个Body都只有一个元素（为了

便于描述，我们称它为ESB报文元素），这个元素的部的XML（innerXML）即为要关注的实际报文。如果要了解ESB的接口规格只需简单了解ESB报文元素即可。接口文档的定义，也是针对ESB报文元素进行定义的。上例中的报文元素为：

该报文本中，最上面几个元素（黑体标注）为固定字段，所有服务报文都有这些字段。固定字段之后是可变字段，可变字段对于每个服务来说都是不一样的，具体规格由服务接口定义规定义，其中中间的几个元素（斜体标注）为扩展字段，主要作用是解决各系统对报文公共头信息的特殊要求。

1.3报文总体组成

报文体字段由三部分组成：

?固定字段：每个服务都具备的字段，用来描述和标识请求与响应报文。

?扩展字段：由于固定字段不能保证满足所有交易的请求与响应信息，各系统可以根据需要对报文进行扩展。

?服务相关字段：每个服务的请求与响应字段，即业务字段。

固定字段

固定字段是服务的元数据类型，在模式文件esb.xsd文件中定义，包含了交

易所用到的头信息容，所有通过ESB发布的WebService服务，必须继承固定字段。

ESB固定字段定义文件：

扩展字段

扩展字段是为了满足服务提供者的请求报文和响应报文中特殊的报文头信息而设定的。各业务系统可以根据需要定制扩展字段模式文件，并包含固定字段模式文件。

需要注意的是，扩展字段模式文件中的命名空间必须保持与固定字段模式文件中的命名空间一致。

建议一个服务提供者的扩展字段模式文件只定义一个。

扩展字段模式文件定义示例：

elementFormDefault="qualified"

xmlns="https://www.360docs.net/doc/af6796142.html,/2001/XMLSchema"

xmlns:esb="https://www.360docs.net/doc/af6796142.html,/esb/">

请求报文固定字段

示例