1. 程式人生 > >5天學會jaxws-webservice程式設計第二天

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