首页 > 代码库 > 5天学会jaxws-webservice编程第二天

5天学会jaxws-webservice编程第二天

第二天

前言:

大家都知道,仅仅输入或者返回一个简单型的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编程第二天