5天學會jaxws-webservice編程第二天

標籤：main   拷貝   資料結構   用戶端   cell   wsdl   java se   throws   http   

第二天

前言：

大家都知道，僅僅輸入或者返回一個簡單型的String,  Int在實際工作中沒有太大的意義。很多時候我們的Service需要返回類似於List<Person>,List<String>這樣的資料結構。

我們現在就一起來看用Jaxws怎麼實現。

 

目標:

1． 用Webservice調用和返回Java的複雜類型（比如說：List<Student>這樣的資料）

一、編寫Server端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瀏覽器，輸入：

http://localhost:9090/JaxWSSample/CollectionWSService?wsdl，可以看到如下的wsdl輸出。

 

一、編寫Client端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>這樣的對象給用戶端

5天學會jaxws-webservice編程第二天