WSDL 文檔

基本介紹

• 中文名：WSDL 文檔
• 外文名：Web Services Description Language Document
• 連線埠：<portType>
• 訊息：<message>
• 性質：一個函式館 

正文

結構

WSDL 文檔是利用這些主要的元素來描述某個 web service 的：

元素	定義
<portType>	web service 執行的操作
<message>	web service 使用的訊息
<types>	web service 使用的數據類型
<binding>	web service 使用的通信協定

一個 WSDL 文檔的主要結構是類似這樣的：

<definitions><types>definition of types........</types><message>definition of a message....</message><portType>definition of a port.......</portType><binding>definition of a binding....</binding></definitions>WSDL 文檔可包含其它的元素，比如 extension 元素，以及一個 service 元素，此元素可把若干個 web services 的定義組合在一個單一的 WSDL 文檔中。

連線埠

<portType> 元素是最重要的 WSDL 元素。 它可描述一個 web service、可被執行的操作，以及相關的訊息。 可以把 <portType> 元素比作傳統程式語言中的一個函式館（或一個模組、或一個類）。

訊息

<message> 元素定義一個操作的數據元素。 每個訊息均由一個或多個部件組成。可以把這些部件比作傳統程式語言中一個函式調用的參數。

types

<types> 元素定義 web service 使用的數據類型。 為了最大程度的平台中立性，WSDL 使用 XML Schema 語法來定義數據類型。

元素

<binding> 元素為每個連線埠定義訊息格式和協定細節。

實例

這是某個 WSDL 文檔的簡化的片段： <message name="getTermRequest"> <part name="term" type="xs:string"/></message><message name="getTermResponse"> <part name="value" type="xs:string"/></message><portType name="glossaryTerms"> <operation name="getTerm"> <input message="getTermRequest"/> <output message="getTermResponse"/> </operation></portType>在這個例子中，<portType> 元素把 "glossaryTerms" 定義為某個連線埠的名稱，把 "getTerm" 定義為某個操作的名稱。

操作 "getTerm" 擁有一個名為 "getTermRequest" 的輸入訊息，以及一個名為 "getTermResponse" 的輸出訊息。

<message> 元素可定義每個訊息的部件，以及相關聯的數據類型。

對比傳統的編程，glossaryTerms 是一個函式館，而 "getTerm" 是帶有輸入參數 "getTermRequest" 和返回參數 getTermResponse 的一個函式。