WSDL文件详解（转贴）下
日期：2012-09-24 浏览次数：20465 次
在本文寫作時，並無任何 SOAP 實作，能進行作業名稱的多載動作。這對使用 Java 的客戶端是很重要的，因為使用 Java 的伺服端所使用的介面，會利用 Java 的多載功能。但這對使用 COM 的客戶端倒無所謂，因為 COM 並不支援多載。
<binding> 與 <operation> 元素
Binding 區段是，指定通訊協定、序列化、與編碼的地方。若 Types、Messages、與 PortType 等區段負責抽象的資料內容，那麼 Binding 區段便負責處理資料傳輸的具體細節。Binding 區段負責使前三個區段的抽象具體化。
將繫結規格從資料與訊息宣告中分離出來的意義是，執行相同業務的服務提供者，可將一組作業 (portType) 標準化。若欲凸顯自身的差異，每個提供者可另外提供自訂繫結。讓 WSDL 擁有匯入 construct 是有好處的；因為如此一來，即可遠離 Bindings 與 Services 區段，將抽象定義置於自身的檔案中；並可將其散佈於服務提供者間，讓他們把抽象定義設定成標準。例如，銀行可標準化，一組抽象 WSDL 文件詳盡說明的銀行作業。但每家銀行還是可以自由地，「自訂」基礎通訊協定、序列最佳化、與編碼。
下列為 Binding 區段的 WSDL 多載範例，於此重複以方便詳細討論：
<binding name="fooSampleBinding" type="wsdlns:fooSamplePortType">
<stk:binding preferredEncoding="UTF-8" />
<soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="foo">
<soap:operation soapAction="http://tempuri.org/action/foo1"/>
<input name="foo1">
<soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" />
</input>
</operation>
<operation name="foo">
<soap:operation soapAction="http://tempuri.org/action/foo2"/>
<input name="foo2">
<soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" />
</input>
</operation>
</binding>
<binding> 元素會有個名稱 (本例中為「fooSampleBinding」)，以方便 Services 區段的 <port> 元素參照。它有個參照 <portType> 的「type」屬性，在本例中為「wsdlns:fooSamplePortType」。第二行是 MSTK2 擴充元素 <stk:binding>，它可指定 preferredEncoding，或稱「UTF-8」。
<soap:binding> 元素可指定，使用的樣式 (rpc) 與傳輸。傳輸屬性會參照命名空間，以確定所使用的 HTTP SOAP 通訊協定。
有兩個 <operation> 元素具有相同的名稱「foo」。這兩個作業不同之處在於，兩個不同的 <input> 名稱：「foo1」與「foo2」。在兩個 <operation> 元素中，<soap:operation> 元素的「soapAction」屬性皆相同，都是一個 URI。soapAction 屬性是 SOAP 專屬的 URI，並逐字依 SOAP 訊息使用。以此方式取得的 SOAP 訊息，會有個 SOAPAction 標頭；而且還會以 <soap:operation> 元素中的 URI 為其值。雖然 HTTP 繫結需要 soapAction 屬性，但非 HTTP 繫結則不用。本文刊出時，其用途仍然不明。就本範例而言，它似乎可用來區別兩個不同的「foo」作業。SOAP 1.1 宣稱，soapAction 可用來識別訊息的「目的 (intent)」。它更建議伺服端，可用此屬性路由訊息，而不用剖析整個訊息。實務上，其用途差異很大。<soap:operation> 元素也可以含另一個名為「style」的屬性；若特定作業需要覆寫 <soap:binding> 元素中所指定的樣式，則可使用此屬性。
<operation> 元素所含的 <input>、<output>、與 <fault> 元素，可對應 PortTypes 區段的相同元素。在上例中出現的只有 <input> 元素。在本例中，這三個元素都各有一個選擇性的「name」屬性，可用以區別名稱相同的作業。在範例的 <input> 元素中，有個 <soap:body> 元素，它可指定輸入結果 SOAP 訊息之 <body> 的內容。此元素有下列屬性：
Use
它是用以指定資料採「編碼 (encoded)」或「常值 (literal)」。「常值」的意義是，結果 SOAP 訊息所含資料的格式，完全依照抽象定義 (Types、Messages、與 PortTypes 區段) 的指定規格 。「編碼」的意義是，「encodingStyle」屬性 (參考下文) 會指定編碼方式。
Namespace
每個 SOAP 訊息的主體，都有自己的命名空間，以防止名稱衝突。此屬性所指定的 URI，會逐字使用於結果 SOAP 訊息之中。
EncodingStyle
以 SOAP 的編碼方式而言，URI 的值應該是「http://schemas.xmlsoap.org/soap/encoding」。
文件樣式繫結
在上一區段中，<soap:binding> 元素有個類型屬性被設定成「rpc」。若將此屬性設定成「document」，即可改變訊息在線上的排序。此時這些訊息便成了文件傳輸，而不再是函數簽章。在此繫結類型中，<message> 元素是定義文件格式，而非函數簽章。請參考下例中的 WSDL 片段：
<definitions
xmlns:stns="(SchemaTNS)"
xmlns:wtns="(WsdlTNS)"
targetNamespace="(WsdlTNS)">
<schema targetNamespace="(SchemaTNS)"
elementFormDefault="qualified">
<element name="SimpleElement" type="xsd:int"/>
<element name="CompositElement" type="stns:CompositeType"/>
<complexType name="CompositeType">
<all>
<element name='a' type="xsd:int"/>
<element name='b' type="xsd:string"/>
</all>
</complexTy
<binding> 與 <operation> 元素
Binding 區段是，指定通訊協定、序列化、與編碼的地方。若 Types、Messages、與 PortType 等區段負責抽象的資料內容，那麼 Binding 區段便負責處理資料傳輸的具體細節。Binding 區段負責使前三個區段的抽象具體化。
將繫結規格從資料與訊息宣告中分離出來的意義是，執行相同業務的服務提供者，可將一組作業 (portType) 標準化。若欲凸顯自身的差異，每個提供者可另外提供自訂繫結。讓 WSDL 擁有匯入 construct 是有好處的；因為如此一來，即可遠離 Bindings 與 Services 區段，將抽象定義置於自身的檔案中；並可將其散佈於服務提供者間，讓他們把抽象定義設定成標準。例如，銀行可標準化，一組抽象 WSDL 文件詳盡說明的銀行作業。但每家銀行還是可以自由地，「自訂」基礎通訊協定、序列最佳化、與編碼。
下列為 Binding 區段的 WSDL 多載範例，於此重複以方便詳細討論：
<binding name="fooSampleBinding" type="wsdlns:fooSamplePortType">
<stk:binding preferredEncoding="UTF-8" />
<soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http"/>
<operation name="foo">
<soap:operation soapAction="http://tempuri.org/action/foo1"/>
<input name="foo1">
<soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" />
</input>
</operation>
<operation name="foo">
<soap:operation soapAction="http://tempuri.org/action/foo2"/>
<input name="foo2">
<soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" />
</input>
</operation>
</binding>
<binding> 元素會有個名稱 (本例中為「fooSampleBinding」)，以方便 Services 區段的 <port> 元素參照。它有個參照 <portType> 的「type」屬性，在本例中為「wsdlns:fooSamplePortType」。第二行是 MSTK2 擴充元素 <stk:binding>，它可指定 preferredEncoding，或稱「UTF-8」。
<soap:binding> 元素可指定，使用的樣式 (rpc) 與傳輸。傳輸屬性會參照命名空間，以確定所使用的 HTTP SOAP 通訊協定。
有兩個 <operation> 元素具有相同的名稱「foo」。這兩個作業不同之處在於，兩個不同的 <input> 名稱：「foo1」與「foo2」。在兩個 <operation> 元素中，<soap:operation> 元素的「soapAction」屬性皆相同，都是一個 URI。soapAction 屬性是 SOAP 專屬的 URI，並逐字依 SOAP 訊息使用。以此方式取得的 SOAP 訊息，會有個 SOAPAction 標頭；而且還會以 <soap:operation> 元素中的 URI 為其值。雖然 HTTP 繫結需要 soapAction 屬性，但非 HTTP 繫結則不用。本文刊出時，其用途仍然不明。就本範例而言，它似乎可用來區別兩個不同的「foo」作業。SOAP 1.1 宣稱，soapAction 可用來識別訊息的「目的 (intent)」。它更建議伺服端，可用此屬性路由訊息，而不用剖析整個訊息。實務上，其用途差異很大。<soap:operation> 元素也可以含另一個名為「style」的屬性；若特定作業需要覆寫 <soap:binding> 元素中所指定的樣式，則可使用此屬性。
<operation> 元素所含的 <input>、<output>、與 <fault> 元素，可對應 PortTypes 區段的相同元素。在上例中出現的只有 <input> 元素。在本例中，這三個元素都各有一個選擇性的「name」屬性，可用以區別名稱相同的作業。在範例的 <input> 元素中，有個 <soap:body> 元素，它可指定輸入結果 SOAP 訊息之 <body> 的內容。此元素有下列屬性：
Use
它是用以指定資料採「編碼 (encoded)」或「常值 (literal)」。「常值」的意義是，結果 SOAP 訊息所含資料的格式，完全依照抽象定義 (Types、Messages、與 PortTypes 區段) 的指定規格 。「編碼」的意義是，「encodingStyle」屬性 (參考下文) 會指定編碼方式。
Namespace
每個 SOAP 訊息的主體，都有自己的命名空間，以防止名稱衝突。此屬性所指定的 URI，會逐字使用於結果 SOAP 訊息之中。
EncodingStyle
以 SOAP 的編碼方式而言，URI 的值應該是「http://schemas.xmlsoap.org/soap/encoding」。
文件樣式繫結
在上一區段中，<soap:binding> 元素有個類型屬性被設定成「rpc」。若將此屬性設定成「document」，即可改變訊息在線上的排序。此時這些訊息便成了文件傳輸，而不再是函數簽章。在此繫結類型中，<message> 元素是定義文件格式，而非函數簽章。請參考下例中的 WSDL 片段：
<definitions
xmlns:stns="(SchemaTNS)"
xmlns:wtns="(WsdlTNS)"
targetNamespace="(WsdlTNS)">
<schema targetNamespace="(SchemaTNS)"
elementFormDefault="qualified">
<element name="SimpleElement" type="xsd:int"/>
<element name="CompositElement" type="stns:CompositeType"/>
<complexType name="CompositeType">
<all>
<element name='a' type="xsd:int"/>
<element name='b' type="xsd:string"/>
</all>
</complexTy
免责声明： 本文仅代表作者个人观点，与爱易网无关。其原创性以及文中陈述文字和内容未经本站证实，对本文以及其中全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。
