1. Style和use的组合
<o:p> </o:p>
use属性可以为literal,encoded;style可以为rpc,document,我们来对五种类型的style/use决定的binding作一比较,分别是rpc/literal, document/literal none-wrapper, document/literal with wrapper, rpc/encoded, 以及document/encoded。<o:p></o:p>
从生成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. 示例
<o:p> </o:p>
2.1. Java方法
<o:p> </o:p>
public void myMethod(int x);<o:p></o:p>
2.2. Rpc/encoded
<o:p> </o:p>
Rpc风格的特点是message元素的每一个part都必须用type属性定义。encoded用来指明一个类型编码模型,不依赖于XML Schema。
清单 2. 用于 myMethod 的 RPC/编码的 WSDL <o:p></o:p>
<message name="myMethodRequest"><o:p></o:p> <part name="x" type="xsd:int"/><o:p></o:p> </message><o:p></o:p> <message name="empty"/><o:p></o:p> <portType name="PT"><o:p></o:p> <operation name="myMethod"><o:p></o:p> <input message="myMethodRequest"/><o:p></o:p> <output message="empty"/><o:p></o:p> </operation><o:p></o:p> </portType><o:p></o:p> <binding .../> <o:p></o:p> <!-- I won't bother with the details, just assume it's RPC/encoded. --><o:p></o:p> |
<o:p> </o:p>
现在用“5”作为参数 x 的值来调用此方法。我们将发送一个与 清单3类似的 SOAP 消息。
清单 3. 用于 myMethod 的 RPC/编码的 SOAP 消息 <o:p></o:p>
<soap:envelope><o:p></o:p> <soap:body><o:p></o:p> <myMethod><o:p></o:p> <x xsi:type="xsd:int">5</x><o:p></o:p> </myMethod><o:p></o:p> </soap:body><o:p></o:p> </soap:envelope><o:p></o:p> |
<o:p> </o:p>
2.3. RPC/文字
<o:p> </o:p>
用于我们的方法的 RPC/文字的 WSDL 看起来与 RPC/编码的 WSDL 几乎一样。只是绑定的用法由 编码改为 文字。仅此而已。
4. 用于 myMethod 的 RPC/文字的 WSDL<o:p></o:p>
<message name="myMethodRequest"><o:p></o:p> <part name="x" type="xsd:int"/><o:p></o:p> </message><o:p></o:p> <message name="empty"/><o:p></o:p> <portType name="PT"><o:p></o:p> <operation name="myMethod"><o:p></o:p> <input message="myMethodRequest"/><o:p></o:p> <output message="empty"/><o:p></o:p> </operation><o:p></o:p> </portType><o:p></o:p> <binding .../> <o:p></o:p> <!-- I won't bother with the details, just assume it's RPC/<o:p></o:p> literal. --><o:p></o:p> <o:p></o:p> |
<o:p> </o:p>
RPC/文字的 SOAP 消息去掉了类型编码。
清单 5. 用于 myMethod 的 RPC/文字的 SOAP 消息<o:p></o:p>
<soap:envelope><o:p></o:p> <soap:body><o:p></o:p> <myMethod><o:p></o:p> <x>5</x><o:p></o:p> </myMethod><o:p></o:p> </soap:body><o:p></o:p> </soap:envelope><o:p></o:p> |
<o:p> </o:p>
2.4. document/literal
<o:p> </o:p>
document/literal的主要特点是message元素的每一个part都使用element属性引用一个types下面定义的schema元素。<o:p></o:p>
清单6. 用于 myMethod 的文档/文字的 WSDL<o:p></o:p>
<types><o:p></o:p> <schema><o:p></o:p> <element name="xElement" type="xsd:int"/><o:p></o:p> </schema><o:p></o:p> </types><o:p></o:p> <message name="myMethodRequest"><o:p></o:p> <part name="x" element="xElement"/><o:p></o:p> </message><o:p></o:p> <message name="empty"/><o:p></o:p> <portType name="PT"><o:p></o:p> <operation name="myMethod"><o:p></o:p> <input message="myMethodRequest"/><o:p></o:p> <output message="empty"/><o:p></o:p> </operation><o:p></o:p> </portType><o:p></o:p> <binding .../> <o:p></o:p> <!-- I won't bother with the details, just assume it's <o:p></o:p> document/literal. --><o:p></o:p> <o:p></o:p> |
清单7. 用于 myMethod 的文档/文字的 SOAP 消息<o:p></o:p>
<soap:envelope><o:p></o:p> <soap:body><o:p></o:p> <xElement>5</xElement><o:p></o:p> |