jaxws-webservice编程续

次日

前言：

你们都知道，仅仅输入或者返回一个简单型的String,  Int在实际工做中没有太大的意义。不少时候咱们的Service须要返回相似于List<Person>,List<String>这样的数据结构。

咱们如今就一块儿来看用Jaxws怎么实现。

 

目标:

1． 用Webservice调用和返回Java的复杂类型（好比说：List<Student>这样的数据）

1、编写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输出。

1、编写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")

3、结束次日

在第三天内咱们会深刻讲述用jaxws返回真正意义上的复杂类型即: List<Person>这样的对象给客户端