5天學會jaxws-webservice程式設計第二天
第二天
前言:
大家都知道,僅僅輸入或者返回一個簡單型的String, Int在實際工作中沒有太大的意義。很多時候我們的Service需要返回類似於List<Person>,List<String>這樣的資料結構。
我們現在就一起來看用Jaxws怎麼實現。
目標:
1. 用Webservice呼叫和返回Java的複雜型別(比如說:List<Student>這樣的資料)
1.1先對jaxws返回List型別做一個簡單的POC
在正式做我們的複雜型別返回前,我們先做一個試驗來證明jaxws能否返回複雜型別即Collection這樣的物件,我們先來試試用jaxws的webservice返回一個List<String>。
因為,webservice除簡單型別如:int, string這些物件, 對於複雜型別的返回,它使用的是serialize和deserialize的機制。
即:在傳送複雜物件時,webservice會把複雜型別serialize一下,在客戶端得到server端的返回時再把物件deserialize出來,所以我們先用這個小實驗來驗證一下jaxws的serialize-deserialize的能力如何。
以下時我們的Server端程式碼:
package ctsjavacoe.ws.fromjava; import java.util.*; import javax.jws.WebMethod; import javax.jws.WebService; @WebService public class CollectionWS { @WebMethod public List<String> rtnMethod() { List<String> testList = new ArrayList<String>(); testList.add("abc"); testList.add("efg"); testList.add("111"); return testList; } } |
非常簡單,沒什麼好多說。
該Service沒有Input,只有一個Output,該Output為一個List<String>型別。
1.2編譯
此處的Webservice Server端生成的全部詳細過程請參見“第一天”教程中的描述。
1. 用wsgen來編譯生成相關的java檔案,wsdl檔案與xsd檔案;
2. 將編譯時輸出至wssrc目錄的檔案拷貝至src目錄;
3. 修改WebContent\WEB-INF目錄下的sun-jaxws.xml檔案,加入:
<endpoint name='CollectionWS' implementation='ctsjavacoe.ws.fromjava.CollectionWS' url-pattern='/CollectionWSService' /> |
4.修改WebContent\WEB-INF目錄下的web.xml加入:
<servlet> <servlet-name>CollectionWS</servlet-name> <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class> <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping> <servlet-name>CollectionWS</servlet-name> <url-pattern>/CollectionWSService</url-pattern> </servlet-mapping> |
5. 將JaxWSProject的WebContent目錄下的檔案拷貝至tomcat的webapps\JaxWSSample
目錄下,並選擇全部覆蓋;
6.重啟Tomcat;
7.開啟一個IE瀏覽器,輸入:
2.1編譯前的準備
此處的Webservice Client端生成的全部詳細過程請參見“第一天”教程中的描述。
1. 把Server端生成的wsdl與xsd拷貝至client工程的wsdl目錄下
2. 由於我們繼續使用polling方式來書寫非同步的客戶端呼叫,因此我們還需要開啟binding.xml檔案,更改一下:
<?xml version="1.0" encoding="UTF-8"?> <bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" wsdlLocation="wsdl/CollectionWSService.wsdl" xmlns="http://java.sun.com/xml/ns/jaxws"> <bindings node="wsdl:definitions"> <enableAsyncMapping>true</enableAsyncMapping> </bindings> </bindings> |
3. 使用wsimport命令來生成client端呼叫時所需要的“控制代碼”
4. 把生成的控制代碼中的CollectionWSService.java這個檔案開啟,編輯它,將裡面兩處Url url=……的地方改成你的Server端實際的Webservice的wsdl地址,而預設它是指向一個本地的wsdl檔案的路徑
2.2書寫Test客戶端呼叫Webservice的Server端
package ctsjavacoe.ws.fromjava; import javax.xml.ws.Response; import java.util.*; public class CollectionWSPollingClient { public static void main(String[] args) throws Exception { CollectionWSService service = new CollectionWSService(); CollectionWS port = service.getCollectionWSPort(); Response<RtnMethodResponse> rtnMethodAsync = port.rtnMethodAsync(); while (!rtnMethodAsync.isDone()) { System.out.println("is not done"); } List<String> rtnList = new ArrayList<String>(); try { RtnMethodResponse collectionResponse = rtnMethodAsync.get(); rtnList = collectionResponse.getReturn(); System.out.println("return size======" + rtnList.size()); for (String str : rtnList) { System.out.println("output=====" + str); } } catch (Exception ex) { ex.printStackTrace(); } } } |
尤其是當我們在eclipse裡鍵入collectionResponse.getReturn();這一句話時我們來看看發生了什麼:
可以看到,jaxws生成的客戶端已經幫我們做好了“轉型”的工作,即:我們的資料在Server端是什麼型別,傳到客戶端時還是什麼型別,不需要我們自己去根據xsd或者相關的xml資料再轉成java的複雜型別了,jaxws真是一個好東西!
執行該客戶端,得到如下輸出:根據輸出,是3條記錄,這三條記錄是我們的Server端返回過來的資料,即:
testList.add("abc"); testList.add("efg"); testList.add("111") |
在第三天內我們會深入講述用jaxws返回真正意義上的複雜型別即: List<Person>這樣的物件給客戶端