可互操作的基于 Web 分布式應用程序的思想并非新近出現(xiàn)。僅舉一例，電子數(shù)據(jù)交換（EDI）市場需求早在 B2B 在線電子商務獲得任何有意義的實現(xiàn)之前就存在了 ― 并且隨著 B2B 電子市場的普及，互操作性已經(jīng)成為最迫切的 EDI 需求。
以任何在線電子市場為例。存在著許多企業(yè)，各自提供特有的“服務（ services ）”（讓我們稱之為“Web 服務（ Web services ）”）。在當今的電子商務中，尚不存在一種機制，使一個業(yè)務能自動發(fā)現(xiàn)其預期伙伴提供的服務。所謂的 下一代 .com還是提供這種自動的發(fā)現(xiàn)機制。
什么是 WSDL？
這種新的 .com 需要一種解決方案來描述它所提供的服務（Web 服務）。具體而言，這意味著您需要一種格式或某種類型的語法，使您可以通過使用它們來描述下列問題的答案：
您的在線業(yè)務提供什么服務？
您如何調(diào)用業(yè)務服務？
當用戶調(diào)用您的業(yè)務服務時，該業(yè)務服務需要他／她提供什么信息？
用戶將如何提供這些必需信息？
服務將以什么格式發(fā)送返回給用戶的信息？
很幸運，WSDL 提供了完成所有這些作業(yè)的機制。
WSDL 和 SOAP
為更好理解 WSDL 是如何工作的，我將首先描述 SOAP 和 HTTP 是如何使用 WSDL 工作的。WSDL 的用途是“描述”您的 Web 服務。業(yè)務之間將通過交換 WSDL 文件來理解對方的服務。一旦知道您伙伴的服務并希望調(diào)用它們，SOAP 就派上用場了。可以將服務看作是通過 SOAP 訪問的對象。
最有可能的情況是，您將通過因特網(wǎng)或電子郵件與潛在伙伴通信。當然，因特網(wǎng)使用 HTTP 而電子郵件以 SMTP 方式工作，這使得 HTTP 和 SMTP 成為作為 SOAP 的“傳輸服務提供者”的有利候選人。
WSDL 編寫
現(xiàn)在，我將講述為 Web 服務編寫 WSDL 的過程。目的是公開現(xiàn)有的 Web 服務。您所處的情況也許就是下列情況之一：
您有一個現(xiàn)存的服務（例如，一個網(wǎng)站），并希望表示它的功能性。
您有一個 WSDL，并且希望依照已經(jīng)決定表示的功能性來實現(xiàn) Web服務器端的邏輯。（有些人也許會認為這是一個不可能的方案，但是 UDDI 的指紋概念使它變得極為可能；我將在本系列的第四部分討論 UDDI）。
您正在從零開始，并且既無網(wǎng)站又無 WSDL 界面。
本文中所涵蓋的信息適用于這些可能性中的任意一種或全部。
WSDL 編寫的四個步驟
我將把 WSDL 編寫分成四個簡單步驟。遵循每個步驟，您的 Web 服務將準備就緒用于部署。
步驟 1：服務接口
您將構(gòu)建一個移動電話銷售公司的服務接口作為樣本項目（我將這個服務稱為 MobilePhoneService ）。該公司銷售不同型號的移動電話，所以公司 Web 服務的后端數(shù)據(jù)存儲庫中將包含一個具有兩列（ model number 和 price ）的表格。（為了將焦點保持在 WSDL 本身，我保持該表格的簡單性）。有兩個關(guān)于要使用 WSDL 表示的服務的方法：
getListOfModels ()
getPrice (modelNumber)
GetListOfModels 方法提供了一個字符串數(shù)組，其中每個字符串表示一種移動電話的型號。 GetPrice 獲得型號，然后返回它的價格。WSDL 將這些方法作為操作調(diào)用。現(xiàn)在將開始構(gòu)建“WSDL 接口文件（ WSDL interface file ）”。
每個 WSDL 文件的根元素都是 <definitions> ，必須在其中提供服務的完整描述。首先，必須在 <definitions> 元素中提供各種名稱空間的聲明。三個必須做的外部名稱空間聲明是 WSDL、SOAP 和 XSD（XML 模式定義）。還有一個名稱空間 ― TNS，它指您的 MobilePhoneService（這表示 TNS（targetNamespace 的縮寫）包含專為 MobilePhoneService 定義的所有元素和屬性的名稱）。但是 WSDL 是您將在 WSDL 編寫中使用得最多的主要名稱空間。在本系列文章中使用到其它名稱空間時，我將提到它們的效用。
關(guān)于名稱空間只要注意一點：WSDL 廣泛地使用名稱空間這一概念。我鼓勵您到 W3C 的官方網(wǎng)站去學習關(guān)于名稱空間的更多知識（請參閱 參考資料）。WSDL 是這種思想的一種實現(xiàn)，因為名稱空間提供了無限的靈活性，而這恰恰是用于電子數(shù)據(jù)交換的可移植格式所需要的。
<definitions> 元素包含一個或多個 <portType> 元素，實際上，每個元素都是您希望表示的一系列 operation 。或者，您也可以將單個 portType 元素看作是將各種方法組成類的一個邏輯分組。例如，如果您的供應鏈管理解決方案需要在客戶和供應商之間進行交互，您最可能做的是分別定義與他們交互的功能性；也就是說，您將為用戶和供應商各定義一個 portType。應該將每個 portType 稱為 服務，因此整個 WSDL 文件將成為一個服務集合。
必須為每個服務提供一個名稱。在本例中，僅有一個服務（因此只有一個 <portType> ）。 需要使用該 portType 元素的 name 屬性為移動電話銷售服務指定名稱。
在每個服務內(nèi)可以有幾個方法、或者 operation ，WSDL 通過 <operation> 元素來引用它們。樣本應用程序有兩個要表示的方法： getListOfModels 和 getPrice 。因此，您需要提供兩個 <operation> 元素，每個元素有一個 name 。 我已經(jīng)使用 <operation> 元素的 name 屬性命名了每個操作。
此時，WSDL 文件看上去象 清單 1。
清單 1：定義操作
1
<?xml version="1.0" encoding="UTF-8" ?>
2<definitions name="MobilePhoneService"
3 targetNamespace="www.mobilephoneservice.com/MobilePhoneService-interface"
4 xmlns="http://schemas.xmlsoap.org/wsdl/"
5 xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
6 xmlns:tns="http://www.mobilephoneservice.com/MobilePhoneService"
7 xmlns:xsd="http://www.w3.org/1999/XMLSchema">
8 <portType name="MobilePhoneService_port">
9 <operation name="getListOfModels ">
10 
.
11 .
12 </operation>
13 <operation name="getPrice">
14 .
15 .
16 </operation>
17 </portType>
18</definitions>
19
步驟 2：指定參數(shù)
Listing 2: Defining parameters
1<?xml version="1.0" encoding="UTF-8" ?>
2<definitions name="MobilePhoneService"
3targetNamespace="http://www.mobilephoneservice.com/MobilePhoneService-interface"
4xmlns="http://schemas.xmlsoap.org/wsdl/"
5xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
6xmlns:tns="http://www.mobilephoneservice.com/MobilePhoneService"
7xmlns:xsd="http://www.w3.org/1999/XMLSchema">
8<types>
9<xsd:schema targetNamespace="http://www.mobilephoneservice.com/MobilePhoneService"
10xmlns="http://www.w3.org/1999/XMLSchema/">
11<xsd:complexType name="Vector">
12<xsd:element name="elementData" type="xsd:String" />
13<xsd:element name="elementCount" type="xsd:int" />
14</xsd:complexType>
15</xsd:schema>
16</types>
17<message name="ListOfPhoneModels">
18<part name="models" type="tns:Vector">
19</message>
20<message name="PhoneModel">
21<part name="model" type="xsd:String">
22</message>
23<message name="PhoneModelPrice">
24<part name="price" type="xsd:String">
25</message>
26<portType name="MobilePhoneService_port">
27<operation name="getListOfModels ">
28<output message="ListOfPhoneModels"/>
29</operation>
30<operation name="getPrice">
31<Input message="PhoneModel"/>
32<output message="PhoneModelPrice"/>
33</operation>
34</portType>
35</definitions>
36
定義好操作（或方法）以后，現(xiàn)在需要指定將向它們發(fā)送和從它們返回的參數(shù)。在 WSDL 術(shù)語中，所有參數(shù)稱為“消息”。認為您是在遞送消息而結(jié)果得到返回的消息是有用的。方法調(diào)用是這樣一種操作：它準備返回“消息”來響應進入的消息。
請回憶，在第一步驟中有兩個操作要表示。第一個操作 getListOfModels 不必獲得任何參數(shù)并且返回一個字符串數(shù)組，其中每個字符串表示移動電話的型號。因此，必須定義一個包含字符串數(shù)組的 <message> 元素。
看看 清單 2 中的各種 <message> 元素。其中的第一個元素有一個等于 ListOfPhoneModels 的名稱屬性（該消息的邏輯名稱），以及名稱為 models 的單個 <part> 元素，這意味著該 ListOfPhoneModels 是一個“只含有一個 part 的”消息，其中僅有的這個 part 的名稱是“models”。消息可以有任意多個 part ― 只要為它們起不同的名稱，以唯一標識。
我已包括了 <part> 元素的另一個屬性，它就是 type 。將這個“type”屬性當作 C++ 或 Java 中的數(shù)據(jù)類型。我已經(jīng)將 models 的數(shù)據(jù)類型指定為 tns：Vector。（請回憶，我在 <definitions> 根元素中指定了一些名稱空間，其中之一是 tns 。）這個類型即指 MobilePhoneService 名稱空間。這意味著當編寫 WSDL 時，您可以創(chuàng)建自己的名稱空間。現(xiàn)在您也許會問兩個邏輯問題：為什么？和怎么做？
要回答 為什么，讓我們以 getListOfModels 操作返回的字符串數(shù)組為例。WSDL 使用 XML 模式定義（XSD）定義的一些原始數(shù)據(jù)類型（諸如 int、float、long、short、byte、string、Boolean 等等），并允許您直接使用它們，或者以這些原始數(shù)據(jù)類型構(gòu)建復雜數(shù)據(jù)類型后，在消息中使用它們。這就是為什么當引用復雜數(shù)據(jù)類型時，您需要定義自己的名稱空間。在本例中，需要為 array of strings 構(gòu)建一個復雜數(shù)據(jù)類型。
現(xiàn)在來看 怎么做問題，您將使用 XSD 創(chuàng)建自己的名稱空間。為實現(xiàn)這個目的，我在 <types> 元素中使用了 xsd：complexType 元素用來定義稱為 Vector 的數(shù)據(jù)類型。 Vector 使用兩個原始數(shù)據(jù)類型：string（元素數(shù)據(jù)）和 Integer（元素計數(shù)）。因此， Vector 成為名稱空間的一部分并可以通過別名 tns 來引用。
在 清單 2 中，我以類似的方式定義了另外兩個消息 PhoneModel 和 PhoneModelPrice 。這兩個消息只使用了 xsd 名稱空間中的原始數(shù)據(jù)類型 string，因此您不必為使用它們而定義任何更復雜的數(shù)據(jù)類型。
您也許已經(jīng)注意到當創(chuàng)建 <message> 元素時，沒有指定這些消息是進入?yún)?shù)還是返回值。這是一個您將在 <portType> 元素內(nèi)的 <operation> 元素中完成的工作。因此，正如您在 清單 2 中所看到的，我已經(jīng)將 <input> 和 <output> 元素都添加到這兩個操作中。每個 input 元素通過消息名來引用它并將它當作用戶調(diào)用該操作時要提供的參數(shù)。類似地，每個 <output> 元素引用一個消息；它將該消息當作操作調(diào)用的返回值。
至今， 清單 2準確地限定了目前的討論的范圍。
步驟 3：消息傳遞和傳輸
我以一種抽象方式定義了操作和消息，而不考慮實現(xiàn)的細節(jié)。實際上，WSDL 的任務是定義或描述 Web 服務，然后提供一個對外部框架的引用來定義 WSDL 用戶將如何實現(xiàn)這些服務。可以將這個框架當作 WSDL 抽象定義和它們的實現(xiàn)之間的“綁定（ binding ）”。
當前，最流行的綁定（ binding ）技術(shù)是使用簡單對象訪問協(xié)議（SOAP）。WSDL 將指定能夠訪問 Web 服務實際實現(xiàn)的 SOAP 服務器，并且從那時起 SOAP 的整個任務就是將用戶從 WSDL 文件帶到它的實現(xiàn)。SOAP 是本系列文章中下一部分的主題，所以我將暫時避免討論 SOAP 細節(jié)而繼續(xù)集中講述 WSDL 編寫。
WSDL 編寫的第三個步驟是描述將 SOAP 與 WSDL 文件綁定到一起的過程。您將把 <binding> 元素包括到 <definitions> 元素內(nèi)。這個 binding 元素應該有 name 和 type 屬性。 name 將標識這個綁定而 type 將標識您希望與這個綁定相關(guān)聯(lián)的 portType（一組操作）。在 清單 3 中，您會發(fā)現(xiàn) <portType> 元素的 name 與 <binding> 元素的 type 屬性值相匹配。
WSDL binding 元素包含您將用于綁定用途的外部技術(shù)的聲明。因為正在使用 SOAP，所以這里將使用 SOAP 的名稱空間。WSDL 術(shù)語中，對外部名稱空間的使用稱為 extensibility 元素。
在 清單 3 中，您將看見一個空的 <soap:binding/> 元素。該元素的用途是聲明將把 SOAP 作為綁定和傳輸服務使用。
<soap:binding> 元素有兩個屬性：style 和 transport。style 是一個可選屬性，它描述該綁定內(nèi)操作的性質(zhì)。transport 屬性指定 HTTP 作為該綁定將使用的級別較低的傳輸服務。
SOAP 客戶機將從 WSDL 文件中讀取 SOAP 結(jié)構(gòu)并與另一端的 SOAP 服務器協(xié)調(diào)，所以必須特別關(guān)注 interoperability 。我打算在本系列文章的第三部分詳細講述該問題。
在空的 <soap:binding/> 元素后面，有兩個 WSDL <operation> 元素，分別表示步驟 1 的操作。每個 <operation> 元素提供各自操作的綁定細節(jié)。因此，我提供了另一個 extensibility 元素，即 <soap:operation/> （仍然是一個空元素，與它發(fā)生的那個操作相關(guān)）。該 <soap:operation/> 元素有一個 soapAction 屬性，SOAP 客戶機將使用該屬性創(chuàng)建 SOAP 請求。
請回憶步驟 2 中， getListOfModels 操作只有輸出而無任何輸入。因此，必須為該操作提供一個 <output> 元素。該輸出包含 <soap:body/> 元素（仍然是一個空元素，與它發(fā)生的那個操作相關(guān)）。SOAP 客戶機需要該信息來創(chuàng)建 SOAP 請求。 <soap:body/> 的名稱空間屬性值應該與您將部署到 SOAP 服務器上的 service 的名稱相對應，SOAP 服務器將在在本系列文章的下一部分中講述。
您已幾乎要完成步驟 3 了。只要將下一個操作復制到這個操作的后面，您將完成 清單 3。
步驟 4：概括
您已經(jīng)生成了一個完整描述服務 interface 的 WSDL 文件。現(xiàn)在，WSDL 需要一個附加步驟來創(chuàng)建該 WSDL 文件的概要。WSDL 將該文件稱為 implementation 文件，在本系列文章的第四部分中，當您在 UDDI 注冊中心發(fā)布 Web 服務時，會使用它。請看 清單 4― 這個 WSDL 實現(xiàn)文件。它的主要特性如下：
除了
清單 4（實現(xiàn)文件）引用不同的 targetNamespace 去引用實現(xiàn)文件以外， <definitions> 根元素和 清單 3（WSDL 接口文件）中的完全相同。
有一個
<import> 元素，該元素引用 清單 3的接口文件（文件名 MobilePhoneService-interface.wsdl）和它的名稱空間。
有一個
<service> 標記，其中有一個表示該服務的邏輯名 name 。在 service 元素內(nèi)有一個引用在 清單 3中創(chuàng)建的 SOAP 綁定的 port 元素。
將 IBM 的 Web Services ToolKit（WSTK）用于 WSDL 編寫
現(xiàn)在，Web 服務已經(jīng)完全就緒用于部署。我已經(jīng)展示了如何手工創(chuàng)建這些文件（使用象 emacs 這樣的簡單文本編輯器）。可以使用諸如 IBM 的 WSTK（請參閱 參考資料以獲得該工具箱以及本文提到的其它參考資料的鏈接）之類的 Web 服務編寫工具來生成相同的這些文件。
WSTK 可以使用向?qū)椭^程來生成這些文件。用戶可以生成與我在以上教程中演示的同樣兩種方法的 WSDL 文件，并將 WSTK 文件和 清單 3和 4中的 WSDL 文件作比較。
您將注意到下列差異：
WSTK
依照邏輯規(guī)則創(chuàng)建了所有名稱屬性；在本示例中，我使用了自己視為方便的名稱。
WSTK 為每個操作至少生成一個 input
標記，即使該操作不必獲得任何輸入。 listAllPhoneModels 操作沒有任何 input 元素，但是如果使用 WSTK 生成相同文件，它將因為包含這個方法的一個空 input 元素。
WSTK 產(chǎn)生了除已生成的兩個文件以外的第三個文件。這第三個文件是
SOAP 引擎用于服務部署的 SOAP 部署描述符。我將在本系列文章中討論服務部署。
在這部分中，我演示了手工進行 WSDL 編寫以創(chuàng)建接口和實現(xiàn)文件，并與 IBM 的 Web Services ToolKit 生成的文件作了比較。在本系列的下一部分中，我將討論在 SOAP 服務器上部署這個 WSDL 服務。