Web Services Addressing (WS-Addressing) は、Web サービスにアドレッシングし、メッセージにアドレッシング情報を提供するための標準的な方法を定義することにより、Web サービス間のインターオペラビリティーを支援する Worldwide Web Consortium (W3C) 仕様です。 WS-Addressing 仕様は、2 つの基本的な概念、エンドポイント参照とメッセージ・アドレッシング・プロパティーを導入しています。 このトピックでは各概念の概要を説明します。詳しくは、WS-Addressing 仕様を参照してください。
抽象プロパティー名 | プロパティー・タイプ | 多様 | 説明 |
---|---|---|---|
[address] | xs:anyURI | 1..1 | エンドポイントのアドレスを指定する絶対 URI。 |
[reference parameters]* | xs:any | 0..unbounded | エンドポイントと相互作用するために必要な、ネーム・スペースの修飾エレメント情報項目。 |
[metadata] | xs:any | 0..unbounded | エンドポイントの振る舞い、ポリシー、および機能の説明。 |
接頭部 | ネーム・スペース |
---|---|
xs | http://www.w3.org/2001/XMLSchema |
<wsa:EndpointReference xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:fabrikam="http://example.com/fabrikam" xmlns:wsdli="http://www.w3.org/2005/08/wsdl-instance" wsdli:wsdlLocation="http://example.com/fabrikam http://example.com/fabrikam/fabrikam.wsdl"> <wsa:Address>http://example.com/fabrikam/acct</wsa:Address> <wsa:Metadata> <wsaw:InterfaceName>fabrikam:Inventory</wsaw:InterfaceName> </wsa:Metadata> <wsa:ReferenceParameters> <fabrikam:CustomerKey>123456789</fabrikam:CustomerKey> <fabrikam:ShoppingCart>ABCDEFG</fabrikam:ShoppingCart> </wsa:ReferenceParameters> </wsa:EndpointReference>
抽象 WS-Addressing MAP 名 | MAP コンテンツ・タイプ | 多様 | 説明 |
---|---|---|---|
[action] | xs:anyURI | 1..1 | メッセージのセマンティクスを一意的に識別する絶対 URI。 このプロパティーは、メッセージがアドレッシングされるエンドポイント参照の [address] プロパティーに対応します。 この値は必須です。 |
[destination] | xs:anyURI | 1..1 | このメッセージが対象としている受信側のアドレスを指定する絶対 URI。 この値はオプションです。この値が指定されていない場合は、仕様により定義される匿名 URI がデフォルトとなります。これは、アドレスが基本プロトコルによって定義されることを示します。 |
[reference parameters]* | xs:any | 0..unbounded | メッセージがアドレッシングされるエンドポイント参照の [reference parameters] プロパティーに対応します。 この値はオプションです。 |
[source endpoint] | EndpointReference | 0..1 | メッセージが発信されるエンドポイントへの参照。 この値はオプションです。 |
[reply endpoint] | EndpointReference | 0..1 | このメッセージに対する応答の対象となる受信側のエンドポイント参照。 この値はオプションです。 |
[fault endpoint] | EndpointReference | 0..1 | このメッセージに関連する障害の対象となる受信側のエンドポイント参照。 この値はオプションです。 |
[relationship]* | xs:anyURI plus optional attribute of type xs:anyURI | 0..unbounded | このメッセージが他のメッセージと関係する方法を示すペアの値。 このエレメントのコンテンツは、関連メッセージの [message id] を伝達します。 オプション属性は、関係のタイプを伝達します。 この値はオプションです。 |
[message id] | xs:anyURI | メッセージを一意的に識別する絶対 URI。 この値はオプションです。 |
<S:Envelope xmlns:S="http://www.w3.org/2003/05/soap-envelope" xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:fabrikam="http://example.com/fabrikam"> <S:Header> ... <wsa:To>http://example.com/fabrikam/acct</wsa:To> <wsa:ReplyTo> <wsa:Address> http://example.com/fabrikam/acct</wsa:address> </wsa:ReplyTo> <wsa:Action>...</wsa:Action> <fabrikam:CustomerKey wsa:IsReferenceParameter='true'>123456789</fabrikam:CustomerKey> <fabrikam:ShoppingCart wsa:IsReferenceParameter='true'>ABCDEFG</fabrikam:ShoppingCart> ... </S:Header> <S:Body> ... </S:Body> </S:Envelope>