Tomcat 发布基于JAX-WS的项目流程小案例

lyl801013

　　前面是基于java Application发布webservice的服务，现在我们以前看一个用Tomcat发布服务的过程。
　　这个WebService主要是对书的管理的小功能实现。
　　1、首先我们建立一个Dynamic WEB项目，看下这个项目的结构：

　　2、首先看下实体类：Book.java

package com.lyl.vo;
public class Book {
private int bookId;
private String bookName;
private int bookPrice;
public Book() {
super();
}
public Book(int bookId, String bookName, int bookPrice) {
super();
this.bookId = bookId;
this.bookName = bookName;
this.bookPrice = bookPrice;
}
public int getBookId() {
return bookId;
}
public void setBookId(int bookId) {
this.bookId = bookId;
}
public String getBookName() {
return bookName;
}
public void setBookName(String bookName) {
this.bookName = bookName;
}
public int getBookPrice() {
return bookPrice;
}
public void setBookPrice(int bookPrice) {
this.bookPrice = bookPrice;
}
}

　　3、持久层 BookDao.java

package com.lyl.dao;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import com.lyl.vo.Book;
public class BookDao {
private Map<String,Book> bookMap=new HashMap<String,Book>();
private static BookDao bookDao;
public static BookDao newStance(){
if( bookDao==null){
bookDao=new BookDao();
}
return bookDao;
}
private BookDao(){
bookMap.put("三国演义", new Book(1,"三国演义",20));
}

public void add(Book b) throws BookException{
if(bookMap.containsKey(b.getBookName())){
throw new BookException("此书已存在");
}
bookMap.put(b.getBookName(), b);
}
public List<Book> list(){
ArrayList<Book> bookList=new ArrayList<Book>();
Set<String> bookNames=bookMap.keySet();
for(String bookName:bookNames){
bookList.add(bookMap.get(bookName));
}
return bookList;
}
public Book findBookByName(String bookName) throws BookException{
Book book=bookMap.get(bookName);
if(book==null){
throw new BookException("此书不存在");
}
return book;
}


}

　　3、异常处理类:BookException.java(注意通过注解@WebFault表示是用来封装服务端程序处理过程中出现异常，以便通过消息传递到客户端，而不会在服务端报异常)

package com.lyl.dao;
import javax.xml.ws.WebFault;
@WebFault(faultBean="com.lyl.BookException",messageName="BookException" ,name="fault")
public class BookException extends Exception {
public BookException() {
super();
// TODO Auto-generated constructor stub
}
public BookException(String message, Throwable cause) {
super(message, cause);
// TODO Auto-generated constructor stub
}
public BookException(String message) {
super(message);
// TODO Auto-generated constructor stub
}
public BookException(Throwable cause) {
super(cause);
// TODO Auto-generated constructor stub
}
}

　　3、具体的业务操作接口，也就WebService的服务接口 
　　IBookBiz.java

package com.lyl.service;
import java.util.List;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import com.lyl.dao.BookException;
import com.lyl.vo.Book;
@WebService
public interface IBookBiz {
@WebResult
public void add(@WebParam(name="book")Book b) throws BookException;
@WebResult(name="bookList")
public List<Book> list();
@WebResult(name="book")
public Book findBookByName(@WebParam(name="bookName")String bookName) throws BookException;
}

　　实现类： BookBizImpl .java

package com.lyl.service;
import java.util.List;
import javax.jws.WebService;
import com.lyl.dao.BookDao;
import com.lyl.dao.BookException;
import com.lyl.vo.Book;
@WebService(endpointInterface="com.lyl.service.IBookBiz",targetNamespace="http://service.lyl.com")
public class BookBizImpl implements IBookBiz {
private BookDao bookDao=BookDao.newStance();
@Override
public void add(Book b) throws BookException {
bookDao.add(b);
}
public List<Book> list() {
return bookDao.list();
}
public Book findBookByName(String bookName) throws BookException {
return bookDao.findBookByName(bookName);
}
}

　　需要的类我们都准备好了，现在是如何利用Tomcate在启动的时候将WebService发布出去，这里我们就需要引入第三方法的jar包，我们可以到http://jax-ws.java.net/2.2.5/ 官方网上下载所有基于java API for XML 开发webservice需要的jar包，拷贝其中lib目录下的jar包到项目中的lib目录下。
　　因为要在Tomcat启动时候就加载，因此在web.xml文件中配置如下内容：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
id="WebApp_ID"
version="2.5">

<listener>
<listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
</listener>
<!-- 其中是servlet-name和sun-jaxws中endpoint中的name一致 -->
<servlet>
<servlet-name>bookService</servlet-name>
<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>bookService</servlet-name>
<url-pattern>/book</url-pattern>
</servlet-mapping>
</web-app>
　　然后再WEB-INF目了下添加一个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表示一个发布的webservice服务，name要和web.xml中servlet的name一致，url-pattern和servlet的url-pattern一致-->
<endpoint name="bookService"
implementation="com.lyl.service.BookBizImpl" url-pattern="/book"/>
</endpoints>

　　在endpoint中的url-pattern指定了我们可以通过"http://localhost:port/projectName/url_pattern"发布的地址。
　　因此在启动Tomcate后输入http://localhost:8080/test_soa_web1/book?wsdl将可以看到如下WSDL文件信息：

<?xml version="1.0" encoding="UTF-8" ?>
- <!--  Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.5-b05 .
-->
- <!--  Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.5-b05 .
-->
- <definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://service.lyl.com" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://service.lyl.com" name="BookBizImplService">
<import namespace="http://service.lyl.com/" location="http://localhost:8080/test_soa_web1/book?wsdl=1" />
- <binding xmlns:ns1="http://service.lyl.com/" name="BookBizImplPortBinding" type="ns1:IBookBiz">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
- <operation name="add">
<soap:operation soapAction="" />
- <input>
<soap:body use="literal" />
</input>
- <output>
<soap:body use="literal" />
</output>
- <fault name="BookException">
<soap:fault name="BookException" use="literal" />
</fault>
</operation>
- <operation name="list">
<soap:operation soapAction="" />
- <input>
<soap:body use="literal" />
</input>
- <output>
<soap:body use="literal" />
</output>
</operation>
- <operation name="findBookByName">
<soap:operation soapAction="" />
- <input>
<soap:body use="literal" />
</input>
- <output>
<soap:body use="literal" />
</output>
- <fault name="BookException">
<soap:fault name="BookException" use="literal" />
</fault>
</operation>
</binding>
- <service name="BookBizImplService">
- <port name="BookBizImplPort" binding="tns:BookBizImplPortBinding">
<soap:address location="http://localhost:8080/test_soa_web1/book" />
</port>
</service>
</definitions>
　　同样我们通过wsimport 命令生成客户端代码：

　　新建客户端项目：添加客户端代码和测试类，引入Junit4库。

import java.util.List;
import org.junit.Before;
import org.junit.Test;
import com.lyl.service.Book;
import com.lyl.service.BookBizImplService;
import com.lyl.service.BookException_Exception;
import com.lyl.service.IBookBiz;

public class TestBookService {
IBookBiz bz;
@Before
public void init(){
BookBizImplService bbs=new BookBizImplService();
bz=bbs.getBookBizImplPort();
}

@Test
public void testAdd(){
Book book=new Book();
book.setBookId(2);
book.setBookName("水浒传");
book.setBookPrice(100);
try {
bz.add(book);
} catch (BookException_Exception e) {
// TODO Auto-generated catch block
System.out.println(e.getMessage());
}
}

@Test
public void testList(){
List<Book> bookList=bz.list();
for(Book book:bookList){
System.out.println(book.getBookName());
}
}
@Test
public void testFindByName(){
String bookName="销售";
try {
Book book=bz.findBookByName(bookName);
System.out.println(bookName+"的价格是："+book.getBookPrice());
} catch (BookException_Exception e) {
// TODO Auto-generated catch block
System.err.println(e.getMessage());
}
}

}

　　好了，这就是整个的流程，下面有源码，不过jar要自己到上面提供的官网下载，有什么问题或意见欢迎提出。