SOAPヘッダー要素
オプションの SOAP Header 要素にはヘッダー情報が含まれます。
SOAP ヘッダー要素
オプションの SOAP ヘッダー要素には、SOAP メッセージに関するアプリケーション固有の情報 (認証、支払いなど) を含めることができます。
Header 要素が指定される場合、それは Envelope 要素の最初の子である必要があります。
注: Header 要素のすべての直接の子要素は、名前空間修飾されている必要があります。
<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/"
石鹸:mustUnderstand="1">234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>
上記の例には、「Trans」要素を持つヘッダーが含まれており、その値は次のとおりです。 234 であり、この要素の「mustUnderstand」属性の値は「1」です。
SOAP は、デフォルトの名前空間 ("http://www.w3.org/2001/12/soap-envelope") で 3 つのプロパティを定義します。
3 つの属性は、actor、mustUnderstand、encodingStyle です。 SOAP ヘッダーで定義されるこれらのプロパティは、コンテナーが SOAP メッセージを処理する方法を定義します。
mustUnderstand 属性
SOAP のMustUnderstand 属性は、ヘッダー項目が受信者による処理に必須であるかオプションであるかを識別するために使用できます。
Header 要素のサブ要素に "mustUnderstand="1" を追加すると、このヘッダーを処理する受信者がこの要素を認識する必要があることを示すことができます。この受信者がこの要素を認識できない場合、このヘッダーを処理するときに
構文
例
<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/"
石鹸:mustUnderstand="1">234
</m:Trans>
</soap:Header>
...
...
</soap:Envelope>
アクター属性
SOAP メッセージは、メッセージ パスに沿ってさまざまなエンドポイントを通過することによって、送信者から受信者に伝播できます。 SOAP メッセージのすべての部分が SOAP メッセージの最終エンドポイントに配信されることを目的としているわけではありませんが、逆に、メッセージ パスに沿った 1 つ以上のエンドポイントに配信されることもあります。
SOAP の Actor 属性は、Header 要素を特定のエンドポイントにアドレス指定するために使用できます。
構文
例
<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 メッセージにはデフォルトのエンコーディングはありません。