2008-03-14

了解WSDL中的style和use

1.   Style和use的组合

 

use属性可以为literal，encoded；style可以为rpc，document，我们来对五种类型的style/use决定的binding作一比较，分别是rpc/literal, document/literal none-wrapper, document/literal with wrapper, rpc/encoded, 以及document/encoded。

从生成soap消息的角度看，rpc和document的差别在于方法的操作名是否出现在生成的Soap消息中，encoded和literal编码方式的差别在于参数类型是否出现在生成的Soap消息中。

这样rpc/encoded能够完整地表示一个方法调用，但缺点是性能很差，而且不能校验Soap消息的有效性。

rpc/literal不对参数类型进行编码，但仍然无法对Soap消息进行校验。Document/encoded没有意义，因为没有方法名，对参数类型编码没有什么意义。

document/literal none-wrapper无法生成操作名，适用于完整的文档作为参数传递给方法的场景。

document/literal with wrapper应该是目前使用最多的方式，在xfire中也是默认配置。

2.   示例

 

2.1. Java方法

 

public void myMethod(int x);

2.2. Rpc/encoded

 

Rpc风格的特点是message元素的每一个part都必须用type属性定义。encoded用来指明一个类型编码模型，不依赖于XML Schema。

清单 2. 用于 myMethod 的 RPC/编码的 WSDL

<message name="myMethodRequest">

    <part name="x" type="xsd:int"/>

</message>

<message name="empty"/>

<portType name="PT">

    <operation name="myMethod">

        <input message="myMethodRequest"/>

        <output message="empty"/>

    </operation>

</portType>

<binding .../> 

<!-- I won't bother with the details, just assume it's RPC/encoded. -->

 

现在用“5”作为参数 x 的值来调用此方法。我们将发送一个与 清单3类似的 SOAP 消息。

清单 3. 用于 myMethod 的 RPC/编码的 SOAP 消息

<soap:envelope>

    <soap:body>

        <myMethod>

            <x xsi:type="xsd:int">5</x>

        </myMethod>

    </soap:body>

</soap:envelope>

 

2.3. RPC/文字

 

用于我们的方法的 RPC/文字的 WSDL 看起来与 RPC/编码的 WSDL 几乎一样。只是绑定的用法由 编码改为 文字。仅此而已。

4. 用于 myMethod 的 RPC/文字的 WSDL

<message name="myMethodRequest">

    <part name="x" type="xsd:int"/>

</message>

<message name="empty"/>

<portType name="PT">

    <operation name="myMethod">

        <input message="myMethodRequest"/>

        <output message="empty"/>

    </operation>

</portType>

<binding .../> 

<!-- I won't bother with the details, just assume it's RPC/

        literal. -->

     

 

RPC/文字的 SOAP 消息去掉了类型编码。

清单 5. 用于 myMethod 的 RPC/文字的 SOAP 消息

<soap:envelope>

    <soap:body>

        <myMethod>

            <x>5</x>

        </myMethod>

    </soap:body>

</soap:envelope>

 

2.4. document/literal

 

document/literal的主要特点是message元素的每一个part都使用element属性引用一个types下面定义的schema元素。

清单6. 用于 myMethod 的文档/文字的 WSDL

<types>

    <schema>

        <element name="xElement" type="xsd:int"/>

    </schema>

</types>

<message name="myMethodRequest">

    <part name="x" element="xElement"/>

</message>

<message name="empty"/>

<portType name="PT">

    <operation name="myMethod">

        <input message="myMethodRequest"/>

        <output message="empty"/>

    </operation>

</portType>

<binding .../> 

<!-- I won't bother with the details, just assume it's

        document/literal. -->

     

清单7. 用于 myMethod 的文档/文字的 SOAP 消息

<soap:envelope>

    <soap:body>

        <xElement>5</xElement>

p

评论
发表评论

您还没有登录，请登录后发表评论