WSDL l定样式可以?RPC 样式或文档样式。用法可以是~码的，也可以是文字的。?zhn)如何军_使用哪一U样?用法的组合呢Q本文将帮助(zhn)解册个问题?/BLOCKQUOTE>
引言
Web 服务是通过 WSDL 文档来描q的。WSDL l定描述了如何把服务l定到消息传递协议（特别?SOAP 消息传递协议）(j)。WSDL SOAP l定可以?RPC 样式的绑定，也可以是文档样式的绑定。同PSOAP l定可以有编码的用法Q也可以有文字的用法。这l我们提供了四种样式/用法模型Q?/P>
- RPC/~码
- RPC/文字
- 文档/~码
- 文档/文字
除了q些样式之外Q还有一U样式也很常见，它称为文?文字包装的样式，上q一U，在创?WSDL 文g时?zhn)有了五U绑定样式可以从中选择。?zhn)应该选择哪一U呢Q?/P>
在我q一步讨Z前，让我阐明一些容易淆的地方。这里，q些术语是非怸合适的QRPC 与文档。这些术语意味着 RPC 样式应该用于 RPC ~程模型Q文档样式应该用于文档或消息~程模型?但事实完?I xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">不是q样。样式对于编E模型没有Q何意义。它只是指明了如何将 WSDL l定转化?SOAP 消息。其他就没什么了。你可以Q一U样式用于Q何编E模型?/P>
同样Q术?I xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">~码?I xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">文字只对?WSDL ?SOAP 映射有意义，可是Q至这里，q两个单词的字面意思更Ҏ(gu)理解一些?/P>
对于q篇讨论Q让我们?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 1 中的 Java Ҏ(gu)开始，q且应用 JAX-RPC Java-to-WSDL 规则Q参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">参考资?/A>查看 JAX-RPC 1.1 规范Q?/P>清单 1. Java Ҏ(gu)
public void myMethod(int x, float y);
|
RPC/~码
采用清单 1 中的Ҏ(gu)q且使用你喜Ƣ的 Java-to-WSDL 工具来运行，指定(zhn)想让它生成 RPC/~码?WSDL。?zhn)最后应该得到如清单 2 所C的 WSDL 片断?/P>清单 2. 用于 myMethod ?RPC/~码?WSDL
<message name="myMethodRequest">
<part name="x" type="xsd:int"/>
<part name="y" type="xsd:float"/>
</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. -->
|
现在用?”作为参?x 的|?.0”作为参?y 的值来调用q个Ҏ(gu)。发送一个如清单 3 所C的SOAP 消息?/P>清单 3. 用于 myMethod ?RPC/~码?SOAP 消息
<soap:envelope>
<soap:body>
<myMethod>
<x xsi:type="xsd:int">5</x>
<y xsi:type="xsd:float">5.0</y>
</myMethod>
</soap:body>
</soap:envelope>
|
|
关于前缀和命名空间的注意事项
Z单v见，在本文的大部?XML CZ中，我省略了命名I间和前~。不q，我还是用了数前缀Q?zhn)可以假定它们是用下列名称I间q行定义的：(x)
- xmlns:xsd="http://www.w3.org/2001/XMLSchema"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
关于命名I间?WSDL-to-SOAP 映射的讨论，请参考文章“Handle namespaces in SOAP messages you create by hand”（参阅 参考资?/A>Q?/P> |
关于 RPC/~码例子中的 WSDL ?SOAP 消息有一些需要注意的地方Q?/P>
优点
- WSDL 可能的单明了?
- 操作名出现在消息中，因此接收者可以很Ҏ(gu)的将消息分派到操作的实现?/LI>
~点
|
늅 WS-I
各种 Web 服务规范有时候是不一致和不明的。WS-I l织成立用来解决q些规范上的问题。它已经定义了许多概要，指明了你应该如何~写 Web 服务来实C操作性。要获取 WS-I 的更多信息，请参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">参考资?/A>中的 WS-I 链接?/P> |
- cd~码信息Q?CODE>xsi:type="xsd:int"Q通常是降低吞吐量性能的开销?
- 你不能很Ҏ(gu)的验证这个消息的有效性，因ؓ(f)只有
<x ...>5</x> ?<y ...>5.0</y> 行包?Schema 中定义的内容Q?CODE>soap:body 内容的其余部分来自于 WSDL 定义?
- 虽然它是合法?WSDLQ但 RPC/encoded 是不遵守 WS-I 的?/LI>
有没有一U方法可以取其精华，弃其p粕呢？可能有。让我们看一?RPC/文字样式?/P>
RPC/文字
用于q个Ҏ(gu)?RPC/文字样式?WSDL 看v来与 RPC/~码?WSDLQ?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 4Q几乎一栗绑定的用法?~码 变ؓ(f) 文字。仅此而已?/P>清单 4. 用于 myMethod ?RPC/文字样式?WSDL
<message name="myMethodRequest">
<part name="x" type="xsd:int"/>
<part name="y" type="xsd:float"/%gt;
</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 消息又是怎样的呢Q参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 5Q？q里的更改要多一炏V去掉了cd~码?/P>清单 5. 用于 myMethod ?RPC/literal SOAP 消息
<soap:envelope>
<soap:body>
<myMethod>
<x>5</x>
<y>5.0</y>
</myMethod>
</soap:body>
</soap:envelope>
|
|
关于 xsi:type 和文字用法的注意事项
虽然在一般情况下Q?CODE>xsi:type 没有出现在文?WSDL ?SOAP 消息中，但是仍然有一些情况，cd信息是必ȝQƈ且它?yu)以多种形式出现。如?API 期望一个基cdQƈ且发送一个扩展实例，则必L供这个实例的cd以便正确的反序列化该对象?/P> |
q里是这U方法的优点和缺点：(x)
优点
- WSDL 可能的单明了?
- 操作名仍然出现在消息中?
- L了类型编码?
- RPC/文字是遵?WS-I 的?/LI>
~点
- 你仍然不能很Ҏ(gu)的验证这个消息的有效性，因ؓ(f)只有
<x ...>5</x> ?<y ...>5.0</y> 行中包含定义?Schema 中的内容Q?CODE>soap:body 内容的其余部分来自于 WSDL 定义?/LI>
文档样式如何呢？它们能够帮助克服q些困难吗？
文档/~码
没有Z用这个样式。它不遵?WS-I。因此此处略q?/P>
文档/文字
文档/文字?WSDL ?RPC/文字?WSDL 基础上做了一些修攏V其不同点已l在清单 6 中指出?/P>清单 6. 用于 myMethod 的文?文字 WSDL
<types>
<schema>
<element name="xElement" type="xsd:int"/>
<element name="yElement" type="xsd:float"/>
</schema>
</types>
<message name="myMethodRequest">
<part name="x" element="xElement"/>
<part name="y" element="yElement"/>
</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. -->
|
用于q个 WSDL ?SOAP 消息?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 7 所C：(x)
清单 7. 用于 myMethod 的文?文字 SOAP 消息
<soap:envelope>
<soap:body>
<xElement>5</xElement>
<yElement>5.0</yElement>
</soap:body>
</soap:envelope>
|
|
关于消息l成部分的注意事?/B>
我本来可以只更改l定Q就像我?RPC/~码转到 RPC/所做的那样。它?yu)是合法?WSDL。然而，W(xu)S-I 基本概要QWS-I Basic ProfileQ规定文?文字的消息的l成部分引用元素而不是类型，所以我遵@?WS-IQƈ且此处用元素部分可以很好地把我们带到关于文?文字包装的样式的讨论Q?/P> |
下面是这U方法的优点和缺点：(x)
优点
- 没有cd~码信息?
- (zhn)可以在最后用M XML (g)验器(g)验此消息的有效性?CODE>soap:body 里面的所有内定w定义?schema 中?
- 文档/文字是遵?WS-I 的，但是有限Ӟ参阅~点Q?/LI>
~点
- WSDL 有一点复杂。不q，q是一个非常小的缺点，因ؓ(f) WSDL q没有打由人来d?
- SOAP 消息中缺操作名。而如果没有操作名Q发送就可能比较困难Qƈ且有时变得不可能?
- WS-I 仅仅允许 SOAP 消息?
soap:body 的一个子元素。正如你?A >清单 7 中所见的那样Q该消息?soap:body 有两个子元素?/LI>
文档/文字样式g只是重新排列了一?RPC/文字模型中的优点和缺炏V你可以验证该消息，但是你已l失M操作名。有没有什么办法可以改q这一点呢Q是的，它就是文?文字包装模式?/P>
文档/文字包装模式
在我描述文档/文字包装模式的规则之前，让我先向(zhn)展C?WSDL ?SOAP 消息Q如清单 8 ?清单 9 所C?/P>清单 8. 用于 myMethod 的文?文字装?WSDL?/B>
<types>
<schema>
<element name="myMethod">
<complexType>
<sequence>
<element name="x" type="xsd:int"/>
<element name="y" type="xsd:float"/>
</sequence>
</complexType>
</element>
<element name="myMethodResponse">
<complexType/>
</element>
</schema>
</types>
<message name="myMethodRequest">
<part name="parameters" element="myMethod"/>
</message>
<message name="empty">
<part name="parameters" element="myMethodResponse"/>
</message>
<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. -->
|
WSDL Schema 现在把参数放在包装中Q参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 9Q?/P>清单 9. 用于 myMethod 的文?文字包装?SOAP 消息
<soap:envelope>
<soap:body>
<myMethod>
<x>5</x>
<y>5.0</y>
</myMethod>
</soap:body>
</soap:envelope>
|
注意q个 SOAP 消息?RPC/文字?SOAP 消息Q?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 5Q非常相伹{?zhn)可能会(x)说Q它看v来与 RPC/文字?SOAP 消息是完全一L(fng)Q不q，q两U消息之间存在着微妙的区别。在 RPC/文字?SOAP 消息中，<soap:body> ?<myMethod> 子句是操作的名称。在文档/文字包装?SOAP 消息中，<myMethod> 子句是单个输入消息的l成部分引用的元素的名称。因此，包装的样式具有这L(fng)一个特征，输入元素的名UC操作的名U是相同的。此样式是把操作名放?SOAP 消息的一Uy妙方式?/P>
文档/文字包装的样式的特征有：(x)
- 输入消息只有一个组成部分?
- 该部分是一个元素?
- 该元素同操作有相同的名称?
- 该元素的复杂cd没有属性?/LI>
下面是该U方法的优缺点：(x)
优点
- 没有cd~码信息?
soap:body 中出现的所有内定w定义?schema 中，所以?zhn)可以很容易地(g)验此消息的有效性?
- Ҏ(gu)名又出现?SOAP 消息中?
- 文档/文字是遵?WS-I 的，q且包装模式W合?WS-I 的限Ӟ?SOAP 消息?
soap:body 只有一个子元素?/LI>
~点
文档/文字包装的样式还是有一些缺点，不过与优Ҏ(gu)hQ它们都昑־微不道?/P>
|
RPC/文字包装Q?/B>
?WSDL 的角度来考虑Q没有理由只是把把包装的样式和文?文字l定联系在一赗它可以很容易地应用?RPC/文字l定。但是这样做是相当不明智的。SOAP 包含操作的一?myMethod 元素和元素名U的?myMethod 元素。另外，即它是一个合法的 WSDLQRPC/文字元素部分也不遵@ WS-I?/P> |
文档/文字的样式在哪里定义Q?/SPAN>
q种包装cd来源?Microsoft?。ƈ没有M规范来定义这个类型；因此虽然q个cd是一个好东西Q但不幸的是Qؓ(f)了与 Microsoft 和其他公司的实现q行互操作，现在惟一的选择是Ҏ(gu) Microsoft WSDL 的输出来猜测它是如何工作的。该模式已经出现了一D|_(d)q且业界也很好的理解了它Q虽然该模式在例子中是非常明昄Q但是也有一些内容不够清晰。我们希望一个独立的l织比如 WS-I 来帮助稳定和标准化这一模式?/P>
Z么不始终采用文档/文字包装的样?/SPAN>
xQ本文已l给了?zhn)q样的一个印象，文档/文字包装的样式是最好的Ҏ(gu)。而实际的情况往往实如此。不q，仍然存在着一些情况，在这些情况下Q?zhn)最好是换一U别的样式?/P>
采用文档/文字非包装的样式的理?/SPAN>
如果(zhn)已l重载了操作Q就不能采用文档/文字包装的样式?/P>
惌一下，除了我们一直在使用的方法之外，q有另一U方法，请参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 10?/P>清单 10. 用于文档/文字包装的有问题的方?/B>
public void myMethod(int x, float y);
public void myMethod(int x);
|
|
关于重蝲的操作的注意事项
WSDL 2.0 不会(x)允许重蝲的操作。这对于一?I xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">允许该操作的语言Q比?JavaQ来说是不幸的。一些规范（比如 JAX-RPCQ将不得不定义一个名U{换模式（name mangling schemeQ来重载的Ҏ(gu)映射?WSDL 中。WSDL 2.0 只不q将问题?WSDL-to-SOAP 映射转移?WSDL-to-language 映射中?/P> |
WSDL 允许重蝲的操作。但是当你向 WSDL 上添加包装模式的时候，需要元素有与操作相同的名称Qƈ且在 XML 中不能有两个名称相同的元素。所以?zhn)必须采用文?文字非包装的样式或某U?RPC 样式?/P>
采用 RPC/文字的样式的理由
׃文档/文字非包装的样式没有提供操作名，所以在有些情况下，(zhn)将需要采用某U?RPC 样式。比如说清单 11 中的一l方法?/P>
清单 11. 用于文档/文字非包装的样式的问题方?/B>
public void myMethod(int x, float y);
public void myMethod(int x);
public void someOtherMethod(int x, float y);
|
现在假设你的服务器接收到了文?文字?SOAP 消息Q你可以回头看一?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 7。服务器应该发送哪一U方法呢Q所有?zhn)能确切知道的是Q它一定不?myMethod(int x)Q因为消息有两个参数Q而这U方法只需要一个参数。它可能是其他两U方法中的一U。采用文?文字的样式，(zhn)没有办法知道是哪一U方法?/P>
假定服务器接收到一?RPC/文字的消息，而不是文?文字的消息，?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 5 所C。对于这U消息，服务器很Ҏ(gu)军_把它发送到哪一U方法。你知道该操作名U是 myMethodQƈ且你知道你有两个参数Q因此肯定是 myMethod(int x, float y)?/P>
采用 RPC/~码的理?/SPAN>
使用 RPC/~码样式最重要的原因是Z数据图表。设想你有一个二q制?wi)，?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 12 所C?/P>清单 12. 二进制树(wi)节点 schema
<complexType name="Node">
<sequence>
<element name="name" type="xsd:string"/>
<element name="left" type="Node" xsd:nillable="true"/>
<element name="right" type="Node" xsd:nillable="true"/>
</sequence>
</complexType>
|
Ҏ(gu)q种节点定义Q你可以构徏一个树(wi)Q其根节?-- A -- 通过?右链接指向节?BQ参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">?1Q?/P>
?1. ~码?wi)?/B>
![~码?src="http://www-128.ibm.com/developerworks/cn/webservices/ws-whichwsdl/encodedtree.jpg"]()
发送数据图表的标准方式是?href 标签Q它?RPC/~码的样式（清单 13Q的一部分?/P>清单 13. RPC/~码的二q制?/B>
<A>
<name>A</name>
<left href="12345"/>
<right href="12345"/>
</A>
<B id="12345">
<name>B</name>
<left xsi:nil="true"/>
<right xsi:nil="true"/>
</B>
|
在Q何文字样式中Qhref 属性都是不可用的，q样囑Ş链接׃再v作用了（参阅清单 14 ??2Q。你仍然有一个根节点 AQ其指向左边的节?B和右边的另一个节?B。这些节?B 都是一L(fng)Q但是它们不是相同的节点。数据被复制而不是引用两ơ?/P>清单 14. 文字二进制树(wi)
<A>
<name>A</name>
<left>
<name>B</name>
<left xsi:nil="true"/>
<right xsi:nil="true"/>
</left>
<right>
<name>B</name>
<left xsi:nil="true"/>
<right xsi:nil="true"/>
</right>
</A>
|
?2. 文字?/B>
![文字?src="http://www-128.ibm.com/developerworks/cn/webservices/ws-whichwsdl/literaltree.jpg"]()
在文字样式中Q?zhn)可以通过各种Ҏ(gu)构造图表，但是却没有标准的Ҏ(gu)Q所以?zhn)做的M事情很可能不能与|络中其他端点上的服务进行互操作?/P>
SOAP 响应消息
到目前ؓ(f)止我已经讨论了请求消息。但是响应消息呢Q它们是怎样的呢Q现在你应该很清楚一个文?文字消息的响应消息应该是怎样的?CODE>soap:body 的内Ҏ(gu)?schema 定义的，因此你所需要做的就是查看该 schema 来了解响应消息的内容。比如，参?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 15 来查?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 8 中的 WSDL 文g的响应消息?/P>清单 15. 用于 myMethod 的文?文字包装的响?SOAP 消息
<soap:envelope>
<soap:body>
<myMethodResponse/>
</soap:body>
</soap:envelope>
|
但是用于 RPC 样式响应?soap:body 的子元素是什么呢QWSDL 1.1 规范q不是很清楚。但?WS-I 解决了这个问题。WS-I ?Basic Profile 指明了在 RPC/文字响应消息中，soap:body 子元素的名称是?.. 相应?wsdl:operation 名称加上字符?'Response' 作ؓ(f)后缀。”奇怪！q正是常规包装模式的响应元素的名U。因?A xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">清单 15 可以应用?RPC/文字消息和文?文字包装的消息。（因ؓ(f) RPC/~码q不是遵?WS-I 的，W(xu)S-I Basic Profile q不兛_ RPC/~码的响应是怎样的，但是你可以假讑ֺ用在q里的约定也可以应用在其他Q何地斏V）(j)因此响应消息的内容ƈ不神U?/P>
l束?/SPAN>
q里有四U绑定样式（其实是五个，但是文档/~码的样式是没有意义的）(j)。虽然每U样式都有自q用处Q但是在大多数情况下Q最好的样式是文?文字包装的样式?/P>
参考资?
关于作?/SPAN>
Russell Butek ?IBM 的一?Web 服务N。他?IBM WebSphere Web 服务引擎的开发h员之一。他也是 JAX-RPC Java Specification Request QJSRQ?专家l的 IBM 代表。他从事 Apache ?AXIS SOAP 引擎的实现方面的研究Q推动了 AXIS 1.0 遵@ JAX-RPC 1.0。以前，他是 IBM CORBA ORB 的开发h员和许多 OMG 特别工作l的 IBM 代表Q包括可UL拦截器特别工作组Q他是这个特别工作组的主席）(j)、核心特别工作组以及(qing)互操作性特别工作组。你可以通过 butek@us.ibm.com 与他联系?/TD> |
