在jdk1.6环境下开发web service是非常方便,因为jdk1.6已经集成了JAX-WS,大大减低了开发中的编码难度。
首先定义服务接口
package com.lovo;
import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;
import javax.jws.soap.SOAPBinding.Use;
import com.lovo.po.Book;
import com.lovo.po.Person;
@WebService
@SOAPBinding(style = Style.DOCUMENT,use = Use.LITERAL)
public interface TestService {
@WebMethod
public Person say(Book s);
}
@SOAPBinding(style = Style.DOCUMENT,use = Use.LITERAL) 指明绑定方式为DOCUMENT。
按照WS-I指导原则,use属性的取值选择literal。
然后实现服务接口
package com.lovo;
import java.util.ArrayList;
import java.util.List;
import javax.jws.WebService;
import com.lovo.po.Book;
import com.lovo.po.Person;
@WebService(endpointInterface="com.lovo.TestService")
public class TestServiceImpl implements TestService{
public Person say(Book s){
Person p = new Person();
p.setId(4);
p.setName(s.getName() + "........");
List<Book> list = new ArrayList<Book>();
list.add(new Book(1,"w"));
list.add(new Book(2,"s"));
list.add(new Book(3,"t"));
p.setBookList(list);
Book b = new Book(4,"测试");
p.setBook(s);
return p;
}
}
在实现接口时通过
@WebService(endpointInterface="com.lovo.TestService")指定服务接口的全类名。
在接口和实现类中出现的Peson和Book是2个pojo。
package com.lovo.po;
public class Book {
public Book(){
}
public Book(int i,String n){
this.id = i;
this.name = n;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
private int id;
private String name;
}
package com.lovo.po;
import java.util.List;
public class Person {
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public List<Book> getBookList() {
return bookList;
}
public void setBookList(List<Book> bookList) {
this.bookList = bookList;
}
public Book getBook() {
return book;
}
public void setBook(Book book) {
this.book = book;
}
private int id;
private String name;
private List<Book> bookList;
private Book book;
}
在Person类中,持有Book类的一个引用和1个Book类的集合属性。
整个服务端的开发就完成了,可以用EndPoint发布后查看wsdl。也可以发布到web容器中,例如:Tomcat
如何将上述代码发布到Tomcat中?
web.xml中需要添加以下内容
<listener>
<listener-class>
com.sun.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
<servlet>
<servlet-name>TestService</servlet-name>
<servlet-class>
com.sun.xml.ws.transport.http.servlet.WSServlet
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>TestService</servlet-name>
<url-pattern>/lovo</url-pattern>
</servlet-mapping>
我的url映射为/lovo
另外在web.xml的同级目录下(也就是WEB-INF)需要定义一个sun-specific的配置文件,因为WSServletContextListener这个监听器会读取这个配置文件。文件命名为sun-jaxws.xml,内容:
<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0">
<endpoint name="TestService" implementation="com.lovo.TestServiceImpl" url-pattern="/lovo" />
</endpoints>
实际上就是定义了服务名和服务的实现以及url映射。
在这个文件中可以指定多个服务端点。
现在发布项目到Tomcat中完成服务端部署。
但是在Tomcat启动过程中会大量出现ClassNotFoundException,在Tomcat6.0环境下,需要导入一些jar包。
以下是我导入的jar包
jaxb-impl-2.1.12.jar
jaxws-rt-2.1.4.jar
stax-ex-1.2.jar
streambuffer-0.8.jar
现在Tomcat,就可以正常启动了,同时生成了一些JAX-B工件,通过http://localhost:8888/service/lovo?wsdl来检查服务是否部署成功。
至此服务端开发结束。
在已知wsdl文件的情况下,利用jdk1.6中的wsimport工具,生成客户端支持代码非常方便。
例如:wsimport -keep -p service.client http://localhost:8888/service/lovo?wsdl
表示在当前目录下,依据http://localhost:8888/service/lovo?wsdl的内容,生成包名为service.client的java文件和class文件。
利用wsimport工具生成的客户端支持代码可以快速的进行客户端开发。
在这个例子中,通过
TestServiceImplService ss = new TestServiceImplService();
TestService service = ss.getTestServiceImplPort();
2行代码获取服务接口的引用,从而可以开始方法调用。
最后推荐一个jar包下载的好地方,http://www.jarvana.com/jarvana/。
在已知类名的情况下,可以找到相应的jar包。