axis2:用ant脚本生成webservice client 端的java/c代码

Axis2是下一代 Apache Axis。Axis2 虽然由 Axis 1.x 处理程序模型提供支持，但它具有更强的灵活性并可扩展到新的体系结构。Axis2 基于新的体系结构进行了全新编写，而且没有采用 Axis 1.x 的常用代码。支持开发 Axis2 的动力是探寻模块化更强、灵活性更高和更有效的体系结构，这种体系结构可以很容易地插入到其他相关 Web 服务标准和协议（如 WS-Security、WS-ReliableMessaging 等）的实现中。@百度百科
axis2是什么不是本文的重点，本文要说的是当我们用axis2已经搭架了一个webservice服务器可以对外部世界提供服务的时候，客户端访问webservice的代码怎么生成?
axis2提供了根据wsdl文件生成java和c代码的工具(Code Generator Tool)，利用自动生成的client代码的好处不言而喻，可以大大减少client开发的工作量。
使用Code Generator Tool可以生成java或c代码。同时为了方便在ant下调用，axis2还提供了名为AntCodegenTask的ant task，用它可以很方便的在ant脚本中生成你的webservice client代码。
以下是ant脚本中用AntCodegenTask生成java代码的示例：

	<property environment="env" />
	<!--从环境变量AXIS2_HOME中读取axis2的位置-->
	<property name="AXIS2_HOME" value="${env.AXIS2_HOME}" />
	<path id="axis2.classpath">
		<!--默认的AXIS2 jar包-->
		<fileset dir="${AXIS2_HOME}/lib">
			<include name="*.jar" />
		</fileset>
	</path>
	<!--用AntCodegenTask类定义名为codegen的task,用于client代码生成-->
	<taskdef name="codegen" classname="org.apache.axis2.tool.ant.AntCodegenTask" classpathref="axis2.classpath" />
	<!--生成客户端java代码-->
	<target name="client.java" depends="wsdl" description="生成webservice 客户端代码(java)">
		<echo>从${package-name}.wsdl生成webservice client 代码(java)</echo>
		<delete includeEmptyDirs="true" dir="${client.java.dir}" />
		<!--执行codegen生成代码-->
		<codegen wsdlfilename="${wsdl.dir}/${package-name}.wsdl" databindingName="adb" output="${client.java.dir}" language="java" packageName="${client-package}" />
	</target>

其实如果你看过axis2的源码，AntCodegenTask最终是调用org.apache.axis2.wsdl.codegen.CodeGenerationEngine(代码生成引擎)来实现代码生成，为了支持直接从命令行生成client代码，axis2还提供了一个org.apache.axis2.wsdl.WSDL2Code实现与AntCodegenTask同样的功能，不同的只是它不依赖ant，有main方法可以独立执行。为了简化调用基于WSDL2Code,又提供了WSDL2C和WSDL2Java两个类，因为代码非常简单，这里贴出代码

WSDL2Java.java

package org.apache.axis2.wsdl;

public class WSDL2Java {
    public static void main(String[] args) throws Exception {
        WSDL2Code.main(args);
    }
}

WSDL2C.java

package org.apache.axis2.wsdl;

public class WSDL2C {
    public static void main(String[] args) throws Exception {
        String[] cargs = new String[args.length + 2];
        System.arraycopy(args, 0, cargs, 0, args.length);
        System.setProperty("org.apache.adb.properties",
                           "/org/apache/axis2/schema/c-schema-compile.properties");
        cargs[args.length] = "-l";
        cargs[args.length + 1] = "c";

        WSDL2Code.main(cargs);
    }
}

so,如果不使用现成的AntCodegenTask,也可以直接执行WSDL2Code或WSDL2C或WSDL2Java生成你需要的代码,你可以利用WSDL2Code在shell脚本中完成client代码生成。
以下是用WSDL2C生成webservice client c代码的ant脚本示例:

	<path id="service.classpath">
		<path refid="axis2.classpath" />
		<path refid="lib.classpath" />
		<path refid="project.classpath" />
	</path>
	<!--生成客户端c代码-->
	<target name="client.c" depends="wsdl" description="生成webservice 客户端代码(c)">
		<echo>${package-name}.wsdl生成webservice client 代码(c)</echo>
		<delete includeEmptyDirs="true" dir="${client.c.dir}" />
		<java classname="org.apache.axis2.wsdl.WSDL2C" fork="true">
			<classpath refid="service.classpath" />
			<arg value="-uri" />
			<arg value="${wsdl.dir}/${package-name}.wsdl" />
			<arg value="-o" />
			<arg value="${client.c.dir}" />
			<arg value="-d" />
			<arg value="adb" />
			<arg value="-u"/>
		</java>
	</target>

不论是用现成的AntCodegenTask,还是用WSDL2Code或WSDL2C或WSDL2Java，关于参数的说明都请参见[CodegenToolReference][1]
[1]:http://axis.apache.org/axis2/java/core/tools/CodegenToolReference.html