首页 > 技术文章 > 信步漫谈之Axis2—wsdl2java工具使用

alfredinchange 2016-04-16 21:00 原文

一、概述

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类

推荐阅读