SOAP第4課：SOAP Header 元素

2020-12-12 13:51:15

字體：大中小

來源：轉載

供稿：網友

可選的 SOAP Header 元素包含頭部信息。

SOAP Header 元素
可選的 SOAP Header 元素可包含有關 SOAP 消息的應用程序專用信息（比如認證、支付等）。如果 Header 元素被提供，則它必須是 Envelope 元素的第一個子元素。

注釋：所有 Header 元素的直接子元素必須是合格的命名空間。

<?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>
<m:Trans
xmlns:m="http://www.w3school.com.cn/transaction/"
soap:mustUnderstand="1">234</m:Trans>
</soap:Header>

...
...

</soap:Envelope>

上面的例子包含了一個帶有一個 "Trans" 元素的頭部，它的值是 234，此元素的 "mustUnderstand" 屬性的值是 "1"。

SOAP 在默認的命名空間中 ("http://www.w3.org/2001/12/soap-envelope") 定義了三個屬性。這三個屬性是：actor、 mustUnderstand 以及 encodingStyle。這些被定義在 SOAP 頭部的屬性可定義容器如何對 SOAP 消息進行處理。

actor 屬性
通過沿著消息路徑經過不同的端點，SOAP 消息可從某個發送者傳播到某個接收者。并非 SOAP 消息的所有部分均打算傳送到 SOAP 消息的最終端點，不過，另一個方面，也許打算傳送給消息路徑上的一個或多個端點。

SOAP 的 actor 屬性可被用于將 Header 元素尋址到一個特定的端點。

語法

soap:actor="URI"

實例

<?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>
<m:Trans
xmlns:m="http://www.w3school.com.cn/transaction/"
soap:actor="http://www.w3school.com.cn/appml/">
234
</m:Trans>
</soap:Header>

...
...

</soap:Envelope>

mustUnderstand 屬性
SOAP 的 mustUnderstand 屬性可用于標識標題項對于要對其進行處理的接收者來說是強制的還是可選的。

假如您向 Header 元素的某個子元素添加了 "mustUnderstand="1"，則它可指示處理此頭部的接收者必須認可此元素。假如此接收者無法認可此元素，則在處理此頭部時必須失效。

語法

soap:mustUnderstand="0|1"

實例

<?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>
<m:Trans
xmlns:m="http://www.w3school.com.cn/transaction/"
soap:mustUnderstand="1">
234
</m:Trans>
</soap:Header>

...
...

</soap:Envelope>

encodingStyle 屬性
SOAP 的 encodingStyle 屬性在上一節中已解釋過了。

上一篇：SOAP第3課：SOAP Envelope 元素

下一篇：SOAP第5課：SOAP Body 元素