WSDL中文版——详解
為什么使用WSDL?
像Internet協(xié)議之類的標準有沒有為權威所利用，或者人們這樣看待它是因為順之所獲的好處遠遠超出了代價？曾經(jīng)有許多試圖建立的標準都流產(chǎn)了。有時候，那些還沒有普遍使用的標準甚至由法令或政府規(guī)定強行推出：Ada語言就是一例。
我相信正是跟隨標準所帶來的好處使它廣泛接受。例如，對于鐵路服務來說，真正重要的是，不同公司所鋪設的鐵路結合到一起，或者是來自好幾個公司的產(chǎn)品協(xié)調(diào)的工作在一起。幾家大的企業(yè)合力建立了SOAP標準。Web Service描述語言(WSDL)向這種Web Service的提供商和用戶推出了方便的協(xié)調(diào)工作的方法，使我們能更容易的獲得SOAP的種種好處。幾家公司的鐵道并在一起不算什么難事，他們所需遵循的只是兩軌間的標準距離。對Web Service來說，這要復雜得多。我們必須先制定出指定接口的標準格式。
曾經(jīng)有人說SOAP并不真需要什么接口描述語言。如果SOAP是交流純內(nèi)容的標準，那就需要一種語言來描述內(nèi)容。SOAP消息確實帶有某些類型信息，因此SOAP允許動態(tài)的決定類型。但不知道一個函數(shù)的函數(shù)名、參數(shù)的個數(shù)和各自類型，怎么可能去調(diào)用這個函數(shù)呢？沒有WSDL，我可以從必備文檔中確定調(diào)用語法，或者檢查消息。隨便何種方法，都必須有人參與，這個過程可能會有錯。而使用了WSDL，我就可以通過這種跨平臺和跨語言的方法使Web Service代理的產(chǎn)生自動化。就像COM和CORBA的IDL文件，WSDL文件由客戶和服務器約定。
注意由于WSDL設計成可以綁定除SOAP以外的其他協(xié)議，這里我們主要關注WSDL在HTTP上和SOAP的關系。同樣，由于SOAP目前主要用來調(diào)用遠程的過程和函數(shù)，WSDL支持SOAP傳輸?shù)奈臋n規(guī)范。WSDL 1.1已經(jīng)作為記錄遞交給W3C（見http://www.w3.org/TR/wsdl.html）
WSDL文檔結構
若要理解XML文檔，將之看作塊狀圖表非常有用。下圖以XML的文檔形式說明了WSDL的結構，它揭示了WSDL文檔五個欄之間的關系。
WSDL文檔可以分為兩部分。頂部分由抽象定義組成，而底部分則由具體描述組成。抽象部分以獨立于平臺和語言的方式定義SOAP消息，它們并不包含任何隨機器或語言而變的元素。這就定義了一系列服務，截然不同的網(wǎng)站都可以實現(xiàn)。隨網(wǎng)站而異的東西如序列化便歸入底部分，因為它包含具體的定義。
l 抽象定義
Types
獨立與機器和語言的類型定義
Messages
包括函數(shù)參數(shù)（輸入與輸出分開）或文檔描述
PortTypes
引用消息部分中消息定義來描述函數(shù)簽名（操作名、輸入?yún)?shù)、輸出參數(shù)）
2 具體定義
Bindings
PortTypes部分的每一操作在此綁定實現(xiàn)
Services
確定每一綁定的端口地址
下面的圖中，箭頭連接符代表文檔不同欄之間的關系。點和箭頭代表了引用或使用關系。雙箭頭代表"修改"關系。3-D的箭頭代表了包含關系。這樣，各Messages欄使用Types欄的定義，PortTypes欄使用Messages欄的定義；Bindings欄引用了PortTypes欄，Services欄引用Bindings欄，PortTypes和Bindings欄包含了operation元素，而Services欄包含了port元素。PortTypes欄里的operation元素由Bindings欄里的operation元素進一步修改或描述。
在此背景中，我將使用標準的XML術語來描述WSDL文檔。Element是指XML的元素，而"attribute"指元素的屬性。于是：
| ＜element attribute="attribute-value"＞contents＜/element＞ |
內(nèi)容也可能由一個或多個元素以遞歸的方式組成。根元素是所有元素之中最高級的元素。子元素總是從屬于另一個元素，父元素。
注意，文檔之中可能只有一個Types欄，或根本沒有。所有其他的欄可以只有零元素、單元素或是多元素。WSDL的列表要求所有的欄以固定的順序出現(xiàn)：import, types, message, portType, binding, service。所有的抽象可以是單獨存在于別的文件中，也可以從主文檔中導入。
|
|
?
WSDL文件示例
讓我們來研究一下WSDL文件，看看它的結構，以及如何工作。請注意這是一個非常簡單的WSDL文檔實例。我們的意圖只是說明它最顯著的特征。以下的內(nèi)容中包括更加詳細的討論。
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
以下是該實例文檔的總述：稍后我將詳細討論每一部分的細節(jié)。
第一行申明該文檔是XML。盡管這并不是必需的，但它有助于XML解析器決定是否解析WSDL文件或只是報錯。第二行是WSDL文檔的根元素：＜definitions＞。一些屬性附屬于根元素，就像＜schema＞子元素對于＜types＞元素。
＜types＞元素包含了Types欄。如果沒有需要聲明的數(shù)據(jù)類型，這欄可以缺省。在WSDL范例中，沒有應用程序特定的types聲明，但我仍然使用了Types欄，只是為了聲明schema namespaces。
＜message＞元素包含了Messages欄。如果我們把操作看作函數(shù)，＜message＞元素定義了那個函數(shù)的參數(shù)。＜message＞元素中的每個＜part＞子元素都和某個參數(shù)相符。輸入?yún)?shù)在＜message＞元素中定義，與輸出參數(shù)相隔離--輸出參數(shù)有自己的＜message＞元素。兼作輸入、輸出的參數(shù)在輸入輸出的＜message＞元素中有它們相應的＜part＞元素。輸出＜message＞元素以"Response"結尾，就像以前所用的"fooResponse"。每個＜part＞元素都有名字和類型屬性，就像函數(shù)的參數(shù)有參數(shù)名和參數(shù)類型。
用于交換文檔時，WSDL允許使用＜message＞元素來描述交換的文檔。
＜part＞元素的類型可以是XSD基類型，也可以是SOAP定義類型(soapenc)、WSDL定義類型(wsdl)或是Types欄定義的類型。
一個PortTypes欄中，可以有零個、單個或多個＜portType＞元素。由于抽象PortType定義可以放置在分開的文件中，在某個WSDL文件中沒有＜portType＞元素是可能的。上面的例子里只是用了一個＜portType＞元素。而一個＜portType＞元素可在＜operation＞元素中定義一個或是多個操作。示例僅使用了一個名為"foo"的＜operation＞元素。這和某個函數(shù)名相同。＜operation＞元素可以有一個、兩個、三個子元素：＜input＞, ＜output＞ 和＜fault＞元素。每個＜input＞和＜output＞元素中的消息都引用Message欄中的相關的＜message＞元素。這樣，示例中的整個＜portType＞元素就和以下的C函數(shù)等效：
| int foo(int arg); |
這個例子足見XML和C相比要冗長的多。（包括＜message＞元素，XML在示例中共使用了12行代碼來表達相同的單行函數(shù)聲明。）
Bindings欄可以有零個、一個或者多個＜binding＞元素。它的意圖是制定每個＜operation＞通過網(wǎng)絡調(diào)用和回應。Services欄同樣可以有零個、一個、多個＜service＞元素。它還包含了＜port＞元素，每個＜port＞元素引用一個Bindings欄里的＜binding＞元素。Bindings和Services欄都包含WSDL文檔。
Namespace
＜definitions＞和子節(jié)點＜schema＞都是namespace屬性：
| ＜definitions name="FooSample" |
每個namespace屬性都聲明了一個縮略語，用在文檔中。例如"xmlns:xsd"就為 http://www.w3.org/2001/XMLSchema定義了一個縮略語（xsd）。這就允許對該namespace的引用只需簡單的在名字前加上前綴就可以了，如："xsd:int"中的"xsd"就是合法的類型名。普通范圍規(guī)則可運用于縮略前綴。也就是說，前綴所定義的元素只在元素中有效。
Namespace派什么用？namespace的作用是要避免命名沖突。如果我建立一項Web Service，其中的WSDL文件包含一個名為"foo"的元素，而你想要使用我的服務與另一項服務連接作為補充，這樣的話另一項服務的WSDL文件就不能包含名為"foo"的元素。兩個服務器程序只有在它們在兩個事例中表示完全相同的東西時，才可以取相同的名字。如果有了表示區(qū)別的namespace，我的網(wǎng)絡服務里的"foo"就可以表示完全不同于另一個網(wǎng)絡服務里"foo"的含義。在你的客戶端里，你只要加以限制就可以引用我的"foo"。
見下例：http://www.infotects.com/fooService#foo 就是完全限制的名字，相當于"carlos:foo"，如果我聲明了carlos作為http://www.infotects.com/fooService的快捷方式。請注意namespace中的URL是用來確定它們的唯一性的，同時也便于定位。URL所指向的地方不必是實際存在的網(wǎng)絡地址，也可以使用GUID來代替或補充URL。例如，GUID"335DB901-D44A-11D4-A96E-0080AD76435D"就是一個合法的namespace指派。
targetNamespace屬性聲明了一個namespace，元素中所有的聲明的名字都列于其內(nèi)。在WSDL示例中，＜definitions＞的targetNamespace 是http://tempuri.org/wsdl。這意味著所有在WSDL文檔中聲明的名字都屬于這個namespace。＜schema＞元素有自己的targetNamespace屬性，其值為 http://tempuri.org/xsd ，在＜schma＞元素中定義的所有名字都屬于這個namespace而不是main的target namespace。
＜schema＞元素的以下這行聲明了默認的namespace。Schema中所有有效的名字都屬于這個namespace。
| xmlns=http://www.w3.org/2001/XMLSchema |
SOAP消息
對于使用WSDL的客戶機和服務機來說，研究WSDL文件的一種方法就是決定什么來接受所發(fā)送的信息。盡管SOAP使用底層協(xié)議，如IP和HTTP等，但應用程序決定了服務器與客戶機之間交互的高級協(xié)議。也就是說，進行一項操作，比如"echoint"把輸入的整數(shù)送回，參數(shù)的數(shù)目、每個參數(shù)的類型、以及參數(shù)如何傳送等因素決定了應用程序特定的協(xié)議。有很多方法可以確定此類協(xié)議，但我相信最好的方法就是使用WSDL。如果我們用這種視角來看待它，WSDL不只是一種接口協(xié)議，而且是一種協(xié)議特定的語言。它就是我們超越"固定"協(xié)議（IP、HTTP等）所需要的應用程序特定協(xié)議。
WSDL可以確定SOAP消息是否遵從RPC或文檔風格。RPC風格的消息（就是示例中所用的）看起來像是函數(shù)調(diào)用。而文檔風格的消息則更普通，嵌套層次更小。下面的XML消息就是示例WSDL文件解析后的發(fā)送/接受效果，解析使用的是MS SOAP Toolkit 2.0（MSTK2）中的SoapClient對象。
從客戶端調(diào)用"foo(5131953)"函數(shù)：
| ＜?xml version="1.0" encoding="UTF-8" standalone="no"?＞ |
兩函數(shù)都調(diào)用了消息，其回應是有效的XML。SOAP消息由幾部分組成，首先是＜Envelop＞元素，包含一個可選的＜Header＞元素以及至少一個＜body＞元素。Rpc函數(shù)所調(diào)用的消息體有一個根據(jù)操作"foo"命名的元素，而回應信息體有一個"fooResponse"元素。Foo元素有一個部分＜arg＞，就和WSDL中描述的一樣，是單參數(shù)的。fooResponse也相應的有一個＜result＞的部分。注意encodingStyle、envelope和message的namespace和WSDL Bindings欄中的預定義的一致，重復如下：
| ＜binding name="SimpleBinding" type="wsdlns:SimplePortType"＞ |
WSDL的Types欄和Messages欄中的XML Schema
WSDL數(shù)據(jù)類型是基于"XML Schema:Datatypes"(XSD)的，現(xiàn)在已經(jīng)被W3C推薦。這一文檔共有三個版本（1999，2000/10，2001），因此必須在namespace屬性的＜definitions＞元素中指明所使用的是哪一個版本。
| xmlns:xsd="http://www.w3.org/2001/XMLSchema" |
在本文中，我將只考慮2001版本。WSDL標準的推薦者強烈建議使用2001版。
在本欄和以后各部分，需使用以下簡縮或前綴
| 前綴 | 代表的Namespace | 描述 |
| Soapenc | http://schemas.xmlsoap.org/soap/encoding | SOAP 1.1 encoding |
| Wsdl | http://schemas.xmlsoap.org/wsdl/soap | WSDL 1.1 |
| Xsd | http://www.w3.org/2001/XMLSchema | XML Schema |
XSD基類型
下表是直接從MSTK2文檔中取出的，列舉了MSTK2所支持的所有XSD基類型。它也告訴在客戶端或服務器端的WSDL讀取程序如何把XSD類型映射到在VB、C++和IDL中相應的類型。
| XSD (Soap)類型 | 變量類型 | VB | C++ | IDL | Comments |
| anyURI | VT_BSTR | String | BSTR | BSTR | ? |
| base64Binary | VT_ARRAY | VT_UI1 | Byte() | SAFEARRAY | SAFEARRAY(unsigned char) | ? |
| Boolean | VT_BOOL | Boolean | VARIANT_BOOL | VARIANT_BOOL | ? |
| Byte | VT_I2 | Integer | short | short | 轉(zhuǎn)換時驗證范圍有效性 |
| Date | VT_DATE | Date | DATE | DATE | 時間設為 oo:oo:oo |
| DateTime | VT_DATE | Date | DATE | DATE | ? |
| Double | VT_R8 | Double | double | double | ? |
| Duration | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| ENTITIES | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| ENTITY | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| Float | VT_R4 | Single | float | float | ? |
| GDay | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| GMonth | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| GMonthDay | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| GYear | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| GYearMonth | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| ID | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| IDREF | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| IDREFS | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| Int | VT_I4 | Long | long | long | ? |
| Integer | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| Language | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| Long | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| Name | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| NCName | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| negativeInteger | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| NMTOKEN | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| NMTOKENS | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| nonNegativeIntege | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| nonPositiveInteger | VT_DECIMAL | Variant | DECIMA | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| normalizedString | VT_BSTR | String | BSTR | BSTR | ? |
| NOTATION | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| Number | VT_DECIMAL | Variant | DECIMAL | DECIMAL | ? |
| positiveInteger | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| Qname | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| Short | VT_I2 | Integer | short | short | ? |
| String | VT_BSTR | String | BSTR | BSTR | ? |
| Time | VT_DATE | Date | DATE | DATE | 日設為1899年12月30日 |
| Token | VT_BSTR | String | BSTR | BSTR | 不轉(zhuǎn)換和生效 |
| unsignedByte | VT_UI1 | Byte | unsigned char | unsigned char | ? |
| UnsignedInt | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| unsignedLong | VT_DECIMAL | Variant | DECIMAL | DECIMAL | 轉(zhuǎn)換時范圍生效 |
| unsignedShort | VT_UI4 | Long | Long | Long | 轉(zhuǎn)換時范圍生效 |
XSD定義了兩套內(nèi)建的數(shù)據(jù)類型：原始的和派生的。在下文中查閱內(nèi)建數(shù)據(jù)類型的層次十分有益：
| http://www.w3.org/TR/2001/PR-xmlschema-2-20010330 |
?complex類型
XML schema允許complex類型的定義，就像C里是struct。例如，為了定義類似如下的C的struct類型：
| typedef struct { |
我們可以寫XML schema：
| ＜xsd:complexType name="PERSON"＞ |
不過，complex類型可以表達比struct更多的信息。除了＜sequence＞以外，它還可以有其他的子元素，比如＜all＞
| ＜xsd:complexType name="PERSON"＞ |
這意味著＜element＞的成員變量可以以任何順序排列，每一個都是可選的。這和C中的struct類型不太一樣。
注意內(nèi)建數(shù)據(jù)類型string, int, float。C的string也是XML的string，float也類似。但C中的long類型在XML中是int（上表中）。
在WSDL文件中，像上面的complex類型可以在Types欄聲明。例如，我可以用以下方式聲明PERSON類型并用在Messages欄。
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
上例中第一個消息由"adperson"，并且有一個＜part＞，其類型為"PERSON"。PERSON類型是在Types欄聲明的。
如果我們使用完整的WSDL文件包含以上的部分，并以之初始化MSTK2 SoapClient，它將成功的解析該文件。當然，它不會去調(diào)用＜addPerson＞。這是因為SoapClient本身并不知道如何處理complex類型，它需要定制類型映射來處理complex類型。MSTK2文檔中有包含定制類型映射的示例。
還有另一種方法可以把＜part＞元素聯(lián)系到類型聲明。這就是使用元素。下例中我將Types欄中聲明兩個元素（"Person"和"Gendr"），然后我將在"addPerson"＜message＞中使用元素屬性來引用它們。
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
Types欄中的Gender＜element＞里嵌入了枚舉類型，其枚舉值為"Male""Female"。然后我又在"addPerson"＜message＞中通過元素屬性而不是類型屬性來引用它。
"元素屬性"和"類型屬性"在把某特定類型關聯(lián)到＜part＞時有什么不同呢？使用元素屬性，我們可以描述一個部分，它可以假定幾個類型（就像變量一樣），而是用類型屬性我們就無法這樣做。下例說明了這一點。
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
上例也告訴我們extension的派生。"femailPerson"和"malePerson"都是從"PERSON"派生出來的。它們各有一些額外的元素："femalePerson"有"favoriteLipstick"元素，"malePerson"有"favoriteShavingLotion"元素。兩派生類型都歸入一個complex類型"maleOrFemalePerson"，使用的是＜choice＞構造。最后，在"adperson"＜message＞中，新類型有"person"＜part＞引用。這樣，參數(shù)或＜part＞就可以是"femalePerson"或"malePerson"了。
數(shù)組
XSD提供＜list＞結構來聲明一個數(shù)組，元素之間有空格界定。不過SOAP不是使用XSD來編碼數(shù)組的，它定義了自己的數(shù)組類型--"SOAP-ENC: Array"。下列的例子揭示了從這一類型派生出一位整數(shù)數(shù)組的方法：
| ＜xsd:complexType name="ArrayOfInt"＞ |
新的complex類型從soapenc:array限制派生。然后又聲明了complex類型的一個屬性。引用"soapenc:arrayType"實際上是這樣完成的：
| ＜xsd:attribute name="arrayType" type="xsd:string"/＞ |
wsdl:arrayType屬性值決定了數(shù)組每個成員的類型。數(shù)組的成員也可以是Complex類型。：
| ＜xsd:complexType name="ArrayOfPERSON"＞ |
WSDL要求數(shù)組的類型由"ArrayOf"和每個數(shù)組元素的類型串聯(lián)而成。很顯然，顧名思義，"ArrayOfPERSON"是PERSON結構的數(shù)組。下面我將使用ArrayOfPERSON來聲明一個＜message＞，并加入不止一個PERSON：
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
＜portType＞和＜operation＞元素
PortType定義了一些抽象的操作。PortType中的operation元素定義了調(diào)用PortType中所有方法的語法，每一個operation元素聲明了方法的名稱、參數(shù)（使用＜message＞元素）和各自的類型（＜part＞元素要在所有＜message＞中聲明）。
在一篇WSDL文檔中可以有幾個＜PortType＞元素，每一個都和一些相關操作放在一起，就和COM和一組操作的接口相似。
在＜operation＞元素中，可能會有至多一個＜input＞元素，一個＜output＞元素，以及一個＜fault＞元素。三個元素各有一個名字和一個消息屬性。
＜input＞, ＜output＞, ＜fault＞元素屬性的名字有何含義呢？它們可以用來區(qū)別兩個同名操作（重載）。例如，看下面兩個C函數(shù)：
| void foo(int arg); |
這種重載在WSDL中可以這樣表示：
| ＜?xml version="1.0" encoding="UTF-8" ?＞ |
到目前為止，還沒有一種SOAP的實現(xiàn)支持重載。這對基于JAVA的客戶端十分重要，因為JAVA服務器使用的接口用到JAVA的重載特性。而對基于COM的客戶端，就不那么重要，因為COM是不支持重載的。
＜binding＞和＜operation＞元素
Binding欄是完整描述協(xié)議、序列化和編碼的地方，Types, Messages和PortType欄處理抽象的數(shù)據(jù)內(nèi)容，而Binding欄是處理數(shù)據(jù)傳輸?shù)奈锢韺崿F(xiàn)。Binding欄把前三部分的抽象定義具體化。
把相關的數(shù)據(jù)制定和消息聲明分開，這意味著同一類型服務的提供者可以把一系列的操作標準化。每個提供者可以提供定制的binding來互相區(qū)分。WSDL也有一個重要的結構，使抽象定義可以放在分離的文件中，而不是和Bindings和Services在一起，這樣可在不同的服務提供者之間提供標準化的抽象定義，這很有幫助。例如，銀行可以用WSDL文檔來標準化一些銀行的操作。每個銀行仍然可以自由的訂制下層的協(xié)議、串行優(yōu)化，及編碼。
下面是重載的WSDL示例 的Binding欄，重復在此以便討論：
| ＜binding name="fooSampleBinding" type="wsdlns:fooSamplePortType"＞ |
＜binding＞元素已經(jīng)取了一個名字（本例中"fooSampleBinding"），這樣就可以被Services欄的＜port＞元素引用了。它有一個"type"的屬性引用＜portType＞，本例中就是"wsdlns:fooSamplePortType"。第二行是MSTK2的擴展元素＜stk:binding＞，它指定了preferredEncoding屬性為"UTF-8"。
＜soap:binding＞元素指定了所使用的風格（"rpc"）和傳輸方式。Transport屬性應用了一個namespace，正是這個namespace指明使用HTTP SOAP協(xié)議。
有兩個同以"foo"命名的＜operation＞元素。唯一不同的是它們各自的＜input＞名字，分別為"foo1"和"foo2"。兩個＜operation＞元素中的＜soap:operation＞元素有同樣的"soapAction"屬性，是URI。soapAction屬性是SOAP特定的URI，它只是簡單的使用于SOAP消息。所產(chǎn)生的SOAP消息有一個SOAPAction頭，而URI也僅在＜soap:operation＞元素里才起作用。soapAction屬性在HTTP的binding中是必需的，但在其他非HTTP binding中卻不要提供。目前它的使用并不清楚，但它似乎有助于本例中的兩個"foo"操作。SOAP 1.1指明soapAction用來確定消息的"意圖"。似乎服務器可以在不解析整個消息的情況下就能使用這一屬性來發(fā)送消息。實際上，它的使用多種多樣。＜soap:operation＞元素也可以包含另一屬性，即"style"屬性，在有必要沖突＜soap:binding＞元素指定的風格時可以使用。
＜operation＞屬性可以包含＜input＞, ＜output＞ 和＜fault＞的元素，它們都對應于PortType欄中的相同元素。只有＜input＞元素在上例中提供。這三個元素中的每一個可有一個可選的"name"屬性，在本例中，我們用這種方法來區(qū)分同名操作。在本例的＜input＞元素中有一個＜soap:body＞元素，它指定了哪些信息被寫進SOAP消息的信息體中。該元素有以下屬性：
Use
用于制定數(shù)據(jù)是"encoded"還是"literal"。"Literal"指結果SOAP消息包含以抽象定義（Types, Messages, 和PortTypes）指定格式存在的數(shù)據(jù)。"Encoded"指"encodingStyle"屬性決定了編碼方式。
Namespace
每個SOAP消息體可以有其自己的namespace來防止命名沖突。這一屬性制定的URI在結果SOAP消息中逐字使用。
EncodingStyle
對SOAP編碼，它應該有以下URI值：
| "http://schemas.xmlsoap.org/soap/encoding" |
文檔風格實現(xiàn)
在前幾欄中，＜soap:binding＞元素有一個類型屬性，設為"rpc"。此屬性設為"document"時會改變傳輸時消息的串行化。不同于函數(shù)簽名，現(xiàn)在的消息是文檔傳輸?shù)摹Ｔ谶@類binding中，＜message＞元素定義文檔格式，而不是函數(shù)簽名。作為例子，考慮以下WSDL片段：
| ＜definitions |
schema有兩個元素：SimpleElement和CompositeElement，還有一個類型聲明（CompositeType）。唯一聲明的＜message＞元素有四個部分：p1：Composite型；p2：int型；p3：SimpleElement型；p4：CompositeElement型。以下有一個表，對四種類型的use/type決定的binding作一比較：rpc/literal, document/literal, rpc/encoded, 以及document/encoded。表指明了每種binding的表現(xiàn)。
＜service＞和＜port＞元素
service是一套＜port＞元素。在一一對應形式下，每個＜port＞元素都和一個location關聯(lián)。如果同一個＜binding＞有多個＜port＞元素與之關聯(lián)，可以使用額外的URL地址作為替換。
一個WSDL文檔中可以有多個＜service＞元素，而且多個＜service＞元素十分有用，其中之一就是可以根據(jù)目標URL來組織端口。這樣，我就可以方便的使用另一個＜service＞來重定向我的股市查詢申請。我的客戶端程序仍然工作，因為這種根據(jù)協(xié)議歸類的服務不隨服務而變化。多個＜service＞元素的另一個作用是根據(jù)特定的協(xié)議劃分端口。例如，我可以把所有的HTTP端口放在同一個＜service＞中，所有的SMTP端口放在另一個＜service＞里。我的客戶可以搜索與它可以處理的協(xié)議相匹配的＜service＞。
| ＜service name="FOOService"＞ |
在一個WSDL文檔中，＜service＞的name屬性用來區(qū)分不同的service。因為同一個service中可以有多個端口，它們也有"name"屬性。
總結
本文中我描述了WSDL文檔關于SOAP方面的最顯著的特點。不過應該說明的是WSDL并不僅限于HTTP上的SOAP。WSDL用來描述HTTP-POST、HTTP-GET、SMTP及其他協(xié)議時非常清晰。使用了WSDL，SOAP更加容易處理了，無論是開發(fā)者還是使用者。我相信WSDL和SOAP一起將會開創(chuàng)網(wǎng)絡應用程序世界的新時代。
WSDL的namespace里有一系列的XML元素。下表概述了那些元素、它們的屬性和內(nèi)容。
| 元素 | 屬性 | 內(nèi)容（子元素） |
| ＜definitions＞ | name | ＜types＞ |
| ＜types＞ | (none) | ＜xsd:schema＞ |
| ＜message＞ | Name | ＜part＞ |
| ＜portType＞ | Name | ＜operation＞ |
| ＜binding＞ | name | ＜operation＞ |
| ＜service＞ | name | ＜port＞ |
| ＜part＞ | name | (empty) |
| ＜operation＞ | name | ＜input＞ |
| ＜input＞ | name | (empty) |
| ＜output＞ | name | (empty) |
| ＜fault＞ | name | (empty) |
| ＜port＞ | name | ＜soap:address＞ |
資源：
1. WSDL 1.1
2. SOAP 1.1
3. XML Schema Primer
4. MS SOAP Toolkit Download Site
5. A tool for translating IDL to WSDL
6. Free Web Servicesresources including a WSDL to VB proxy generator
7. PocketSOAP: SOAPrelated components, tools & source code
?
?
轉(zhuǎn)載于:https://www.cnblogs.com/dyllove98/p/3190341.html
總結
以上是生活随笔為你收集整理的WSDL中文版——详解的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： linux下的共享库（动态库）和静态库
- 下一篇： 双击打开excel时提示：向程序发送命令