SOAP协议简介
一. 什么是 SOAP?
· SOAP 指简易对象访问协议
· SOAP 是一种通信协议
· SOAP 用于应用程序之间的通信
· SOAP 是一种用于发送消息的格式
· SOAP 被设计用来通过因特网进行通信
· SOAP 独立于平台
· SOAP 独立于语言
· SOAP 基于 XML
· SOAP 很简单并可扩展
· SOAP 允许您绕过防火墙
· SOAP 将被作为 W3C 标准来发展
二. SOAP 构建模块
1. 一条 SOAP 消息就是一个普通的 XML 文档,包含下列元素:
· 必需的 Envelope 元素,可把此 XML 文档标识为一条 SOAP 消息
· 可选的 Header 元素,包含头部信息(必须为Envelope的第一个子元素)
· 必需的 Body 元素,包含所有的调用和响应信息
· 可选的 Fault 元素,提供有关在处理此消息所发生错误的信息
所有以上的元素均被声明于针对 SOAP 封装的默认命名空间中:
http://www.w3.org/2001/12/soap-envelope
以及针对 SOAP 编码和数据类型的默认命名空间:
http://www.w3.org/2001/12/soap-encoding
2. 这里是一些重要的语法规则:
· SOAP 消息必须用 XML 来编码
· SOAP 消息必须使用 SOAP Envelope 命名空间
· SOAP 消息必须使用 SOAP Encoding 命名空间
· SOAP 消息不能包含 DTD 引用
· SOAP 消息不能包含 XML 处理指令
3. SOAP 在默认的命名空间中 ("http://www.w3.org/2001/12/soap-envelope") 定义了三个属性:actor、 mustUnderstand 以及 encodingStyle。这些被定义在 SOAP 头部的属性可定义容器如何对 SOAP 消息进行处理。
(1) actor 属性可被用于将 Header 元素寻址到一个特定的端点: soap:actor=”url”
(2) mustUnderstand 属性可用于标识标题项对于要对其进行处理的接收者来说是强制的还是可选的:”0|1”
(3) encodingStyle 属性用于定义在文档中使用的数据类型。此属性可出现在任何 SOAP 元素中,并会被应用到元素的内容及元素的所有子元素上。SOAP 消息没有默认的编码方式。soap:encodingStyle=”url”
三. SOAP 消息的基本结构
SOAP Body 元素的直接子元素可以?是合格的命名空间。SOAP 在默认的命名空间中("http://www.w3.org/2001/12/soap-envelope")定义了 Body 元素内部的一个元素。即Fault 元素,用于指示错误消息。
<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Header>
...
...
</soap:Header>
<soap:Body>
...
...
<soap:Fault>
...
...
</soap:Fault>
</soap:Body>
</soap:Envelope>
如果已提供了 Fault 元素,则它必须是 Body 元素的子元素。在一条 SOAP 消息中,Fault 元素只能出现一次。SOAP 的 Fault 元素用于下列子元素:
子元素 | 描述 |
<faultcode> | 供识别故障的代码 |
<faultstring> | 可供人阅读的有关故障的说明 |
<faultactor> | 有关是谁引发故障的信息 |
<detail> | 存留涉及 Body 元素的应用程序专用错误信息 |
下面定义的 faultcode 值必须用于描述故障时的 faultcode 元素中:
错误 | 描述 |
VersionMismatch | SOAP Envelope 元素的无效命名空间被发现 |
MustUnderstand | Header 元素的一个直接子元素(带有设置为 "1" 的 mustUnderstand 属性)无法被理解。 |
Client | 消息被不正确地构成,或包含了不正确的信息。 |
Server | 服务器有问题,因此无法处理进行下去。 |
四. SOAP HTTP Binding
SOAP 方法指的是遵守 SOAP 编码规则的 HTTP 请求/响应。
HTTP + XML = SOAP
SOAP 请求可能是 HTTP POST 或 HTTP GET 请求。
HTTP POST 请求规定至少两个 HTTP 头:Content-Type 和 Content-Length。
1. SOAP 的请求和响应的 Content-Type 头可定义消息的 MIME 类型,以及用于请求或响应的 XML 主体的字符编码(可选):
POST /item HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8
2. SOAP 的请求和响应的 Content-Length 头规定请求或响应主体的字节数:
POST /item HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 250