簡單JAX-WS Web Service使用教學

JAX-WS(Java API for XML Web Services)Web Service是一種由Oracle Sun發展的以XML為基礎的Web Service開發技術。目前已經涵概到Java EE5(含)以上的版本，它可以讓使用者迅速開發Java Web Service，除了採用SOAP(Simple Object Access Protocol)通訊協定和XML資料標準，也支援以HTTP為基礎的通訊協定，JAX-WS使用JAXB 2.0處理資料物件與XML資料格式的映射交換，可以在程式代碼中使用@XXX的註解標籤，大大的簡單化Web Service開發流程與減少Web Service於執行階段所產生JAR檔的大小。在這篇教學文章中，會先建立一個Web Service且安排內部的程式邏輯、再分別寫三個Web Service Client，

• 簡單Java AP Client
• 簡單Servlet Web AP Client
• 簡單JSP Web AP Client

來使用與測試Web Service服務是否正常運作。

在本範例中選擇NetBean IDE 6.9來開發Web Service，緊接著我們會依照下面的步驟逐一的完成Web Service程式的建立： 

建立一個Web Service

首先， 單擊滑鼠右鍵後選擇「New Project」項目(圖1)，再來選取Java Web -> Web Application次項目(圖2)，稍後畫面帶到「New Web Application」對話框後，請逐一完成「Name and Location」、「Server and Settings」和「Framework」步驟的內容設定：

1. Name and Location請設定Project Name為Welcome，其餘Project Location、 Project Folder都為預設值。
2. 於Server and Settings設定Server為GlassFish Server 3，其他的Java EE Version、Context Path均為預設值。
3. 到Framework步驟時，需依據每一個專案的需要選擇適當的framework來配合專案一起使用，但在本例子中並不需要使用framework。

 圖1. 單擊滑鼠右鍵後選擇「New Project」項目

圖2. 再來選取Java Web -> Web Application次項目

設計Web Service方法

籍由我們的右手移動滑鼠到Source Packages圖示項目，右擊滑鼠選擇New -> Web Service...次項目，如圖3請於Name and Location對話方塊中完成Web Service Name為WelcomeWebService，package則輸入jcode.test.ws，其他部份保持預設值。

圖3. 於Name and Location對話方塊中完成Web Service Name和package配置

在建立第一支WelcomeWebService之後， 請切換「Design」模式以圖形化模式操作來建立Web Service的方法(圖4)，

圖4. 切換「Design」模式以圖形化模式操作來建立Web Service的方法

將滑鼠移至「Add Opertion...」按鈕(圖5)，加入Name為welcome、Return Type為java.lang.String、Parameters部分我們增加一個input的參數為java.lang.String型態，然後按OK按鈕就完成了一個welcome的Web Service方法。

圖5. 透過Add Opertion...按鈕來建立新的welcome方法

雖然已經完成了welcome方法，但還是有所不足，因此需要微幅修改剛才建立好的方法，麻煩再從「Design」模式切換到「Source」模式來直接修改程式代碼，請修改下圖6的紅色框線標示的一段程式碼。 (欲加入程式代碼： return "Welcome "+input+"!!"; )

圖6. 於welcome方法中修改程式代碼

部署與測試Web Service

當撰寫好第一支WelcomeWebService服務之後，我們可以選擇GlassFish 3或Tomcat 6.0作為部署與當駐Web Service服務的Application Server。在這裏我們採用了NetBean IDE 6.9內附的GlassFish  3 Server並加以圖例說明，來實現簡單部署與測試Web Service過程。

1. 點擊「Services」項目按鈕(位於Welcome專案左上方的位置)，後將滑鼠移動至Servers -> GlassFish Server 3次項目，點擊滑鼠右鍵出現脈絡選單(Context Menu)選擇「 start 」項目來啟動Ap Server(圖7)。
2. 再把畫面切換回 「Projects」 項目按鈕，把滑鼠指向Welcome專案的小圖示，點選滑鼠右鍵所帶出來的脈絡選單內的「Deploy」，把該專案佈署到剛才已啟動的Ap Server上 (圖8) 。
3. 最後就是要測試一下WelcomeWebService服務的WSDL連結是不是可以正常的連線 (請於Browser輸入http://localhost:8080/Welcome/WelcomeWebServiceService?wsdl測試連結) ，而且返回符合W3C所定義的Web Service WSDL的XML文件格式 (圖9) 。

         

圖7. 啟動GlassFish Server 3應用伺服器

圖8. 佈置Welcome專案到GlassFish Server 3應用伺服器上

圖9. 測試WelcomeWebService服務是否可以正常連線運作