一、概述

Axis2 提供了一个 wsdl2java 命令可以根据 WSDL 文件自动产生调用 WebService 的代码。wsdl2java 命令可以在 <Axis2安装目录> 下的 bin 目录中找到。在使用 wsdl2java 命令之前需要设置 AXIS2_HOME 环境变量，该变量值是 <Axis2安装目录>。以下以 Windows 平台上使用为例。

二、生成客户端代码

进入 Windows 控制台，执行如下命令来生成 WebService 的客户端代码：

%AXIS2_HOME%\bin\wsdl2java -uri http://127.0.0.1:8080/awyb/services/mySoapService?wsdl -p client -s -o stub

其中 -uri 参数指定了 wsdl 文件的路径，可以是本地路径，也可以是网络路径。-p 参数指定了生成的 Java 类的包名，-o 参数指定了生成的一系列文件保存的根目录。在执行完上面的命令后，我们就会发现在当前目录下多了个stub目录，在 ./stub/src/client 目录可以找到对应的客户端调用文件，这些文件复杂调用 WebService，我们可以在程序中直接使用这些文件。例如：


package client;

import client.MySoapServiceStub.SayHello;
import client.MySoapServiceStub.SayHelloResponse;


public class StubClient {
    public static void main(String[] args) throws Exception {
        MySoapServiceStub stub = new MySoapServiceStub();
        SayHello sayHello = new SayHello();
        SayHelloResponse resp = stub.sayHello(sayHello);
        String ret = resp.get_return();
        System.out.println(ret);
    }
}

以上程序自动生成的客户端调用文件 MySoapServiceStub.java，我们通过调用该文件实现客户端访问，大大简化了调用 WebService 的步骤，并使代码更加简洁。但要注意的是，wsdl2java 命令生成的 Stub 类将 WebService 方法的参数都封装在了相应的类中，类名为方法名，例如，sayHello 方法的参数都封装在了 SayHello 类中，要想调用 sayHello 方法，必须先创建 SayHello 类的对象实例。

三、wsdl2java 参数详解

命令行格式为：wsdl2java [options] -uri <url or path> : A url or path to a WSDL

其中常用的options具体如下：

-o <path>

指定生成代码的输出路径

-a

生成异步模式的代码

-s

生成同步模式的代码

-p <pkg>

指定代码的package名称

-l <languange>

使用的语言(Java/C) 默认是java

-t

为代码生成测试用例

-ss

生成服务端代码默认不生成

-sd

生成服务描述文件 services.xml,仅与-ss一同使用

-d <databinding>

指定databingding，例如，adb,xmlbean,jibx,jaxme and jaxbri

-g

生成服务端和客户端的代码

-pn <port_name>

当WSDL中有多个port时，指定其中一个port

-sn <serv_name>

选择WSDL中的一个service

-u

展开data-binding的类

-r <path>

为代码生成指定一个repository

-ssi

为服务端实现代码生成接口类

-S

为生成的源码指定存储路径

-R

为生成的resources指定存储路径

--noBuildXML

输出中不生成build.xml文件

--noWSDL

在resources目录中不生成WSDL文件

--noMessageReceiver

不生成MessageReceiver类