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元素中。封裝元素有如下特性: