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

前言：

在第二天的学习中,我们了解了jaxws如何返回一个List<String>类型的相对复杂的java数据类型给客户端，在今天，我们将更深入一步做一个真正的Java复杂类型的Webservice的传输调用。

目标:

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

一、编写Server端

1.1制作JAVA BEAN-Person对象

这次我们将返回一个List<Person>类型给客户端。

先来制作我们的Person类，代码如下：

package ctsjavacoe.ws.fromjava.bean;

import java.io.*;

public class Person implements Serializable {

private String name = "";

private int age = 0;

private String gender = "";

public String getName() {

return name;

}

public void setName(String name) {

this.name = name;

}

public int getAge() {

return age;

}

public void setAge(int age) {

this.age = age;

}

public String getGender() {

return gender;

}

public void setGender(String gender) {

this.gender = gender;

}

}

1.2制作Service端

package ctsjavacoe.ws.fromjava;

import java.util.ArrayList;

import java.util.List;

import ctsjavacoe.ws.fromjava.bean.*;

import javax.jws.WebMethod;

import javax.jws.WebService;

@WebService

public class JavaComplexType {

@WebMethod

public List<Person> getPerson() {

List<Person> testList = new ArrayList<Person>();

Person p = new Person();

p.setName("abc");

p.setAge(31);

p.setGender("female");

testList.add(p);

p = new Person();

p.setName("def");

p.setAge(33);

p.setGender("male");

testList.add(p);

p = new Person();

p.setName("aaa");

p.setAge(26);

p.setGender("female");

testList.add(p);

return testList;

}

}

该Service没有Input，只有一个Output，该Output为一个List<Person>类型，它将返回一个List给客户端，该List中有三条Person结构的数据

1.2编译

此处的Webservice Server端生成的全部详细过程请参见“第一天”教程中的描述。

1. 用wsgen来编译生成相关的java文件，wsdl文件与xsd文件；

2. 将编译时输出至wssrc目录的文件拷贝至src目录；

3. 修改WebContent\WEB-INF目录下的sun-jaxws.xml文件，加入：

<endpoint name='JavaComplexType'

implementation='ctsjavacoe.ws.fromjava.JavaComplexType'

url-pattern='/JavaComplexTypeService' />

 

 

 

 

4．修改WebContent\WEB-INF目录下的web.xml加入：

<servlet>

<servlet-name>JavaComplexType</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>JavaComplexType</servlet-name>

<url-pattern>/JavaComplexTypeService</url-pattern>

</servlet-mapping>

5. 将JaxWSProject的WebContent目录下的文件拷贝至tomcat的webapps\JaxWSSample

目录下，并选择全部覆盖；

6．重启Tomcat；

7．打开一个IE浏览器，输入：

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

 

一、编写Client端

2.1编译前的准备

 

此处的Webservice Client端生成的全部详细过程请参见“第一天”教程中的描述。

1. 把Server端生成的wsdl与xsd拷贝至client工程的wsdl目录下

2. 将ctsjavacoe.ws.fromjava.bean.Person这个类拷贝到client工程的相应的src目录下，因为在第二天中，我们使用的是List<String>，String对应的xsd中的string是webservice的一个基本类型，因此不需要在客户端再造型。

而我们这次的返回是一个List<Person>,这个person类可不是xsd所本身拥有的数据类型，因此当客户端得到webservice的返回时，需要在客户端对这个Person做造型，而造型时需要有一个Object来告诉客户端我造出的型是什么东东，因此这边比第二天教程中多出了一步，即手工拷贝Person类至Client工程。

3. 由于我们继续使用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/JavaComplexTypeService.wsdl"

xmlns="http://java.sun.com/xml/ns/jaxws">

<bindings node="wsdl:definitions">

<enableAsyncMapping>true</enableAsyncMapping>

</bindings>

</bindings>

4. 使用wsimport命令来生成client端调用时所需要的“句柄”

5. 把生成的句柄中的JavaComplexTypeService.java这个文件打开，编辑它，将里面两处Url url=……的地方改成你的Server端实际的Webservice的wsdl地址，而默认它是指向一个本地的wsdl文件的路径

 

2.2书写Test客户端调用Webservice的Server端

package ctsjavacoe.ws.fromjava;

import javax.xml.ws.Response;

import java.util.*;

import ctsjavacoe.ws.fromjava.bean.*;

public class JavaComplexTypePollingClient {

public static void main(String[] args) {

JavaComplexTypeService service = new JavaComplexTypeService();

JavaComplexType port = service.getJavaComplexTypePort();

Response<GetPersonResponse> getPersonAsync = port.getPersonAsync();

while (!getPersonAsync.isDone()) {

System.out.println("is not done");

}

List<Person> rtnList = new ArrayList<Person>();

try {

GetPersonResponse getPersonResponse = getPersonAsync.get();

rtnList = getPersonResponse.getReturn();

System.out.println("return size======" + rtnList.size());

for (Person p : rtnList) {

System.out.println("person=====" + p.getName() + " "

+ p.getAge() + " " + p.getGender());

}

} catch (Exception ex) {

ex.printStackTrace();

}

}

}

 

 

当我们在eclipse里键入getPersonResponse.getReturn()：

 

可以看到jaxws已经帮我们把List<Person>转型过来了，我们只需要用相应的泛型：

List<Person>rtnList = new ArrayList<Person>()去把它接出来就行了。

运行该客户端，得到如下输出：

 

三、结束第三天

 

通过第二天，第三天的学习，我们已经基本掌握了jaxws一般的应用，对于java复杂类型的传输有了全面的了解。

在未来两天的学习中，我们将使用jaxws的MTOM feature，用webservice来传输二进制文件，比如说：jpg/gif图片