- 相關(guān)推薦
SOAP Web服務(wù)介紹
當今最為常見(jiàn)的兩種 Web 服務(wù)類(lèi)型分別是： REST 和 SOAP 。不過(guò)，從趨勢來(lái)看，越來(lái)越多人已經(jīng)開(kāi)始使用 REST 風(fēng)格的 Web 服務(wù)。而 SOAP 大多也開(kāi)始或已經(jīng)轉型 REST，應該說(shuō) REST 會(huì )慢慢成為主流。這篇文章不會(huì )對 REST 介紹太多，主要的重點(diǎn)還是介紹一下 SOAP 風(fēng)格的 Web 服務(wù)。
Web Service 三要素
實(shí)際上，現在說(shuō) “Web Service 三要素”應該是不算很準確了，不過(guò)這個(gè)概念一直這樣沿用，而且本文我們?yōu)榱烁芮宄U釋 SOAP Web 服務(wù)，那么就這樣定義。
Web Service 的三個(gè)要素分別是：
SOAP（Simple Object Access Protoco） 簡(jiǎn)單對象訪(fǎng)問(wèn)協(xié)議；
WSDL（Web Services Description Language） 網(wǎng)絡(luò )服務(wù)描述語(yǔ)言；
UDDI（Universal Description Discovery and Integration）一個(gè)用來(lái)發(fā)布和搜索 WEB 服務(wù)的協(xié)議（非必須）；
SOAP 用來(lái)描述傳遞信息的格式規范， WSDL 用來(lái)描述如何訪(fǎng)問(wèn)具體的接口（比如它會(huì )告訴你該服務(wù)有哪些接口可以使用，參數是什么等等）， UDDI 用來(lái)管理、分發(fā)和查詢(xún) Web Service。下面我們將逐一詳細介紹這三個(gè)要素，并通過(guò)結合實(shí)例來(lái)進(jìn)行闡釋。
為了把這三個(gè)要素說(shuō)得更清楚，我們將會(huì )使用一個(gè)免費的 SOAP Web 服務(wù)作為例子進(jìn)行闡述。該服務(wù)只提供一個(gè)接口即：根據 QQ 號，獲取 QQ 在線(xiàn)狀態(tài)。查看該服務(wù)
SOAP
它是一個(gè)協(xié)議，可以簡(jiǎn)單的理解為：它定義了一個(gè)基于 XML 的可擴展消息信封格式。因為客戶(hù)端與服務(wù)器進(jìn)行交互，由于大家的平臺和應用程序都不一樣，所以大家約定都采用 SOAP 這個(gè)協(xié)議來(lái)規范交互時(shí)的需要傳遞的消息。
請求接口時(shí)，發(fā)送的消息例子：
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<qqCheckOnline xmlns="http://WebXml.com.cn/">
<qqCode>8698053</qqCode>
</qqCheckOnline>
</soap:Body>
</soap:Envelope>
接口響應時(shí)，返回的消息例子：
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<qqCheckOnlineResponse xmlns="http://WebXml.com.cn/">
<qqCheckOnlineResult>Y</qqCheckOnlineResult>
</qqCheckOnlineResponse>
</soap:Body>
</soap:Envelope>
注：以上例子是使用 SOAP 1.1 發(fā)送的消息，SOAP 1.2 發(fā)送的消息格式其實(shí)大同小異，具體自己查看接口文檔。
下面對它結構進(jìn)行詳細說(shuō)明。
XML 聲明
<?xml version="1.0" encoding="utf-8"?>
該行是 XML 聲明。它定義 XML 的版本 (1.0) 和所使用的編碼（utf-8）。
Envelope 元素
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
....
</soap:Envelope>
Envelope 元素是 SOAP 消息的固定根元素，SOAP 協(xié)議規定的，不能變，其中 xmlns 是 XML Namespace 的縮寫(xiě)，表示 XML 命名空間。xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 是 Envelope的一個(gè)屬性，它表示定義個(gè)以soap 為前綴的命名空間 http://schemas.xmlsoap.org/soap/envelope/，即命名空間的名字是：http://schemas.xmlsoap.org/soap/envelope/，而它的前綴是 soap，這樣子就把 soap 前綴與該命名空間進(jìn)行了綁定。即任何用 soap 為前綴的元素都屬于該命名空間的，包括根元素 Envelope 。舉個(gè)例子：
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<qqCheckOnline xmlns="http://WebXml.com.cn/">
<qqCode>8698053</qqCode>
</qqCheckOnline>
</soap:Body>
</soap:Envelope>
其中，Envelope 和 Body 元素就是以 soap 為前綴的，那么 Envelope 和 Body 元素都是屬于http://schemas.xmlsoap.org/soap/envelope/ 這個(gè)命名空間的。
同時(shí)，SOAP 協(xié)議中規定，SOAP 消息必須使用 SOAP Envelope 命名空間，所以http://schemas.xmlsoap.org/soap/envelope/ 這個(gè)命名空間是固定的不能變（注意：這里只針對 SOAP 1.1 版本，SOAP 1.2 會(huì )有所不同）。所有 SOAP 消息元素，比如：Envelope、Header、Body、Fault 也都必須屬于該命名空間。
Body 元素
<soap:Body>
<qqCheckOnline xmlns="http://WebXml.com.cn/">
<qqCode>8698053</qqCode>
</qqCheckOnline>
</soap:Body>
Body 元素里面，一般都是放一些請求和響應的內容。qqCheckOnline 表示要調用的接口方法，而 qqCode 就是調用該方法時(shí)，傳入的參數，當然參數可以有多個(gè)。
其中，qqCheckOnline 元素上也定義了一個(gè)命名空間 http://WebXml.com.cn/。值得注意的是，這里在定義命名空間時(shí)，并沒(méi)有設置命名空間前綴（namespace prefix）。這種設置方式，會(huì )把當前元素及其所有子元素，都歸屬于該命名空間。了解 XML 命名空間。
我們看到，SOAP 消息元素和應用程序本身的元素是屬于不同的命名空間，這樣有利于把 SOAP 消息元素與其他元素區分開(kāi)來(lái)，當然也防止了與自定義元素重名的問(wèn)題。
Header 元素
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<AuthenHeader xmlns="http://www.example.com">
<sAuthenticate>string</sAuthenticate>
</AuthenHeader>
</soap:Header>
<soap:Body>
......
</soap:Body>
</soap:Envelope>
有些接口需要提供 Header 元素，它和 Body 信息一起發(fā)送，它一般用于身份驗證等作用。例子中的 AuthenHeader 和sAuthenticate 都是接口自定義的參數。
Fault 元素
當調用服務(wù)發(fā)生錯誤時(shí)，錯誤信息一般會(huì )被放置在 Fault 元素內。例如：
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Client</faultcode>
<faultstring>Input string was not in a correct format.</faultstring>
<detail/>
</soap:Fault>
</soap:Body>
</soap:Envelope>
Fault 元素內還有 faultcode、faultstring、detail，用于描述錯誤信息用的。在上一篇文章：《SOAP 介紹》中已經(jīng)對該知識點(diǎn)進(jìn)行了比較詳細的說(shuō)明，有興趣可以看看。
WSDL
一個(gè) XML 格式的文檔。它用于描述該服務(wù)有哪些可用方法、參數的數據類(lèi)型、命名空間等等信息。它的目的是讓你知道該如何使用該服務(wù)，包括調用的各種細節信息。WSDL 文檔通常用來(lái)輔助生成服務(wù)器和客戶(hù)端代碼及配置信息。
契約先行與代碼先行模式
在開(kāi)發(fā) Web Service 過(guò)程中有兩種實(shí)現模式：契約先行（Contract first）模式和代碼先行（Code first）模式。
契約先行模式：首要工作是定義針對這個(gè) Web 服務(wù)的接口的 WSDL(Web Services Description Language，Web 服務(wù)描述語(yǔ)言 ) 文件。WSDL 文件中描述了 Web 服務(wù)的位置，可提供的操作集，以及其他一些屬性。WSDL 文件也就是 Web 服務(wù)的 “契約”。“契約” 訂立之后，再據此進(jìn)行服務(wù)器端和客戶(hù)端的應用程序開(kāi)發(fā)。
代碼先行模式：與契約先行模式不同，代碼先行模式中，第一步工作是實(shí)現 Web 服務(wù)端，然后根據服務(wù)端的實(shí)現，用某種方法（自動(dòng)生成或手工編寫(xiě)）生成 WSDL 文件。
實(shí)際上，一個(gè) WSDL 文件也挺復雜的，一般自己也不會(huì )去直接看這個(gè)文件，而是需要用到某個(gè)方法時(shí)，直接看該方法的調用說(shuō)明就好。比如：獲得騰訊QQ在線(xiàn)狀態(tài)
UDDI
UDDI 是一個(gè)專(zhuān)門(mén)用來(lái)管理 Web 服務(wù)的地方。Web Service 服務(wù)提供商可以通過(guò)兩種方式來(lái)暴露它的 WSDL 文件地址：
注冊到 UDDI 服務(wù)器，以便被人查找；
直接告訴給客戶(hù)端調用者；
是否需要注冊到 UDDI 實(shí)際上是可選的，一般公司內部使用的服務(wù)，也不會(huì )注冊到 UDDI。只有那些希望所有人都知道該服務(wù)的地址，才會(huì )注冊到 UDDI。
最后
這篇文章寫(xiě)得有點(diǎn)亂了，主要還是自己對 SOAP 的了解還不夠，最起碼我并沒(méi)有真正開(kāi)發(fā)過(guò) SOAP 服務(wù)。不過(guò)沒(méi)關(guān)系吧，慢慢來(lái)，文章可以隨著(zhù)知識的增長(cháng)慢慢潤色。上文其實(shí)有一些問(wèn)題沒(méi)有說(shuō)清楚的，比如說(shuō)：SOAP 服務(wù)的適合用在哪里，不適合用在哪里等等。如果你有興趣，可以看看文章最后的幾篇參考文獻。
【SOAP Web服務(wù)介紹】相關(guān)文章：
SOAP語(yǔ)法07-06
Windows 2003的Web服務(wù)器配置方法介紹07-19
關(guān)于網(wǎng)格與Web服務(wù)的結合09-30
Web服務(wù)中的異常處理09-17
安裝Web服務(wù)器07-16
教你制作iPhone的SOAP應用07-25
WEB服務(wù)器的優(yōu)化方法10-30
Web服務(wù)器常規維護10-16