次日java
你們都知道,僅僅輸入或者返回一個簡單型的String, Int在實際工做中沒有太大的意義。不少時候咱們的Service須要返回相似於List<Person>,List<String>這樣的數據結構。node
咱們如今就一塊兒來看用Jaxws怎麼實現。web
目標: 瀏覽器
1. 用Webservice調用和返回Java的複雜類型(好比說:List<Student>這樣的數據)tomcat
在正式作咱們的複雜類型返回前,咱們先作一個試驗來證實jaxws可否返回複雜類型即Collection這樣的對象,咱們先來試試用jaxws的webservice返回一個List<String>。數據結構
由於,webservice除簡單類型如:int, string這些對象, 對於複雜類型的返回,它使用的是serialize和deserialize的機制。app
即:在傳送複雜對象時,webservice會把複雜類型serialize一下,在客戶端獲得server端的返回時再把對象deserialize出來,因此咱們先用這個小實驗來驗證一下jaxws的serialize-deserialize的能力如何。eclipse
如下時咱們的Server端代碼:webapp
package ctsjavacoe.ws.fromjava;異步 import java.util.*; import javax.jws.WebMethod; import javax.jws.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>類型。
此處的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瀏覽器,輸入:
http://localhost:9090/JaxWSSample/CollectionWSService?wsdl,能夠看到以下的wsdl輸出。
此處的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文件的路徑
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>這樣的對象給客戶端