java - 在 Java Web 服务中生成的客户端工件

Question

我曾参与过不少使用 JAX-WS 实现(例如 Axis)的 Web 服务项目。工件是使用 IDE 生成的，并且它可以工作。但是，我想知道生成的客户端工件以及它们的作用。如果您能提供任何明确的指南或来源，将会很有帮助。

我知道如何生成工件。但找不到任何描述生成的客户端工件及其用途的来源。

Answer 1

正如您所知，JAX-WS 旨在为 XML Web 服务提供 Java API 规范。作为面向对象的 Java 开发人员，我们不想在代码中处理原始 XML。相反，我们喜欢 XML 文件的面向对象表示，以便我们只处理类和对象。

服务提供商将创建一个 Web 服务并使用 XML 定义 (WSDL) 公开其数据传输协定。现在客户端希望通过创建 XML 输入文件(SOAP 消息)来使用此 Web 服务并与服务器进行通信。

因此，您收到了 WSDL 文件，它本质上告诉您如何访问服务(服务端点)、公开的操作是什么、每个服务的输入模式是什么、输出模式是什么、错误模式等等。

与 Web 服务通信的一种方法是手动查看架构并创建 XML (SOAP) 消息并尝试连接到服务。这是极其困难的、容易出错、不可读和不可维护的。这就是为什么我们有一个规范来将庞大、复杂的 XML 模式转换为对开发人员更友好的面向对象的类，这些类表示与 WSDL 中定义的完全相同的 XML 元素。它还生成工厂类来创建任何 POJO 类的实例。

获取一个简单的 WSDL 文件并使用 wsimport 生成客户端类。您可以看到，它生成了输入和输出 XML 的面向对象表示、为服务和操作创建的接口(interface)、表示整个服务的 Web 服务客户端、帮助您创建任何数据传输类的实例的对象工厂。 JAX-WS 将使用所有这些接口(interface)和类来生成最终的 SOAP 消息来调用 Web 服务。

您需要做的就是，创建输入对象并调用 Web 服务操作，JAX-WS 实现将负责将对象转换为 SOAP 并进行服务调用，然后转换响应的所有繁重工作SOAP 消息返回到面向对象的表示形式并返回到您的应用程序。

例如:取 Calculator Service其中有加法和减法运算。每个操作都需要特定类型的 SOAP 消息。 wsimoport 将生成，

具有端点定义的高级 WebService 类(ICalculator)

@WebServiceClient(name = "CalculatorService",...)
public class CalculatorService
extends Service
{

 ….
 @WebEndpoint(name = "ICalculator")
    public ICalculator getICalculator(WebServiceFeature... features) {
     .....
    }
…
}

用于定义每个操作的 ICalculator 接口(interface)，

@WebService(name = "ICalculator", targetNamespace = "http://Example.org")
public interface ICalculator {
   ….
    @WebMethod(operationName = "Add", action = "http://Example.org/ICalculator/Add")
    @WebResult(name = "result", targetNamespace = "http://Example.org")
    @RequestWrapper(localName = "Add", targetNamespace = "http://Example.org", className = "org.example.Add")
    @ResponseWrapper(localName = "AddResponse", targetNamespace = "http://Example.org", className = "org.example.AddResponse")
    public Integer add(
        @WebParam(name = "a", targetNamespace = "http://Example.org")
        Integer a,
        @WebParam(name = "b", targetNamespace = "http://Example.org")
        Integer b);

   ….
}

数据传输对象来表示所有请求和响应格式，

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name = "Add")
public class Add {

    protected Integer a;
    protected Integer b;
    …. All getter and setter

}

还有其他一些工厂类。您可以看到所有这些注释都是由 JAX-WS 规范定义的，并由 JAX-WS 实现用来生成 SOAP 消息并促进通信。您不再需要在应用程序代码中处理 XML。您只需进行面向对象编程。

Reference 1 | Reference 2

JAX-RPC 有点旧，您可以从 wikipedia 读取历史记录

玩得开心