バインディングの詳細 (プロジェクトでの HTTP バインディングコンポーネントの使用)

プロジェクトでの HTTP バインディングコンポーネントの使用

バインディングの詳細

以降の節では、HTTP バインディングコンポーネントが HTTP バインディング言語要素をどのようにサポートし、実装するかについて説明します。特に指示がないかぎり、ここで説明する WSDL 要素は名前空間 http://schemas.xmlsoap.org/wsdl/http/ で定義されています。

http:binding 要素

<http:binding> 要素:

バインディングが HTTP プロトコルを使用することを示します。
<wsdl:binding> の従属要素として指定する必要があります。

注 –

現在、HTTP バインディングコンポーネントでは GET と POST の値だけがサポートされています (HTTP メソッドでは大文字と小文字が区別されることに注意してください)。

例:

<http:binding verb="POST"/>

http:address 要素

<http:address> 要素:

ポートのアドレスを表します。
<wsdl:port> の従属要素として指定する必要があります。
ポートの基底 URI を指定する location 属性が必要です。

例:

<http::address location="http://localhost/MyService/MyPort"/>

http:operation 要素

<http:operation> 要素:

オペレーションのアドレスを表します。
<wsdl:operation/> の従属要素として指定する必要があります。
オペレーションの基底 URI を指定する location 属性が必要です。
このポートおよびこの特定のオペレーションに対する要求の完全な URI。<http:address> 要素はポートのアドレスを指定し、ポートは複数のオペレーションを持つ可能性があるので、この要素は特定のオペレーションの相対アドレスを表します。この要素の location 属性の値は <http:address> の location 属性の値に付加されて、このポートおよびこの特定のオペレーションに対する要求の完全な URI を形成します。

HTTP バインディングコンポーネントでは、この要素の location 属性の値として空白がサポートされています。

例:

Given:
    <http:operation location="Submit">
    <http:address location="http://localhost/MyService/MyPort">

The full HTTP request URI is: 
http://localhost/MyService/MyPort/Submit

http:urlEncoded 要素

<http:urlEncoded> 要素:

入力メッセージを構成しているすべてのメッセージパートが、次のようにクエリー文字列エンコーディングを使用して、要求 URI 内にエンコードされることを示します。
- 名前=値という形式で表された名前と値のペア
- アンパサンドで区切られた名前と値のペア: name1=value1&name2=value2&...
- メッセージパートの名前が各ペアの名前になり、メッセージパートの値が各ペアの値になります。
<wsdl:input/> の従属要素として指定する必要があります。
オペレーションの基底 URI を指定する location 属性が必要です。
GET メソッドの HTTP バインディングコンポーネントでのみサポートされます。POST メソッドの場合、<http:urlEncoded> は無視されます。詳細については、POST URL Processing of the HTTP WSDL Binding Implementation を参照してください。

例:

Given this description:
<wsd:message name="MyMessage">
    <wsdl:part name="partA" type="xsd:string"/>
    <wsdl:part name="partB" type="xsd:string"/>
</wsdl:message>
...
<wsdl:portType name="MyPortType">
    <wsdl:operation name="MyOperation">
        <wsdl:input message="MyMessage"/>
    </wsdl:operation>
</wsdl:portType>
...
<wsdl:binding name="MyBinding" type="MyPortType">
    <http:binding verb="GET"/>
    <wsdl:operation name="MyOperation">
        <wsdl:input>
            <http:urlEncoded/>
        </wsdl:input>
    </wsdl:operation>
</wsdl:binding>
...
<wsdl:service name="MyService">
    <wsdl:port name="Port1" binding="MyBinding">
        <http:address location="http://localhost/MyService/MyPort"/>
    </wsdl:port>
</wsdl:service>

Given these values mapped to the input parts:
"valueY" -> "partA"
"valueZ" -> "partB"

The full HTTP request URI is:
http://localhost/MyService/MyPort/MyOperation/partA=valueY&partB=valueZ

http:urlReplacement

<http:urlReplacement/> 要素:

入力メッセージを構成しているすべてのメッセージパートが、WSDL 1.1 仕様で詳細に記述されている置換アルゴリズムを使用して、要求 URI 内にエンコードされることを示します。
<wsdl:input/> の従属要素として指定する必要があります。
オペレーションの基底 URI を指定する location 属性が必要です。
GET メソッドの HTTP バインディングコンポーネントでのみサポートされます。POST メソッドの場合、<http:urlEncoded> は無視されます。詳細については、POST URL Processing of the HTTP WSDL Binding Implementation を参照してください。

例:

Given this description:
<wsd:message name="MyMessage">
    <wsdl:part name="partA" type="xsd:string"/>
    <wsdl:part name="partB" type="xsd:string"/>
</wsdl:message>
...
<wsdl:portType name="MyPortType">
    <wsdl:operation name="MyOperation">
        <wsdl:input message="MyMessage"/>
    </wsdl:operation>
</wsdl:portType>
...
<wsdl:binding name="MyBinding" type="MyPortType">
    <http:binding verb="GET"/>
    <wsdl:operation name="MyOperation/(partA)/subcategory/(partB)">
        <wsdl:input>
            <http:urlReplacement/>
        </wsdl:input>
    </wsdl:operation>
</wsdl:binding>
...
<wsdl:service name="MyService">
    <wsdl:port name="Port1" binding="MyBinding">
        <http:address location="http://localhost/MyService/MyPort"/>
    </wsdl:port>
</wsdl:service>

Given these values mapped to the input parts:
"valueY" -> "partA"
"valueZ" -> "partB"

The full HTTP request URI is:
http://localhost/MyService/MyPort/MyOperation/valueY/subcategory/valueZ