WSDL(Web Services Description Language,Web 服務描述語言)提供了一種描述 Web 服務(大多使用 SOAP)的簡便方法,讓你能清楚說明利用 SOAP 標準所提供的服務與介面。
你可以建立一份描述某台伺服器所提供服務的 WSDL 檔,再把它分發給需要使用這些服務的消費者。消費者只要讀懂並解析這份 WSDL,就能掌握使用該 Web 服務所需的一切資訊,包括可交換的資料型別、參數,以及可能回傳的各種錯誤與其他資訊。
以下沿用 W3C 的範例,可以看到不同遠端函式與交換資料都透過結構化的 XML 來定義。WSDL 大致由幾個區塊組成:
wsdl:types:封裝通訊型別的架構定義,這裡用 xsd:schema 描述 GetEndorsingBoarder 的請求(manufacturer、model)、回應(endorsingBoarder)與錯誤(errorMessage)等資料結構。
wsdl:message:描述可能的交易,例如 GetEndorsingBoarderRequest 與 GetEndorsingBoarderResponse。
wsdl:portType:描述某個操作(operation)中的訊息,定義 input、output 與 fault。
wsdl:binding:為服務指定序列化協定,此例綁定到 SOAP,並標明 transport 為 http。
wsdl:service:為服務命名,並透過 port 關聯到 binding,最後給定網路位址 soap:address location。
可以把它想成:SOAP 定義了「訊息怎麼傳」,而 WSDL 定義了「服務有哪些、怎麼呼叫、資料長什麼樣」。伺服器上 SOAP 結構所需的一切資訊,都能在這份 WSDL 中找到。
大多數語言與環境都提供了讀取、解析 WSDL 的機制,用以判斷可用的函式與資料交換方式。更棒的是,透過適當的 WSDL 產生器,還能自動產生送出請求、格式化回應所需的程式碼。WSDL 與 SOAP 搭配,就組成了一套強大的遠端程序呼叫系統。