【Java】Java6 WebService的发布

时间:2021-01-07 07:36:11
WebService服务发布往往比较混乱,Axis2的发布形式与XFire发布方式差别很大,而Java6 Web服务的发布与Axis2、XFire的Web服务的发布方式也有着天壤之别,它们之间没有经验可以借鉴。
 
因此,很有必要钻研下Java6的Web服务的发布方式。
 
从前面两篇文章可以看出Java6对WebService的发布提供了API级别的直接支持,发布只需要一行代码就搞定了。但是作为一个服务,就需要启动,总不能每次启动都去运行一个Main方法来启动吧。
 
实际中Web服务的发布常常伴随着Web容器的启动而发布,而在Java6中,我们没法直接像Axis2和XFire那样直接去发布,但是可以通过变通的方法,通过Servlet来和容器绑定起来,在容器启动的时候发布服务。
 
下面以Tomcat为例,来实现Java6 Web服务的发布。
 
1、开发WebService服务
 
package lavasoft.server;

import javax.jws.WebService;

/** 
* Java6开发的WebService服务端 

* @author leizhimin 2009-11-16 10:24:13 
*/ 
@WebService 
public class Java6WS {

/** 
         * Web服务中的业务方法 
         * 
         * @return 一个字符串 
         */ 
        public String doSomething(String username) { 
                return username + " is doing something!"; 
        } 
}

 
2、开发发布服务的Servlet,为了通用性,最好选择GenericServlet来继承
 
package lavasoft.servlet;

import lavasoft.server.Java6WS;

import javax.servlet.*; 
import javax.xml.ws.Endpoint; 
import java.io.IOException;

/** 
* 发布Java6 WebService的Servlet, 

* @author leizhimin 2009-11-16 13:52:49 
*/ 
public class WSServlet extends GenericServlet { 
        @Override 
        public void init(ServletConfig servletConfig) throws ServletException { 
                super.init(servletConfig); 
                System.out.println("准备启动WebService服务:http://192.168.14.117:8888/java6ws/Java6WS"); 
                //发布一个WebService 
                Endpoint.publish("http://192.168.14.117:8888/java6ws/Java6WS", new Java6WS()); 
                System.out.println("已成功启动WebService服务:http://192.168.14.117:8888/java6ws/Java6WS");

}

public void service(ServletRequest servletRequest, ServletResponse servletResponse) throws ServletException, IOException { 
                System.out.println("此Servlet不处理任何业务逻辑,仅仅yonglai发布一个Web服务:http://192.168.14.117:8888/java6ws/Java6WS"); 
        } 
}

 
这里将服务发布的代码写在了Servlet的init()方法中,当Servlet加载时候,会自动执行init()里面的方法。从而达到发布服务的目的,由于此Servlet不处理任何业务,因此,在Service里面仅仅写了一个提示性的语句。
 
3、配置web.xml
 
<?xml version="1.0" encoding="UTF-8"?> 
<web-app xmlns="http://java.sun.com/xml/ns/javaee" 
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
        http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
                 version="2.5">

<welcome-file-list> 
                <welcome-file>index.jsp</welcome-file> 
        </welcome-file-list>

<servlet> 
                <servlet-name>WSServlet</servlet-name> 
                <servlet-class>lavasoft.servlet.WSServlet</servlet-class> 
                <load-on-startup>1</load-on-startup> 
        </servlet> 
        <servlet-mapping> 
                <servlet-name>WSServlet</servlet-name> 
                <url-pattern>/servlet/WSServlet</url-pattern> 
        </servlet-mapping> 
</web-app>

 
注意,上面的Servlet比一般Servlet配置多了一行:
<load-on-startup>1</load-on-startup>
,这样写的目的是Servlet能伴随容易的启动在第一时间加载。以便服务能尽可能早的发布,否则,只有在第一次请求该Servlet的时候,才会被加载到容器。
 
4、部署、启动并测试
 
启动Tocmat6,浏览器中输入:http://localhost:8080/java6ws/
【Java】Java6 WebService的发布
 
点击超链接,可以获取到WSDL如下:
【Java】Java6 WebService的发布
可见,服务伴随着tomcat的启动发布成功。
 
5、总结
 
1)、Java6的服务发布的总体思想是通过Java6 API的调用达到发布的目的,截止目前,已经看到两种发布方式,一种是直接调用API:
Endpoint.publish("http://192.168.14.117:8888/java6ws/Java6WS", new Java6WS());
另一种是,本例中Servlet方式。
 
2)、Endpoint.publish是一个后台线程,一旦发布了就会一直等待处理Web服务的请求,只有当main方法退出,或者容器关闭的时候,才自动退出。
 
3)、其实除了这种方式,也可以整合Spring来实现服务的发布,这就和Spring的Ioc容器整合在一起了。不管什么,道理就一个,调用Endpoint.publish()方法来实现服务的发布。
 
4)、在发布服务的时候,应该避免使用Tomcat容器的端口,一面发生冲突,在本文中,Tomcat使用的端口是8080,而Web服务发布使用的端口是8888。