php學習之道 WSDL詳解二

3.定義服務使用的邏輯訊息

當服務的操作被呼叫時，服務被定義為訊息交換。在wsdl文件中，這些訊息被定義message元素。這些訊息由稱之為part元素的部分組成。

乙個服務的操作，通過指定邏輯訊息的方式來定義。當操作被呼叫時，邏輯訊息被交換。（也就是說，邏輯訊息代表了服務的操作）這些邏輯訊息，將在網路上傳輸的資料定義為xml文件。他包含了所有的引數，這些引數是方法呼叫的一部分。（也就是說，邏輯訊息裡的引數，是操作對應方法的引數集合）

訊息和引數列表：每乙個被服務暴露的操作能且僅能有乙個輸入訊息和乙個輸出訊息。輸入訊息定義當操作被呼叫時，服務接受的所有訊息。輸出訊息定義的是，當操作完成時服務返回的所有訊息。fault訊息定義的是服務返回錯誤時的資料。

另外，每個操作可以有一定數量的fault訊息。這個fault訊息定義了當服務發生錯誤時返回的資料。這些訊息通常有乙個部分，該部分提供足夠的資訊來讓消費者知道錯誤是什麼。

訊息設計用於整合固有系統：如果你將已經存在的應用程式定義為乙個服務，你必須確保方法（實現操作的方法）中使用到的每個引數都能夠在訊息中找到對應。你必須確保返回值也在操作的輸出訊息中。

定義你的訊息的乙個方法是：rpc風格。當使用rpc風格時，你使用給每個在引數列表中的引數定義乙個part。每個訊息part是基於在types中頂乙個的type。

你的輸入訊息為每個輸入引數對應乙個part，同樣輸出訊息為每個輸出引數對應乙個part。另外增加個part來對應返回值。如果乙個引數既是輸入，又是輸出，那麼它即作為輸入又作為輸出訊息列出來。

rpc風格的訊息定義是當服務使能存量系統時有用。它使用類似於tibco或者corba的模式傳輸。這些系統圍繞著過程和方法來設計。正是由於這樣，他們是最容易使用訊息來建模。rpc風格也是服務和應用程式之間的對映清晰化。

為soap服務設計訊息：當rpc風格用於建模存量系統，但是服務協會強烈地喜歡包裝文件風格。在包裝文件風格中，每個訊息有乙個part。這個訊息的part參考了乙個包裝元素，該元素定義在types元素中。包裝元素有如下特性：

訊息命名：每個訊息都在其命名空間中有唯一名字，建議使用下面的命名規則：

訊息部件：訊息部件是邏輯訊息最常用的單元。每個part被定義，用part元素。並且通過name屬性，用type屬性或element屬性來指定資料型別。

訊息允許重用part名。對於乙個例項來說，如果乙個方法有乙個引數：foo,他被應用或者通過in/out傳遞，他能夠作為乙個part存在於請求或者應答訊息中。如下例：

例子：假設你有乙個伺服器儲存了個人資訊並且提供乙個方法，該方法換回雇員的資料，基於雇員id.。該方法如下：

personalinfo lookup(long empid)

被對映到rpc風格的wsdl如下

對映到包裝風格如下：

...

php學習之道 WSDL詳解 二