JAX-WS集成Web工程的Web Service的创建和发布简单入门（1）

 

      首先， 为了我们这个WS的实验能够顺利的完成，最好能到官网上下载到JAX-WS工具的完整版。下载到的是一个jar文件，需要在Windows命令行下运行jar命令解压安装的，比如我这边有个JAXWS2.1.1_20070501.jar。安装后得到一个目录，其中有个lib下有许多jar文件。bin目录下有几个命令，很有用的，如wsgen和wsimport等，当然，我提过，这两个命令在JDK6中已经有的了。

     现在开始做实验了。

    服务端

    1、新建web项目，将来准备发布到tomcat的。我这里新建的Web项目名为myWS2，目录所在：D:\workspace\myWS2，在这个项目根目录下新建一个文件夹wsdl

    2、为了方便，先导入这些个包吧：jaxws-rt.jar，jaxb-api.jar，jaxb-impl.jar，jaxb-xjc.jar，streambuffer.jar，stax-ex.jar，这些jar包只是运行下面的最简单的实验需要的jar包，实际操作中，如果你需要更多的jar包也是很正常的，这些jar包都是来自JAX-WS。

    3、在Web工程中新建类：

package leon.ws;

import javax.jws.WebService;

@WebService
public class Hello {
	public String sayHello(String name) {
		return ("Welcome, I am Server. Hello, " + name);
	}

	public int sum(int a, int b) {
		return a + b;
	}
}

    OK，非常简单，只有一个@WebService注解，类中的两个方法都没有使用@WebMethod注解，这样其实两个方法都会成为Web Service方法的。

   4、很重要的一步，就是要利用wsgen工具来生成wsdl和服务端辅助类了。打开DOS命令行，进入到服务端web工程的根目录，运行一下命令：

        wsgen -cp D:\workspace\myWS2\WebRoot\WEB-INF\classes leon.ws.Hello -wsdl -s src -r wsdl

       注意：这里的路径非常重要的，如果你的路径不一样一定要改对了。wsgen命令使用的是JDK6里面的，所以要配置好JDK环境变量，如果你用的JDK版本低，没有这工具，需要将下载安装的JAX-WS的bin下面的工具配置到环境变量path下。

      运行成功以后，刷新一下web工程目录下wsdl目录，可以看到两个文件了，一个xsd和一个wsdl，刷新一下src看到产生了jaxws包和4个类，也就是上面的Hello.java中，每个方法对应生成两个类。

   5、在WEB-INF下新建一个sun-jaxws.xml，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime">

  <endpoint name="Hello" implementation="leon.ws.Hello" url-pattern="/HelloService" />
  
</endpoints>

     这是定义WS的Endpoint的，实现类与上面定义的Hello.java对应好，两外两个属性name, url-pattern自己定义吧，不过最好合理一点。

 6、修改web.xml配置一个监听器，和一个Servlet将我们的Hello.java及其方法绑定成为Servlet，内容如下：

    

<listener>
	<listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
</listener>

<servlet>
	<servlet-name>Hello</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>Hello</servlet-name>
	<url-pattern>/HelloService</url-pattern>
</servlet-mapping>

现在工程的目录结构如下：

发布到tomcat，运行，这个服务端Web工程会被tomcat加载。

tomcat启动成功后。浏览器访问：http://10.225.112.86:8888/myWS2/HelloService?wsdl

如果浏览器呈现出wsdl文件内容，就表示发布成功了。服务端完成。

说明：我这里的tomcat是在本机的局域网IP上启动的，所以访问的地址也是IP来的，如果你的使用localhost也是可以的，没问题。

 客户端：

服务端的代码如何组织创建，可以参考我的另一篇文章：“JAX-WS一个很简单的RPC风格的Web Service同步调用”

因为我们已经能访问到服务端的wsdl文件，所以客户端就可以有各种途径来访问服务端WS了。