SOAP

最新推荐文章于 2025-08-13 16:38:29 发布

原创最新推荐文章于 2025-08-13 16:38:29 发布 · 690 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#soap #header #xml #actor #文档 #服务器

协议、规范专栏收录该内容

1 篇文章

订阅专栏

名词解释:SOAP简单对象访问协议，是一种轻量的、简单的、基于XML的协议，SOAP是用于访问网络服务的协议。可以和现存的许多因特网协议和格式结合使用，包括超文本传输协议（ HTTP），简单邮件传输协议（SMTP），多用途网际邮件扩充协议（MIME）。它还支持从消息系统到远程过程调用（RPC）等大量的应用程序。
一条 SOAP 消息就是一个普通的 XML 文档，包含下列元素：
    * 必需的 Envelope 元素，可把此 XML 文档标识为一条 SOAP 消息
    * 可选的 Header 元素，包含头部信息
    * 必需的 Body 元素，包含所有的调用和响应信息
    * 可选的 Fault 元素，提供有关在处理此消息所发生错误的信息
SOAP 消息的基本结构如下：
<?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>
@注解：
1、SOAP 消息必须拥有与命名空间 "http://www.w3.org/2001/12/soap-envelope" 相关联的一个    Envelope 元素。如果使用了不同的命名空间，应用程序会发生错误，并抛弃此消息。
2、SOAP 的 encodingStyle 属性用于定义在文档中使用的数据类型。此属性可出现在任何 SOAP 元素中，并会被应用到元素的内容及元素的所有子元素上。SOAP 消息没有默认的编码方式。
3、可选的 SOAP Header 元素可包含有关 SOAP 消息的应用程序专用信息（比如认证、支付等）。如果 Header 元素被提供，则它必须是 Envelope 元素的第一个子元素。
4、actor属性通过沿着消息路径经过不同的端点，SOAP 消息可从某个发送者传播到某个接收者。并非 SOAP 消息的所有部分均打算传送到 SOAP 消息的最终端点，不过，另一个方面，也许打算传送给消息路径上的一个或多个端点。SOAP 的 actor 属性可被用于将 Header 元素寻址到一个特定的端点。
5、mustUnderstand 属性可用于标识标题项对于要对其进行处理的接收者来说是强制的还是可选的。假如您向 Header 元素的某个子元素添加了 "mustUnderstand="1"，则它可指示处理此头部的接收者必须认可此元素。假如此接收者无法认可此元素，则在处理此头部时必须失效。
6、必需的 SOAP Body 元素可包含打算传送到消息最终端点的实际 SOAP 消息。
7、SOAP Fault 元素来自 SOAP 消息的错误消息被携带于 Fault 元素内部。如果已提供了 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。
Content-Type
SOAP 的请求和响应的 Content-Type 头可定义消息的 MIME 类型，以及用于请求或响应的 XML 主体的字符编码（可选）。
语法
Content-Type: MIMEType; charset=character-encoding
例子
POST /item HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8

Content-Length
SOAP 的请求和响应的 Content-Length 头规定请求或响应主体的字节数。
语法
Content-Length: bytes
例子
POST /item HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8
Content-Length: 250

一个 SOAP 实例

在下面的例子中，一个 GetStockPrice 请求被发送到了服务器。此请求有一个 StockName 参数，而在响应中则会返回一个 Price 参数。此功能的命名空间被定义在此地址中： "http://www.example.org/stock"
SOAP 请求：

POST /InStock HTTP/1.1
Host: www.example.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: nnn

<?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:Body xmlns:m="http://www.example.org/stock">
    <m:GetStockPrice>
      <m:StockName>IBM</m:StockName>
    </m:GetStockPrice>
</soap:Body>

</soap:Envelope>

SOAP 响应：

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: nnn

<?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:Body xmlns:m="http://www.example.org/stock">
    <m:GetStockPriceResponse>
      <m:Price>34.5</m:Price>
    </m:GetStockPriceResponse>
</soap:Body>

</soap:Envelope>

最好说到soap的好处