WebService学习总结(三)——使用JDK开发WebService

一、WebService的开发手段

使用Java开发WebService时可以使用以下两种开发手段

1、 使用JDK开发(1.6及以上版本)

2、使用CXF框架开发(工作中)

二、使用JDK开发WebService

2.1、开发WebService服务器端

1、定义一个interface，使用@WebService注解标注接口，使用@WebMethod注解标注接口中定义的所有方法，如下所示：

package me.gacl.ws;  import javax.jws.WebMethod; import javax.jws.WebService;  /**  * @author gacl  * 定义SEI(WebService EndPoint Interface(终端))  */ //使用@WebService注解标注WebServiceI接口 @WebService public interface WebServiceI {      //使用@WebMethod注解标注WebServiceI接口中的方法     @WebMethod     String sayHello(String name);          @WebMethod     String save(String name,String pwd); }

2、编写interface的实现类，使用@WebService注解标注实现类，实现接口中定义的所有方法，如下所示：

package me.gacl.ws;  import javax.jws.WebService;  /**  * @author gacl  * SEI的具体实现  */ //使用@WebService注解标注WebServiceI接口的实现类WebServiceImpl @WebService public class WebServiceImpl implements WebServiceI {      @Override     public String sayHello(String name) {         System.out.println("WebService sayHello "+name);         return "sayHello "+name;     }      @Override     public String save(String name, String pwd) {         System.out.println("WebService save "+name+"， "+pwd);         return "save Success";     } }

3、使用Endpoint(终端)类发布webservice，代码如下：

package me.gacl.ws.test;  import javax.xml.ws.Endpoint;  import me.gacl.ws.WebServiceImpl;  /**  * @author gacl  *  * 发布Web Service  */ public class WebServicePublish {      public static void main(String[] args) {         //定义WebService的发布地址，这个地址就是提供给外界访问Webervice的URL地址，URL地址格式为：http://ip:端口号/xxxx         //String address = "http://192.168.1.100:8989/";这个WebService发布地址的写法是合法的         //String address = "http://192.168.1.100:8989/Webservice";这个WebService发布地址的是合法的         String address = "http://192.168.1.100:8989/WS_Server/Webservice";         //使用Endpoint类提供的publish方法发布WebService，发布时要保证使用的端口号没有被其他应用程序占用         Endpoint.publish(address , new WebServiceImpl());         System.out.println("发布webservice成功!");     } }

运行WebServicePublish类，就可以将编写好的WebService发布好了，WebService的访问URL是：​​http://192.168.1.100:8989/WS_Server/Webservice​​ ，如下图所示：

这里我们编写了一个WebServicePublish类来发布WebService，如果是Web项目，那么我们可以使用监听器或者Servlet来发布WebService，如下：

1、使用ServletContextListener监听器发布WebService

package me.gacl.listener;  import javax.servlet.ServletContextEvent; import javax.servlet.ServletContextListener; import javax.servlet.annotation.WebListener; import javax.xml.ws.Endpoint; import me.gacl.ws.WebServiceImpl;  /**  * @author gacl  * 用于发布WebService的监听器  */ //使用Servlet3.0提供的@WebListener注解将实现了ServletContextListener接口的WebServicePublishListener类标注为一个Listener @WebListener public class WebServicePublishListener implements ServletContextListener {      @Override     public void contextDestroyed(ServletContextEvent sce) {      }      @Override     public void contextInitialized(ServletContextEvent sce) {         //WebService的发布地址         String address = "http://192.168.1.100:8080/WS_Server/WebService";         //发布WebService，WebServiceImpl类是WebServie接口的具体实现类         Endpoint.publish(address , new WebServiceImpl());         System.out.println("使用WebServicePublishListener发布webservice成功!");     } }

将Web应用部署到服务器运行时，在初始化Web应用上下文时，就会发布WebService了。

接着我们可以使用发布的URL地址访问WebService，如下图所示：

2、使用Servlet发布WebService

package me.gacl.web.controller;  import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.xml.ws.Endpoint; import me.gacl.ws.WebServiceImpl;  /**  * @author gacl  * 用于发布WebService的Servlet  */ //使用Servlet3.0提供的@WebServlet注解将继承HttpServlet类的普通Java类标注为一个Servlet //将value属性设置为空字符串，这样WebServicePublishServlet就不提供对外访问的路径 //loadOnStartup属性设置WebServicePublishServlet的初始化时机 @WebServlet(value="",loadOnStartup=0) public class WebServicePublishServlet extends HttpServlet {      /* (non-Javadoc)      * @see javax.servlet.GenericServlet#init()      * 在WebServicePublishServlet初始化时发布WebService      */     public void init() throws ServletException {         //WebService的发布地址         String address = "http://192.168.1.100:8888/WebService";         //发布WebService，WebServiceImpl类是WebServie接口的具体实现类         Endpoint.publish(address , new WebServiceImpl());         System.out.println("使用WebServicePublishServlet发布webservice成功!");     } }

将Web应用部署到服务器运行时，在初始化WebServicePublishServlet时，就会发布WebService了。如下图所示：

接着我们可以使用发布的URL地址访问WebService，如下图所示：

关于发布WebService主要就是通过javax.xml.ws.Endpoint类提供的静态方法publish进行发布，如果是普通的java项目，那么可以专门写一个类用于发布WebService，如果是Web项目，那么可以使用ServletContextListener或者Servlet进行发布。

2.2、开发WebService客户端

1、借助jdk的wsimort.exe工具生成客户端代码，wsimort.exe工具位于Jdk的bin目录下，如下图所示：

执行命令：wsimport -keep url(url为wsdl文件的路径)生成客户端代码。

创建一个WebService客户端测试项目，如下图所示：

打开命令行窗口，切换到src目录，执行"wsimport -keep ​​http://192.168.1.100:8888/WebService?wsdl​​"生成客户端代码，如下图所示：

执行命令的过程中没有出现任何错误，那么代码就生成成功了，刷新一下src目录，就可以看到生成的代码了，如下图所示：

2、 借助生成的代码编写调用WebService对外提供的方法

wsimport工具帮我们生成了好几个java类，但我们只需要关心WebServiceImplService类和WebServiceImpl接口的使用即可，如下所示：

package me.gacl.ws.client;  import me.gacl.ws.WebServiceImpl; import me.gacl.ws.WebServiceImplService;  /**  * @author gacl  * 调用WebService的客户端  */ public class WSClient {      public static void main(String[] args) {         //创建一个用于产生WebServiceImpl实例的工厂，WebServiceImplService类是wsimport工具生成的         WebServiceImplService factory = new WebServiceImplService();         //通过工厂生成一个WebServiceImpl实例，WebServiceImpl是wsimport工具生成的         WebServiceImpl wsImpl = factory.getWebServiceImplPort();         //调用WebService的sayHello方法         String resResult = wsImpl.sayHello("孤傲苍狼");         System.out.println("调用WebService的sayHello方法返回的结果是："+resResult);         System.out.println("---------------------------------------------------");         //调用WebService的save方法         resResult = wsImpl.save("孤傲苍狼","123");         System.out.println("调用WebService的save方法返回的结果是："+resResult);     } }

客户端调用服务器端的WebService方法运行结果如下：

从调用返回的结果显示，借助wsimport工具生成的客户端代码已经成功调用到了WebService中的方法。以上就是使用JDK开发WebService的相关内容。