jdk1.6环境下开发web service的简单例子

在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包。