Java 类库中 Jakarta XML Web Services API 的使用指南
Java 类库中 Jakarta XML Web Services API 的使用指南
Jakarta XML Web Services（JAX-WS）是一组用于开发基于 SOAP 标准的 Web Services 的 Java 类库。本文将介绍如何使用 Jakarta XML Web Services API 构建和调用 Web Services。
首先，确保已经安装了 JDK 和任何必要的构建工具（如 Apache Maven），以便能够使用 JAX-WS。
1. 创建 Web Service
首先，创建一个包含 Web Service 的 Java 类。使用 `@WebService` 注解将其标记为 Web Service，并使用 `@WebMethod` 注解标记要公开的方法：
import javax.jws.WebService;
import javax.jws.WebMethod;
@WebService
public class MyWebService {
@WebMethod
public String sayHello(String name) {
return "Hello, " + name + "!";
}
}
2. 发布 Web Service
在发布 Web Service 之前，需要配置一个 Web Services 容器。可以选择使用内置的容器，也可以使用外部容器（如 Apache Tomcat）。在这里，我们使用内置的容器进行演示。在 `main` 方法中，使用 `Endpoint.publish` 方法发布 Web Service：
import javax.xml.ws.Endpoint;
public class MyWebServicePublisher {
public static void main(String[] args) {
String url = "http://localhost:8080/myWebService";
Endpoint.publish(url, new MyWebService());
System.out.println("Web Service 已经发布：" + url);
}
}
3. 构建客户端
现在，我们需要构建一个客户端以调用 Web Service。可以使用 `wsimport` 工具从 WSDL（Web Services Description Language）文件生成客户端代码。假设 WSDL 文件位于 `http://localhost:8080/myWebService?wsdl`，执行以下命令：
wsimport -s src -d bin http://localhost:8080/myWebService?wsdl
该命令将生成客户端代码并将其放置在 `src` 目录中。
4. 使用客户端调用 Web Service
使用生成的客户端代码，我们可以轻松地调用 Web Service。以下是一个示例：
import com.example.MyWebService;
import com.example.MyWebServiceService;
public class MyWebServiceClient {
public static void main(String[] args) {
MyWebServiceService service = new MyWebServiceService();
MyWebService port = service.getMyWebServicePort();
String response = port.sayHello("World");
System.out.println(response);
}
}
以上代码将使用客户端调用 Web Service 的 `sayHello` 方法，并将结果打印到控制台。
以上就是使用 Jakarta XML Web Services API 构建和调用 Web Services 的简要指南。我们可以根据实际需求进一步扩展和定制 Web Service 的功能。希望本文能帮助您入门 JAX-WS。
请注意，为了使代码更加简洁，省略了异常处理和其他细节。在实际开发中，应该适当处理异常，并根据需要进行更多的配置和参数设置。
Read in English