在第二天的学习中,我们了解了jaxws如何返回一个List<String>类型的相对复杂的java数据类型给客户端,在今天,我们将更深入一步做一个真正的Java复杂类型的Webservice的传输调用。
目标:
1. 用Webservice调用和返回Java的复杂类型(比如说:List<Student>这样的数据)
这次我们将返回一个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;
}
}
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结构的数据
此处的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输出。
?
?
此处的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文件的路径
?
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图片