【详解】Axis2+wsdl2java.bat生成客户端调用

原创

大盘鸡拌面

发布于 2025-08-24 22:21:03

15700

代码可运行

运行总次数：0

代码可运行

Axis2 + wsdl2java.bat 生成客户端调用

在Web服务开发中，Axis2 是一个非常流行的实现SOAP协议的框架。它不仅支持多种协议和数据格式，还提供了强大的工具来简化Web服务的开发和部署过程。本文将介绍如何使用Axis2提供的wsdl2java.bat工具从WSDL文件生成Java客户端代码，并通过示例说明如何使用这些代码调用Web服务。

准备工作

安装Axis2

访问 Apache Axis2 官方网站，下载最新版本的Axis2。
解压下载的文件到你的工作目录，例如 C:\axis2-1.7.9。
将 axis2-1.7.9\bin 目录添加到系统的环境变量 PATH 中，以便可以在命令行中直接运行 wsdl2java.bat。

获取WSDL文件

确保你有一个可用的WSDL文件。如果服务提供者没有提供WSDL文件，你可以尝试通过服务URL获取，例如 http://example.com/services/MyService?wsdl。

使用 wsdl2java.bat 生成客户端代码

命令行参数

打开命令行工具，切换到Axis2的 bin 目录下，运行以下命令：

wsdl2java -uri http://example.com/services/MyService?wsdl -o output_directory

-uri：指定WSDL文件的URL或本地路径。
-o：指定生成代码的输出目录。

示例

假设我们有一个WSDL文件位于 http://example.com/services/WeatherService?wsdl，我们希望将生成的代码放在 D:\MyProjects\WeatherClient 目录下。可以运行以下命令：

wsdl2java -uri http://example.com/services/WeatherService?wsdl -o D:\MyProjects\WeatherClient

执行上述命令后，D:\MyProjects\WeatherClient 目录下将会生成一系列Java文件，包括服务接口、数据模型类和服务客户端类等。

编写客户端代码

生成客户端代码后，你可以编写Java程序来调用Web服务。下面是一个简单的示例，展示如何使用生成的客户端代码调用 getWeather 方法：

import org.example.weather.WeatherServiceStub;
import org.example.weather.GetWeather;
import org.example.weather.GetWeatherResponse;

public class WeatherClient {
    public static void main(String[] args) {
        try {
            // 创建服务客户端对象
            WeatherServiceStub stub = new WeatherServiceStub("http://example.com/services/WeatherService");

            // 创建请求对象
            GetWeather getWeather = new GetWeather();
            getWeather.setLocation("New York");

            // 调用服务方法
            GetWeatherResponse response = stub.getWeather(getWeather);

            // 输出结果
            System.out.println("Weather in New York: " + response.get_return());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行客户端

确保你的项目已经包含了Axis2的库文件（通常在 axis2-1.7.9\lib 目录下），然后编译并运行上述客户端代码。

通过使用Axis2提供的 wsdl2java.bat 工具，我们可以轻松地从WSDL文件生成Java客户端代码，从而简化了Web服务的调用过程。本文介绍了工具的基本使用方法以及如何编写简单的客户端代码来调用Web服务。

这篇博客文章详细介绍了如何使用Axis2的wsdl2java.bat工具生成Web服务客户端代码，并通过一个具体的例子展示了如何编写客户端代码来调用Web服务。希望这能帮助到正在学习或使用Axis2进行Web服务开发的读者。Apache Axis2 是一个用于构建和部署 Web 服务的框架，它支持多种协议，包括 SOAP、HTTP 和 JMS。使用 wsdl2java.bat 工具可以从 WSDL 文件生成 Java 客户端代码，以便于调用 Web 服务。

下面是一个具体的示例，展示如何使用 Axis2 的 wsdl2java.bat 工具生成客户端代码，并调用一个简单的 Web 服务。

步骤 1: 准备 WSDL 文件

假设你有一个 WSDL 文件 CalculatorService.wsdl，该文件描述了一个提供加法运算的 Web 服务。

<!-- CalculatorService.wsdl -->
<definitions xmlns="http://schemas.xmlsoap.org/wsdl/"
             xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
             xmlns:tns="http://example.com/calculator"
             targetNamespace="http://example.com/calculator">
    <message name="AddRequest">
        <part name="a" type="xsd:int"/>
        <part name="b" type="xsd:int"/>
    </message>
    <message name="AddResponse">
        <part name="result" type="xsd:int"/>
    </message>
    <portType name="CalculatorPortType">
        <operation name="add">
            <input message="tns:AddRequest"/>
            <output message="tns:AddResponse"/>
        </operation>
    </portType>
    <binding name="CalculatorBinding" type="tns:CalculatorPortType">
        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="add">
            <soap:operation soapAction="http://example.com/calculator/add"/>
            <input>
                <soap:body use="encoded" namespace="http://example.com/calculator" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </input>
            <output>
                <soap:body use="encoded" namespace="http://example.com/calculator" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </output>
        </operation>
    </binding>
    <service name="CalculatorService">
        <port name="CalculatorPort" binding="tns:CalculatorBinding">
            <soap:address location="http://localhost:8080/axis2/services/CalculatorService"/>
        </port>
    </service>
</definitions>

步骤 2: 使用 `wsdl2java.bat` 生成客户端代码

打开命令行，导航到包含 CalculatorService.wsdl 文件的目录，然后运行以下命令：

wsdl2java.bat -uri CalculatorService.wsdl -o generated

这将生成一个名为 generated 的目录，其中包含客户端代码。

步骤 3: 编写客户端代码

在生成的客户端代码基础上，编写一个 Java 程序来调用 Web 服务。

import org.example.calculator.CalculatorServiceStub;
import org.example.calculator.Add;
import org.example.calculator.AddResponse;

public class CalculatorClient {
    public static void main(String[] args) {
        try {
            // 创建服务存根
            CalculatorServiceStub stub = new CalculatorServiceStub("http://localhost:8080/axis2/services/CalculatorService");

            // 创建请求对象
            Add addRequest = new Add();
            addRequest.setA(5);
            addRequest.setB(3);

            // 调用服务
            AddResponse response = stub.add(addRequest);

            // 输出结果
            System.out.println("Result: " + response.get_return());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

步骤 4: 运行客户端代码

确保你的 Web 服务已经在 http://localhost:8080/axis2/services/CalculatorService 上运行。编译并运行 CalculatorClient.java：

javac -cp .;axis2-client-1.7.9.jar CalculatorClient.java
java -cp .;axis2-client-1.7.9.jar CalculatorClient

如果一切正常，你应该会看到输出：

Result: 8

通过上述步骤，你可以使用 Axis2 的 wsdl2java.bat 工具生成客户端代码，并编写一个简单的 Java 程序来调用 Web 服务。这个示例展示了如何从 WSDL 文件生成客户端代码，并使用生成的代码调用 Web 服务的方法。Apache Axis2 是一个基于 Java 的 Web 服务框架，它支持 SOAP、REST 等多种协议，并且能够方便地生成客户端代码来调用 Web 服务。wsdl2java.bat 是 Axis2 提供的一个工具，用于从 WSDL 文件生成 Java 客户端代码。下面我将详细介绍如何使用 wsdl2java.bat 生成客户端代码，并解释生成的代码结构。

1. 准备工作

首先，确保你已经安装了 Apache Axis2 并配置好了环境变量。假设你已经有一个 WSDL 文件（例如 example.wsdl），并且它位于你的项目目录中。

2. 使用 `wsdl2java.bat` 生成客户端代码

打开命令行终端，导航到 Axis2 的 bin 目录，然后运行以下命令：

wsdl2java.bat -uri path/to/your/example.wsdl -o output/directory

-uri：指定 WSDL 文件的路径。
-o：指定输出目录，生成的客户端代码将保存在这个目录中。

3. 生成的代码结构

生成的代码通常包含以下几个部分：

3.1 `src` 目录

这个目录包含了所有生成的 Java 源文件。通常包括以下子目录：

org.example：根据 WSDL 文件中的命名空间生成的包名。
service：包含服务接口和实现类。
types：包含数据类型的 Java 类。
stub：包含客户端存根类，用于调用 Web 服务。

3.2 服务接口和实现类

在 service 包中，你会找到一个接口和一个实现类。例如：

ExampleServiceSkeletonInterface.java：定义了服务的方法签名。
ExampleServiceSkeleton.java：实现了服务接口，提供了实际的业务逻辑。

3.3 数据类型

在 types 包中，你会找到 WSDL 文件中定义的所有数据类型的 Java 类。这些类通常包含 getter 和 setter 方法，用于访问和修改数据。

3.4 客户端存根类

在 stub 包中，你会找到客户端存根类，例如 ExampleServiceStub.java。这个类包含了调用 Web 服务的方法。你可以通过这个类创建客户端对象并调用服务方法。

4. 示例代码

假设你生成了一个名为 ExampleService 的服务，以下是一个简单的示例代码，展示如何使用生成的客户端代码调用 Web 服务：

import org.example.service.ExampleServiceStub;
import org.example.types.RequestType;
import org.example.types.ResponseType;

public class ExampleClient {
    public static void main(String[] args) {
        try {
            // 创建服务存根对象
            ExampleServiceStub stub = new ExampleServiceStub("http://example.com/services/ExampleService");

            // 创建请求对象
            RequestType request = new RequestType();
            request.setParameter1("value1");
            request.setParameter2("value2");

            // 调用服务方法
            ResponseType response = stub.exampleMethod(request);

            // 处理响应
            System.out.println("Response: " + response.getResult());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

5. 运行客户端代码

确保你的项目中包含了 Axis2 的依赖库。如果你使用的是 Maven，可以在 pom.xml 中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.apache.axis2</groupId>
        <artifactId>axis2</artifactId>
        <version>1.7.9</version>
    </dependency>
    <dependency>
        <groupId>org.apache.axis2</groupId>
        <artifactId>axis2-adb</artifactId>
        <version>1.7.9</version>
    </dependency>
    <dependency>
        <groupId>org.apache.axis2</groupId>
        <artifactId>axis2-transport-http</artifactId>
        <version>1.7.9</version>
    </dependency>
    <dependency>
        <groupId>org.apache.axis2</groupId>
        <artifactId>axis2-transport-local</artifactId>
        <version>1.7.9</version>
    </dependency>
</dependencies>

编译并运行你的客户端代码，你应该能够成功调用 Web 服务并处理响应。

希望这些信息对你有帮助！如果有任何问题或需要进一步的帮助，请随时告诉我。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S15#自选日志

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

腾讯技术创作特训营S15#自选日志

登录后参与评论

0 条评论

热度