WSDL文件詳解（下）

發(fā)布時(shí)間：2008-07-14 閱讀數(shù)：次來(lái)源：網(wǎng)樂(lè)原科技

在本文寫(xiě)作時(shí)，並無(wú)任何 SOAP 實(shí)作，能進(jìn)行作業(yè)名稱(chēng)的多載動(dòng)作。這對(duì)使用 Java 的客戶(hù)端是很重要的，因?yàn)槭褂?Java 的伺服端所使用的介面，會(huì)利用 Java 的多載功能。但這對(duì)使用 COM 的客戶(hù)端倒無(wú)所謂，因?yàn)?COM 並不支援多載。

<binding> 與 <operation> 元素
Binding 區(qū)段是，指定通訊協(xié)定、序列化、與編碼的地方。若 Types、Messages、與 PortType 等區(qū)段負(fù)責(zé)抽象的資料內(nèi)容，那麼 Binding 區(qū)段便負(fù)責(zé)處理資料傳輸?shù)木唧w細(xì)節(jié)。Binding 區(qū)段負(fù)責(zé)使前三個(gè)區(qū)段的抽象具體化。

將繫結(jié)規(guī)格從資料與訊息宣告中分離出來(lái)的意義是，執(zhí)行相同業(yè)務(wù)的服務(wù)提供者，可將一組作業(yè) (portType) 標(biāo)準(zhǔn)化。若欲凸顯自身的差異，每個(gè)提供者可另外提供自訂繫結(jié)。讓 WSDL 擁有匯入 construct 是有好處的；因?yàn)槿绱艘粊?lái)，即可遠(yuǎn)離 Bindings 與 Services 區(qū)段，將抽象定義置於自身的檔案中；並可將其散佈於服務(wù)提供者間，讓他們把抽象定義設(shè)定成標(biāo)準(zhǔn)。例如，銀行可標(biāo)準(zhǔn)化，一組抽象 WSDL 文件詳盡說(shuō)明的銀行作業(yè)。但每家銀行還是可以自由地，「自訂」基礎(chǔ)通訊協(xié)定、序列最佳化、與編碼。

下列為 Binding 區(qū)段的 WSDL 多載範(fàn)例，於此重複以方便詳細(xì)討論：

<binding> 元素會(huì)有個(gè)名稱(chēng) (本例中為「fooSampleBinding」)，以方便 Services 區(qū)段的 <port> 元素參照。它有個(gè)參照 <portType> 的「type」屬性，在本例中為「wsdlns:fooSamplePortType」。第二行是 MSTK2 擴(kuò)充元素 <stk:binding>，它可指定 preferredEncoding，或稱(chēng)「UTF-8」。

<soap:binding> 元素可指定，使用的樣式 (rpc) 與傳輸。傳輸屬性會(huì)參照命名空間，以確定所使用的 HTTP SOAP 通訊協(xié)定。

有兩個(gè) <operation> 元素具有相同的名稱(chēng)「foo」。這兩個(gè)作業(yè)不同之處在於，兩個(gè)不同的 <input> 名稱(chēng)：「foo1」與「foo2」。在兩個(gè) <operation> 元素中，<soap:operation> 元素的「soapAction」屬性皆相同，都是一個(gè) URI。soapAction 屬性是 SOAP 專(zhuān)屬的 URI，並逐字依 SOAP 訊息使用。以此方式取得的 SOAP 訊息，會(huì)有個(gè) SOAPAction 標(biāo)頭；而且還會(huì)以 <soap:operation> 元素中的 URI 為其值。雖然 HTTP 繫結(jié)需要 soapAction 屬性，但非 HTTP 繫結(jié)則不用。本文刊出時(shí)，其用途仍然不明。就本範(fàn)例而言，它似乎可用來(lái)區(qū)別兩個(gè)不同的「foo」作業(yè)。SOAP 1.1 宣稱(chēng)，soapAction 可用來(lái)識(shí)別訊息的「目的 (intent)」。它更建議伺服端，可用此屬性路由訊息，而不用剖析整個(gè)訊息。實(shí)務(wù)上，其用途差異很大。<soap:operation> 元素也可以含另一個(gè)名為「style」的屬性；若特定作業(yè)需要覆寫(xiě) <soap:binding> 元素中所指定的樣式，則可使用此屬性。

<operation> 元素所含的 <input>、<output>、與 <fault> 元素，可對(duì)應(yīng) PortTypes 區(qū)段的相同元素。在上例中出現(xiàn)的只有 <input> 元素。在本例中，這三個(gè)元素都各有一個(gè)選擇性的「name」屬性，可用以區(qū)別名稱(chēng)相同的作業(yè)。在範(fàn)例的 <input> 元素中，有個(gè) <soap:body> 元素，它可指定輸入結(jié)果 SOAP 訊息之 <body> 的內(nèi)容。此元素有下列屬性：

Use
它是用以指定資料採(cǎi)「編碼 (encoded)」或「常值 (literal)」?！赋Ｖ怠沟囊饬x是，結(jié)果 SOAP 訊息所含資料的格式，完全依照抽象定義 (Types、Messages、與 PortTypes 區(qū)段) 的指定規(guī)格。「編碼」的意義是，「encodingStyle」屬性 (參考下文) 會(huì)指定編碼方式。
Namespace
每個(gè) SOAP 訊息的主體，都有自己的命名空間，以防止名稱(chēng)衝突。此屬性所指定的 URI，會(huì)逐字使用於結(jié)果 SOAP 訊息之中。
EncodingStyle
以 SOAP 的編碼方式而言，URI 的值應(yīng)該是「http://schemas.xmlsoap.org/soap/encoding」。
文件樣式繫結(jié)
在上一區(qū)段中，<soap:binding> 元素有個(gè)類(lèi)型屬性被設(shè)定成「rpc」。若將此屬性設(shè)定成「document」，即可改變訊息在線(xiàn)上的排序。此時(shí)這些訊息便成了文件傳輸，而不再是函數(shù)簽章。在此繫結(jié)類(lèi)型中，<message> 元素是定義文件格式，而非函數(shù)簽章。請(qǐng)參考下例中的 WSDL 片段：

<message...>
<part name='p1' type="stns:CompositeType"/>
<part name='p2' type="xsd:int"/>
<part name='p3' element="stns:SimpleElement"/>
<part name='p4' element="stns:CompositeElement"/>
</message>
?</definitions>

此結(jié)構(gòu)描述有 SimpleElement 與 CompositeElement 兩個(gè)元素，以及一個(gè)宣告類(lèi)型 (CompositeType)。所宣告的唯一 <message> 元素有四個(gè)部分 (part)：p1 是 CompositeType 類(lèi)型；p2 是 int 類(lèi)型；p3 是 SimpleElement；而 p4 是 CompositeElement。下表是四種繫結(jié)的比較，依照「使用/類(lèi)型」分別為：rpc/literal、document/literal、rpc/encoded、與 document/encoded。本表可說(shuō)明，每種繫結(jié)方式反映在線(xiàn)上的實(shí)際情況。

rpc / literal
<operation name="method1" style="rpc" ...>
<input>
<soap:body parts="p1 p2 p3 p4"
use="literal"
namespace="(MessageNS)"/>
</input>
</operation>

線(xiàn)上情形：
<soapenv:body... xmlns:mns="(MessageNS)"
xmlns:stns="(SchemaTNS)">
<mns:method1>
<mns:p1>
<stns:a>123</stns:a>
<stns:b>hello</stns:b>
</mns:p1>
<mns:p2>123</mns:p2>
<mns:p3>

<stns:SimpleElement>

123

</stns:SimpleElement>
</mns:p3>
<mns:p4>
<stns:CompositeElement>
<stns:a>123</stns:a>
<stns:b>hello</stns:b>
</stns:CompositeElement>
</mns:p4>
</mns:method1>
</soapenv:body>
document / literal / type=
<operation name="method1"
style="document" ...>
<input>
<soap:body parts="p1" use="literal">
</input>
</operation>

線(xiàn)上情形：

<soapenv:body... xmlns:stns="(SchemaTNS)">
<stns:a>123</stns:a>
<stns:b>hello</stns:b>
</soapenv:body>

rpc / encoded
<operation name="method1" style="rpc" ...>
<input>
<soap:body parts="p1 p2" use="encoded"
encoding=
"http://schemas.xmlsoap.org/soap/encoding/"
namespace="(MessageNS)"/>
</input>
</operation>

線(xiàn)上情形：
<soapenv:body... xmlns:mns="(MessageNS)">
<mns:method1>
<p1 TARGET="_self" HREF="#1"/>
<p2>123</p2>
</mns:method1>
<mns:CompositeType id="#1">
<a>123</a>
<b>hello</b>
</mns:CompositeType>
</soapenv:body>
document / literal / element=
<operation name="method1"
style="document" ...>
<input>
<soap:body parts="p3 p4"

use="literal">
</input>
</operation>

線(xiàn)上情形：

<soapenv:body... xmlns:stns="(SchemaTNS)">
<stns:SimpleElement>

123

</stns:SimpleElement>
<stns:CompositeElement>
<stns:a>123</stns:a>
<stns:b>hello</stns:b>
</stns:CompositeElement>
</soapenv:body>

document / encoded
<operation name="method1"
style="document" ...>
<input>
<soap:body parts="p1 p2" use="encoded"
encoding=

"http://schemas.xmlsoap.org/soap/encoding/"
namespace="(MessageNS)"/>
</input>
</operation>

線(xiàn)上情形：
<soapenv:body... xmlns:mns="(MessageNS)">
<mns:CompositeType>
<a>123</a>
<b>hello</b>
</mns:CompositeType>
<soapenc:int>123</soapenc:int>
</soapenv:body>

<service> 與 <port> 元素
服務(wù)即是一組 <port> 元素。每個(gè) <port> 元素，都以一對(duì)一的方式，關(guān)連一個(gè)位置與 <binding>。若有一個(gè)以上的 <port> 元素，與相同的 <binding> 關(guān)連，便可以使用其它 URL 作為替換。

在 WSDL 文件中，可以有一個(gè)以上的 <service> 元素。多個(gè) <service> 元素，可以有許多用途。其中之一便是，根據(jù) URL 的目的地，將傳輸埠群組化。因此，我只要使用另一個(gè) <service>，就可以重新導(dǎo)向所有股票報(bào)價(jià)要求；而且我的客戶(hù)端程式依然可以正常運(yùn)作，這是因?yàn)樵谶@類(lèi)的服務(wù)群組化中，通訊協(xié)定完全不會(huì)更動(dòng)其它的服務(wù)。多個(gè) <service> 服務(wù)的另一個(gè)用途是為了，根據(jù)基礎(chǔ)通訊協(xié)定，對(duì)傳輸埠進(jìn)行分類(lèi)。例如，可將所有的 HTTP 傳輸埠，置於一個(gè) <service>；所有的 SMTP 傳輸埠置於另一個(gè) <service>?？蛻?hù)端便可根據(jù)它能處理的通訊協(xié)定，搜尋相對(duì)的 <service>。

在一份 WSDL 文件中，<service> 的「name」屬性，可區(qū)分出個(gè)別服務(wù)的不同。因?yàn)橐粋€(gè)服務(wù)可能會(huì)有幾個(gè)傳輸埠，所以傳輸埠也必須有「name」屬性。

總結(jié)
本文已經(jīng)說(shuō)明了 WSDL 文件最顯著的 SOAP 特色。但應(yīng)該聲明的是，WSDL 絕不僅只能在 HTTP 上說(shuō)明 SOAP 而已。在說(shuō)明 SOAP 上，WSDL 的表達(dá)能力絕對(duì)足以使用 HTTP-POST、HTTP-GET、SMTP、與其它通訊協(xié)定。只要使用 WSDL，不論是程式開(kāi)發(fā)人員或一般使用者，都可輕鬆處理 SOAP。個(gè)人深信，WSDL 與 SOAP 的結(jié)合，將可引進(jìn)全新的應(yīng)用程式類(lèi)別，以更徹底地利用各種網(wǎng)路服務(wù)。

在 WSDL 的命名空間，有各種 XML 元素。下表整理了這些元素、屬性、與內(nèi)容，以供參考：

元素屬性內(nèi)容 (子項(xiàng))
<definitions> name
targetNamespace
xmlns (其它命名空間) <types>
<message>
<portType>
<binding>
<service>
<types> (無(wú)) <xsd:schema>
<message> name <part>
<portType> name <operation>
<binding> name
type <operation>
<service> name <port>
<part> name
type (空值)
<operation> name
parameterOrder <input>
<output>
<fault>
<input> name
message (空值)
<output> name
message (空值)
<fault> name

message (空值)
<port> name
binding <soap:address>

資源：
WSDL 1.1
SOAP 1.1
XML 結(jié)構(gòu)描述入門(mén)
MS SOAP Toolkit 下載網(wǎng)站
IDL 至 WSDL 的轉(zhuǎn)譯工具
含 WSDL 至 VB 之 Proxy 產(chǎn)生器的免費(fèi)網(wǎng)路資源
PocketSOAP：SOAP 之相關(guān)元件、工具、與原始程式碼