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>這樣的物件給客戶端