WebService学习之旅（一）使用JAX-WS发布WebService

﹏ヽ暗。殇╰゛Y 2022-07-27 13:45 138阅读 0赞

JAX-WS全称Java™ API for XML Web Services，是随着JDK1.6及其后续版本发布的方便Java程序员开发WebService应用的一组API，通常简称为JWS，目前版本为2.x。  
使用JAX-WS编写WebService非常简单，下面介绍WebService服务端及客户端实现。

一、开发WebService服务端

1.Web服务的接口称为SEI，我们首先要用定义一个接口HelloWorld，使用@WebService注解修饰接口名，使用@WebParam修饰需要对外发布的方法，代码如下：

package com.csdn.jaxws.recipe01;
    
    import javax.jws.WebMethod;
    import javax.jws.WebService;
    
    @WebService
    public interface HelloWorld { 
        @WebMethod
        String sayHello(String text);
    }

2.WEB服务接口的实现类称为SIB，接下来我们需要实现HelloWorld接口：

package com.csdn.jaxws.recipe01;
    
    import javax.jws.WebService;
    
    @WebService(endpointInterface = "com.csdn.jaxws.recipe01.HelloWorld") 
    public class HelloWorldImpl implements HelloWorld { 
    
        @Override
        public String sayHello(String name) {
            return "hello," + name;
        }
    
    }

3.服务接口和实现类已经编写完成，接着需要编写发布类HelloWorldService：

package com.csdn.jaxws.recipe01;
    
    import javax.xml.ws.Endpoint;
    
    public class HelloWorldService { 
        public static void main(String[] args) {
            HelloWorld hw = new HelloWorldImpl();
            Endpoint.publish("http://localhost:9089/service/HelloWorld", hw);
        }
    }

4.编译运行HelloWorldService 类，如果控制台没有错误信息，说明我们的WebService已经发布成功。  
5.每个WebService都会有一个与之对应的WSDL文档，我们可以在WebService的URL后追加?WSDL查看，打开浏览器输入`http://localhost:9089/service/HelloWorld?wsdl`,可以查看wsdl文档。  
![这里写图片描述][20160322205359701]

二、WebService客户端编写

WebService的客户端调用通常有两种，第一种使用RPC方式，第二种是使用JDK自带的wsimport工具生成客户端代码，使用这种方式较为简单，就像是在本地直接调用服务端代码一样。  
下面介绍如何使用wsimport生成客户端代码，并实现webservice调用。

1.新建一个eclipse工程，使用控制台进入工程的src目录，输入：

wsimport -keep http://localhost:9089/service/HelloWorld?wsdl

工具执行完毕后生成客户端代码如下：  
![这里写图片描述][20160322210702094]  
2.编写客户端调用代码Recipe01Client：

package com.csdn.jaxws.recipe01.client;
    
    import com.csdn.jaxws.recipe01.HelloWorldImpl;
    import com.csdn.jaxws.recipe01.HelloWorldImplService;
    
    public class Recipe01Client {
        public static void main(String[] args) {
            //创建HelloWorldImplService对象
            HelloWorldImplService hws = new HelloWorldImplService();
            //通过getHelloWorldImplPort方法获取HelloWorldImpl实例
            HelloWorldImpl hw = hws.getHelloWorldImplPort();
            //使用HelloWorldImpl实例，像直接调用服务端方法一样，调用Web服务，获取WebService响应数据
            String retVal = hw.sayHello("Jone");
            System.out.println(retVal);
    
        }
    }

你可以已经猜到，运行程序控制台输出:`hello,Jone`

[20160322205359701]: /images/20220727/056a706ee4c04a7e98cfd6ecfdd449c8.png
[20160322210702094]: /images/20220727/c76aa93cb7394e60b3cafac10423b265.png