Web Service#

浅聊 Web Service#

刚来公司的时候有些项目请求并不是用 Postman 发送 Http 请求，而是用 SoapUI 的工具发送 XML 请求，当时面对那个老旧版本的工具和我个人非常嫌弃的 XML 我直接从头到脚就是抵触，后来我才知道这个东西叫 Web Service。现在用 Web Service 的还多吗，当然是不多，Apache 官网维护的 Web Service 最后一次更新还是在2015年10月，传输 XMl 速度也慢，只能说现在肯定是基于 Http 的 Json 的天下。

那 Web Service 到底是干什么的呢？它是一种跨编程语言和操作系统平台的远程调用技术，能使得运行在不同机器上的不同应用无须借助附加的、专门的第三方软件或硬件就可相互交换数据或集成。仔细想想只要能暴露接口，用 Json 不是更香，而且实现 Web Service 还得适配 SOAP 协议，实用性就更低了。

Web Service 三要素#

从表面看，Web Service 就是一个应用程序向外界暴露出一个能通过Web进行调用的API，也就是说能用编程的方法通过 Web 来调用这个应用程序。我们把调用的应用程序叫做客户端，而把提供的应用程序叫做服务端。Web Service 不是一种技术，更像是建立在可互操作的分布式应用程序的新平台，是一个平台，是一套标准，是一种规范。它定义了应用程序如何在 Web 上实现互操作性，而实现这项技术离不开下面介绍的 UDDI，WSDL，SOAP 这三个元素：

Web Service 规范#

目前有三种规范：JAX-WS（Java API for XML-Based Web Service）、JAXM（Java API for XML Message）、JAX-RS（RESTful 风格）。

JAX-WS 是用于构建 SOAP 风格的 Web 服务，而 JAX-RS 是用于构建 RESTful 风格的 Web 服务。在这里还是选择前者进行展开，毕竟使用 RESTful 风格的项目较少，因为如果使用 RESTful 风格就都加入 Json 的怀抱了。

在服务端，用户只需要通过 Java 语言定义远程调用所需要实现的接口（SEI：Service EndPoit Interface），并对其提供相关的实现，通过调用 JAX-WS 的服务来发布接口就可以发布为Web Service 接口。

在客户端，用户可以通过 JAX-WS 的 API 来创建一个代理来（用本地代理对象来替代远程的服务对象）实现远程服务端的调用。（在使用 JAX-WS 生成远程服务端的代理可以使用 JDK 自带的 wsimport命令来自动生成）。

快速开始#

所有的测试代码都在博客首页中的 java-study-demo 中找到。 注：使用 JDK 17 时发现注解已经被弃用，下面代码建议使用 JDK 8。

1
/**
2
 * @ClassName MyCalculator
3
 * @Description 简单的加法计算器
4
 */
5
@WebService
6
public class MyCalculator {
7

8
    @WebMethod
9
    public int add(int a, int b) {
10
        return a + b;
11
    }
12
}

1
/**
2
 * @ClassName WebServiceSeverMain
3
 * @Description Web Service 服务主函数
4
 */
5
public class WebServiceSeverMain {
6

7
    public static void main(String[] args) {
8

9
        // 定义Web服务的地址
10
        String url = "http://localhost:8080/calculator";
11

12
        // 创建Calculator对象
13
        MyCalculator calculator = new MyCalculator();
14

15
        // 发布Web服务
16
        Endpoint.publish(url, calculator);
17

18
        System.out.println("Web服务已发布，访问地址: " + url + "?wsdl");
19
    }
20
}

1
wsimport -s /todir bin http://localhost:8080/calculator?wsdl

1
/**
2
 * @ClassName WebServiceCLientMain
3
 * @Description Web Service 客户端主函数
4
 */
5
public class WebServiceCLientMain {
6

7
    public static void main(String[] args) {
8
        MyCalculatorService service = new MyCalculatorService();
9
        MyCalculator port = service.getMyCalculatorPort();
10

11
        int num1 = 10;
12
        int num2 = 20;
13
        int result = port.add(num1, num2);
14

15
        System.out.println("Result of adding " + num1 + " and " + num2 + " is: " + result);
16
    }
17
}