axis wsdl2java_信步漫谈之Axis2—wsdl2java工具使用

一、概述

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

二、生成客户端代码

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

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

packageclient;importclient.MySoapServiceStub.SayHello;importclient.MySoapServiceStub.SayHelloResponse;public classStubClient {public static void main(String[] args) throwsException {

MySoapServiceStub stub= newMySoapServiceStub();

SayHello sayHello= newSayHello();

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 : A url or path to a WSDL

其中常用的options具体如下：

-o

指定生成代码的输出路径

-a

生成异步模式的代码

-s

生成同步模式的代码

-p

指定代码的package名称

-l

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

-t

为代码生成测试用例

-ss

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

-sd

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

-d

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

-g

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

-pn

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

-sn

选择WSDL中的一个service

-u

展开data-binding的类

-r

为代码生成指定一个repository

-ssi

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

-S

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

-R

为生成的resources指定存储路径

--noBuildXML

输出中不生成build.xml文件

--noWSDL

在resources目录中不生成WSDL文件

--noMessageReceiver

不生成MessageReceiver类