一般開發Web Service,是選寫服務端,再根據生成的WSDL文件生成客戶端。看過一本SOA的書中說,如果實現防止不同語言一些特定的數據類型的不兼容性,推薦先定義WSDL接口,包括一輸入輸出參數、返回值及相關的數據類型等,再通過WSDL來生成服務器端和客戶端,這樣的好處是:服務端不用關心客戶端怎么調用,客戶端也不用關系服務端如何實現。
關于Eclipse中Axis2的配置方法,請看我的[圖解教程] Axis2與Eclipse整合開發Web Service之一:簡單的計算服務例子,下面來新建一個WSDL文件,如下圖:
改個名字為“manager.wsdl”,如下圖:
下一步,定義命名空間和協議等信息,默認即行。如下圖:
finish后,會在主工作區出現如下圖:
這是manager.wsdl的圖形化形式,點擊“Source”會可查看到源代碼:
這是默認生成的wsdl,我們要根據我們的項目需要,修改上面的圖,首先對方法名進行修改,如下圖:
可見,修改之后,右邊的input和output也跟著修改了,這兩個就是定義plus的輸入和輸出。
點擊input參數“plus”右邊的提示箭頭,進入下圖:
就在這里定義輸入參數和和參數類型等信息,因為我們plus(float x, float y)方法中有兩個參數x和y,故我們將上圖改成兩個參數的序列:
變成下圖,對比一下方法plus(float x, float y),下圖也不會太難理解吧!
我們返回manager.wsdl視圖,選擇output參數右邊的箭頭,進入下圖:
我們在這里設置float plus(float x, float y)方法的返回值及其類型,因其返回值只有一個,我們只須把上面的out的類型改成我們方法中用的float,改后,如下圖:
我們可以在這里對輸入輸出的參數及其他數據類型進行修改,如果在上面的操作過程中,不小心產生了多余的標簽的話,也可以在這里去除。
好了,我們再回到manager.wsdl,在源代碼視圖里右鍵選“Validate”,對xml文檔進行檢驗,如果有錯誤的,就根據需要修改。
好了,圖形化編寫的wsdl文檔完成了,順便說一下,方法是可以定義多個的,如下圖:
為簡單起見,我們就先以剛才做定義的那個方法為例,看看,如何根據wsdl文件,自動生成Web Service的服務器端。
我們New一個Web Service,如下圖:
記得在Web Service type中選擇“Top down Java Bean Web Service”,如下圖:
然后,在Service definition中找到剛才寫的那個manager.wsdl文件。
回到Web Service對話框,將服務類型的滑塊調到“Develop service”處,
接下來,就next –> next –-> finish就行。它會自動生成Web Service服務端的接口和類,在類中,可找到我們定義的方法:
我們只要修改方法plus的方法體,以實現我們要實現的功能即行。如下:
這是通過WSDL反向生成Web Service服務端的最簡單一個例子,可能看不到有什么好處,沒有像[圖解教程] Axis2與Eclipse整合開發Web Service之一:簡單的計算服務例子那樣的簡便快捷,但如果是一些特有的數據類型,如List,Set,這些,我們有在WSDL圖形化設計中找到相應的替代類型,先定義WSDL再生成服務端接口,這樣做,不僅Java開發客戶端是沒有問題的,用C#開發客戶端也能成功沒有出錯!
但如果先開發服務器端的話,如果用到一些Java特有的數據類型,如List,Set,如果用其他語言生成的客戶端,就可能出問題。同理,用C#開發服務端,如果用到像DataSet這樣的返回類型的話,那如果用Java或者其他語言去開發客戶端,也可能會出現問題的。
如果統一先寫WSDL,再根據WSDL生成服務端和客戶端,應該是一種很不錯的做法,Eclipse在這方面的圖形化支持給帶給我們事半功倍的效果,這樣做,也比較符合SOA的做法。
本文原創,轉載請注明出處,謝謝!http://www.tkk7.com/rongxh7(心夢帆影JavaEE技術博客)