Latest web development tutorials

SOAP Header要素

オプションのSOAPヘッダー要素は、ヘッダ情報が含まれています。


SOAP Header要素

オプションのSOAPヘッダー要素は、(例えば、認証、支払いなど)、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.w3schools.com/transaction/"
soap:mustUnderstand="1">234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>

上記の例では、その値が234である、「トランス」の要素を持つヘッダを含む値 "のmustUnderstand"この要素の属性が「1」です。

デフォルトの名前空間内のSOAP(「http://www.w3.org/2001/12/soap-envelope」)は、3つの属性を定義します。

3つのプロパティは以下のとおりです。俳優、mustUnderstand属性やencodingStyleを。 これらは、属性が、受信者がSOAPメッセージを処理する方法を定義SOAPヘッダで定義されています。


mustUnderstand属性

SOAPのmustUnderstand属性は、必須またはオプションで処置されるべきレシピエントの見出しを特定することができます。

あなたが追加したとき場合は "のmustUnderstand =" 1 "、それはヘッダを処理する受信機が要素を認識しなければならないことを示している。受信機はHeader要素の子要素にプロセスでこのヘッダーを、この要素を認識しない場合これは失敗しなければなりません。

文法

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.w3schools.com/transaction/"
soap:mustUnderstand="1">234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>


actor属性

異なるエンドポイントを介してメッセージの経路に沿って通過する、SOAPメッセージが送信者から受信者へ送信することができます。 SOAPメッセージの最終的なエンドポイントのために意図SOAPメッセージの全ての部分は、おそらく1つ以上のエンドポイント上のパスにメッセージを伝えることを意図しかしながら、別の態様では、。

SOAPアクター属性は、特定のエンドポイントに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.w3schools.com/transaction/"
soap:actor="http://www.w3schools.com/appml/">234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>


encodingStyleをプロパティ

文書で使用されるデータ型定義のSOAP encodingStyle属性。 この属性は、任意のSOAP要素に表示されることがあり、それは要素のすべてのサブ要素と要素のコンテンツに適用されます。

SOAPメッセージにはデフォルトエンコーディングではありません。

文法

soap:encodingStyle="URI"