首先, 为了我们这个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了。