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

来源:互联网 发布:溧阳市各乡镇经济数据 编辑:程序博客网 时间:2024/05/16 16:23
首先, 为了我们这个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工程中新建类:

[java] view plaincopy
  1. package leon.ws;  
  2.   
  3. import javax.jws.WebService;  
  4.   
  5. @WebService  
  6. public class Hello {  
  7.     public String sayHello(String name) {  
  8.         return ("Welcome, I am Server. Hello, " + name);  
  9.     }  
  10.   
  11.     public int sum(int a, int b) {  
  12.         return a + b;  
  13.     }  
  14. }  

    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,内容如下:

[html] view plaincopy
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime">  
  3.   
  4.   <endpoint name="Hello" implementation="leon.ws.Hello" url-pattern="/HelloService" />  
  5.     
  6. </endpoints>  

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

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

    

[html] view plaincopy
  1. <listener>  
  2.     <listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>  
  3. </listener>  
  4.   
  5. <servlet>  
  6.     <servlet-name>Hello</servlet-name>  
  7.     <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>  
  8.     <load-on-startup>2</load-on-startup>  
  9. </servlet>  
  10.       
  11. <servlet-mapping>  
  12.     <servlet-name>Hello</servlet-name>  
  13.     <url-pattern>/HelloService</url-pattern>  
  14. </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了。


转载:http://blog.csdn.net/leon709/article/details/7107764



原创粉丝点击