WebService WSDL結構分析 收藏
WSDL (Web Services Description Language,Web服務(wù)描述語(yǔ)言)是一種XML Application,他將Web服務(wù)描述定義為一組服務(wù)訪(fǎng)問(wèn)點(diǎn),客戶(hù)端可以通過(guò)這些服務(wù)訪(fǎng)問(wèn)點(diǎn)對包含面向文檔信息或面向過(guò)程調用的服務(wù)進(jìn)行訪(fǎng)問(wèn)(類(lèi)似遠程過(guò)程調用)。WSDL首先對訪(fǎng)問(wèn)的操作和訪(fǎng)問(wèn)時(shí)使用的請求/響應消息進(jìn)行抽象描述,然后將其綁定到具體的傳輸協(xié)議和消息格式上以最終定義具體部署的服務(wù)訪(fǎng)問(wèn)點(diǎn)。相關(guān)的具體部署的服務(wù)訪(fǎng)問(wèn)點(diǎn)通過(guò)組合就成為抽象的Web服務(wù)。 本文將詳細講解WSDL文檔的結構,并分析每個(gè)元素的作用。
一:WSDL定義
WSDL是一個(gè)用于精確描述Web服務(wù)的文檔,WSDL文檔是一個(gè)遵循WSDL XML模式的XML文檔。WSDL 文檔將Web服務(wù)定義為服務(wù)訪(fǎng)問(wèn)點(diǎn)或端口的集合。在 WSDL 中,由于服務(wù)訪(fǎng)問(wèn)點(diǎn)和消息的抽象定義已從具體的服務(wù)部署或數據格式綁定中分離出來(lái),因此可以對抽象定義進(jìn)行再次使用:消息,指對交換數據的抽象描述;而端口類(lèi)型,指操作的抽象集合。用于特定端口類(lèi)型的具體協(xié)議和數據格式規范構成了可以再次使用的綁定。將Web訪(fǎng)問(wèn)地址與可再次使用的綁定相關(guān)聯(lián),可以定義一個(gè)端口,而端口的集合則定義為服務(wù)。
一個(gè)WSDL文檔通常包含7個(gè)重要的元素,即types、import、message、portType、operation、binding、 service元素。這些元素嵌套在definitions元素中,definitions是WSDL文檔的根元素。文章的下一部分將會(huì )詳細介紹WSDL 的基本結構。
二:WSDL的基本結構--概述
如第一部分最后描述的那樣,一個(gè)基本的WSDL文檔包含7個(gè)重要的元素。下面將分別介紹這幾個(gè)元素以及他們的作用。
WSDL 文檔在Web服務(wù)的定義中使用下列元素:
•Types - 數據類(lèi)型定義的容器,它使用某種類(lèi)型系統(一般地使用XML Schema中的類(lèi)型系統)。
•Message - 通信消息的數據結構的抽象類(lèi)型化定義。使用Types所定義的類(lèi)型來(lái)定義整個(gè)消息的數據結構。
•Operation - 對服務(wù)中所支持的操作的抽象描述,一般單個(gè)Operation描述了一個(gè)訪(fǎng)問(wèn)入口的請求/響應消息對。
•PortType - 對于某個(gè)訪(fǎng)問(wèn)入口點(diǎn)類(lèi)型所支持的操作的抽象集合,這些操作可以由一個(gè)或多個(gè)服務(wù)訪(fǎng)問(wèn)點(diǎn)來(lái)支持。
•Binding - 特定端口類(lèi)型的具體協(xié)議和數據格式規范的綁定。
•Port - 定義為協(xié)議/數據格式綁定與具體Web訪(fǎng)問(wèn)地址組合的單個(gè)服務(wù)訪(fǎng)問(wèn)點(diǎn)。
•Service- 相關(guān)服務(wù)訪(fǎng)問(wèn)點(diǎn)的集合。
可以參考下圖來(lái)理解一下WSDL的文檔結構圖:
三:WSDL的基本結構--詳述
本節將通過(guò)一個(gè)例子詳細描述WSDL文檔每個(gè)元素的作用。下面一個(gè)例子是一個(gè)簡(jiǎn)單的WSDL文檔的內容,該文檔的產(chǎn)生可以參見(jiàn)我的另外一篇文章:xfire開(kāi)發(fā)實(shí)例--HelloWorld篇 。
一個(gè)簡(jiǎn)單的Web Service的WSDL文檔,該服務(wù)支持名為sayHello的唯一操作,該操作通過(guò)在http上運行SOAP協(xié)議來(lái)實(shí)現的。該請求接受一個(gè)字符串name,經(jīng)過(guò)處理后返回一個(gè)簡(jiǎn)單的字符串。文檔如下:
♦ import元素類(lèi)似于XML模式文檔中的import元素,用于從其他WSDL文檔中導入WSDL定義;
♦ message元素使用在WSDL文檔的type元素中定義或在import元素引用的外部WSDL文檔中定義的XML模式的內置類(lèi)型、復雜類(lèi)型或元素描述了消息的有效負載;
♦ portType元素和operation元素描述了Web服務(wù)的接口并定義了他的方法。portType元素和operation元素類(lèi)似于 java接口和接口中定義的方法聲明。operation元素使用一個(gè)或者多個(gè)message類(lèi)型來(lái)定義他的輸入和輸出的有效負載;
♦ Binding元素將portType元素和operation元素賦給一個(gè)特殊的協(xié)議和編碼樣式;
♦ service元素負責將Internet地址賦給一個(gè)具體的綁定;
1、definitions元素
所有的WSDL文檔的根元素均是definitions元素。該元素封裝了整個(gè)文檔,同時(shí)通過(guò)其name提供了一個(gè)WSDL文檔。除了提供一個(gè)命名空間外,該元素沒(méi)有其他作用,故不作詳細描述。
下面的代碼是一個(gè)definitions元素的結構:
WSDL采用了W3C XML模式內置類(lèi)型作為其基本類(lèi)型系統。types元素用作一個(gè)容器,用于定義XML模式內置類(lèi)型中沒(méi)有描述的各種數據類(lèi)型。當聲明消息部分的有效負載時(shí),消息定義使用了在types元素中定義的數據類(lèi)型和元素。在本文的WSDL文檔中的types定義:
sayHello:定義了一個(gè)復雜類(lèi)型,僅僅包含一個(gè)簡(jiǎn)單的字符串,將來(lái)用來(lái)描述操作的參入傳入部分;
sayHelloResponse:定義了一個(gè)復雜類(lèi)型,僅僅包含一個(gè)簡(jiǎn)單的字符串,將來(lái)用來(lái)描述操作的返回值;
3、import元素
import元素使得可以在當前的WSDL文檔中使用其他WSDL文檔中指定的命名空間中的定義元素。本例子中沒(méi)有使用import元素。通常在用戶(hù)希望模塊化WSDL文檔的時(shí)候,該功能是非常有效果的。
import的格式如下:
sayHelloRequest:sayHello操作的請求消息格式,由一個(gè)消息片斷組成,名字為parameters,元素是我們前面定義的types中的元素;
sayHelloResponse:sayHello操作的響應消息格式,由一個(gè)消息片斷組成,名字為parameters,元素是我們前面定義的types中的元素;
如果采用RPC樣式的消息傳遞,只需要將文檔中的element元素應以修改為type即可。
5、portType元素
portType元素定義了Web服務(wù)的抽象接口。該接口有點(diǎn)類(lèi)似Java的接口,都是定義了一個(gè)抽象類(lèi)型和方法,沒(méi)有定義實(shí)現。在WSDL中, portType元素是由binding和service元素來(lái)實(shí)現的,這兩個(gè)元素用來(lái)說(shuō)明Web服務(wù)實(shí)現使用的Internet協(xié)議、編碼方案以及 Internet地址。
一個(gè)portType中可以定義多個(gè)operation,一個(gè)operation可以看作是一個(gè)方法,本文中WSDL文檔的定義:
<wsdl:portType name="HelloServicePortType">
<wsdl:operation name="sayHello">
<wsdl:input name="sayHelloRequest"
message="tns:sayHelloRequest" />
<wsdl:output name="sayHelloResponse"
message="tns:sayHelloResponse" />
</wsdl:operation>
</wsdl:portType>portType定義了服務(wù)的調用模式的類(lèi)型,這里包含一個(gè)操作sayHello方法,同時(shí)包含input和output表明該操作是一個(gè)請求/響應模式,請求消息是前面定義的sayHelloRequest,響應消息是前面定義的sayHelloResponse。input表示傳遞到Web服務(wù)的有效負載,output消息表示傳遞給客戶(hù)的有效負載。
6、binding
binding元素將一個(gè)抽象portType映射到一組具體協(xié)議(SOAO和HTTP)、消息傳遞樣式、編碼樣式。通常binding元素與協(xié)議專(zhuān)有的元素和在一起使用,本文中的例子:
具體的使用需要參考特定協(xié)議定義的元素。
7、service元素和port元素
service元素包含一個(gè)或者多個(gè)port元素,其中每個(gè)port元素表示一個(gè)不同的Web服務(wù)。port元素將URL賦給一個(gè)特定的binding,甚至可以使兩個(gè)或者多個(gè)port元素將不同的URL賦值給相同的binding。文檔中的例子:
本文簡(jiǎn)單介紹了WSDL規范的用途,基本結構和使用方法,希望對大家學(xué)習WSDL有幫助。