使用axis 开发web service的build.xml

build.xml
build.xml文件非常重要，它将引导您一步一步地实现web服务，从Java接口开始，实现业务逻辑，然后打包为一个标准war文件。因此，我们将整个的编译脚本拷贝如下：

<?xml version="1.0" ?>
<project default="all">
    <property file="../examples.properties" />
    <property name="build" value="build" />
    <property name="dist" value="dist" />
    <property name="lib" value="lib" />
    <property name="src" value="src" />
    <property name="gensrc" value="gensrc" />
    <property name="config" value="config" />
    <property name="webapp.name" value="AxisEndToEnd" />
    <property name="service.name" value="HelloWebService" />
    <property name="wsdl" value="HelloWebService.wsdl" />
    <property name="interface.package"
        value="com.binildas.apache.axis.AxisEndToEnd" />
    <property name="interface.path"
        value="com/binildas/apache/axis/AxisEndToEnd" />
    <property name="interface.class" value="IHelloWeb" />
    <property name="implement.package"
        value="com.binildas.apache.axis.AxisEndToEnd" />
    <property name="implement.path"
        value="com/binildas/apache/axis/AxisEndToEnd" />
    <property name="implement.class" value="HelloWebService" />
    <path id="classpath">
        <pathelement path="./build" />
        <fileset dir="${axis.home}/lib">
            <include name="*.jar" />
        </fileset>
    </path>
    <target name="all" depends=" deploy, compileclient"></target>
    <target name="clean">
        <delete dir="${build}" />
        <delete dir="${dist}" />
        <delete dir="${lib}" />
        <delete dir="${gensrc}" />
    </target>
    <target name="init">
        <mkdir dir="${build}" />
        <mkdir dir="${dist}" />
        <mkdir dir="${lib}" />
        <mkdir dir="${gensrc}" />
    </target>
    <target name="copy">
        <copy todir="${lib}">
            <fileset dir="${axis.home}/lib">
                <include name="*.jar" />
            </fileset>
        </copy>
    </target>
    <target name="precompile" depends="clean, init">
        <javac srcdir="${src}" destdir="build"
            classpathref="classpath">
            <exclude name="**/*Client*.java" />
        </javac>
    </target>
    <target name="java2wsdl" depends="precompile">
        <java classname="org.apache.axis.wsdl.Java2WSDL" fork="true"
            failonerror="true">
            <arg value="-o" />
            <arg value="${wsdl}" />
            <arg
                value="-lhttp://localhost:8080/${webapp.name}/ 
services/${service.name}" />
            <arg value="${interface.package}.${interface.class}" />
            <classpath>
                <path refid="classpath" />
                <pathelement location="${build}" />
            </classpath>
        </java>
    </target>
    <target name="wsdl2java" depends="java2wsdl">
        <java classname="org.apache.axis.wsdl.WSDL2Java" fork="true"
            failonerror="true">
            <arg value="-o" />
            <arg value="${gensrc}" />
            <arg value="-s" />
            <arg value="-S" />
            <arg value="no" />
            <arg value="-c" />
            <arg value="${implement.package}.${implement.class}" />
            <arg value="${wsdl}" />
            <classpath>
                <path refid="classpath" />
                <pathelement location="${build}" />
            </classpath>
        </java>
    </target>
    <target name="implement" depends="wsdl2java">
        <delete>
            <fileset dir="${gensrc}/${implement.path}"
                includes="${implement.class}.java" />
        </delete>
        <copy todir="${gensrc}/${implement.path}" overwrite="ture">
            <fileset dir="${src}/${implement.path}">
                <include name="${implement.class}.java" />
            </fileset>
        </copy>
    </target>
    <target name="compile" depends="implement">
        <javac srcdir="${gensrc}" destdir="build"
            classpathref="classpath" />
    </target>
    <target name="compileclient">
        <javac srcdir="${src}" destdir="build"
            classpathref="classpath">
            <include name="**/*Client*.java" />
        </javac>
    </target>
    <target name="deploy" depends="compile, copy">
        <move todir="${config}" flatten="yes">
            <fileset dir="${gensrc}">
                <include name="**/*.wsdd" />
            </fileset>
        </move>
        <java classname="org.apache.axis.utils.Admin" fork="true"
            failonerror="true" dir="config">
            <arg value="server" />
            <arg file="config/deploy.wsdd" />
            <classpath>
                <path refid="classpath" />
                <pathelement location="build" />
            </classpath>
        </java>
        <war destfile="dist/${webapp.name}.war"
            webxml="config/web.xml">
            <webinf dir="config">
                <include name="server-config.wsdd" />
            </webinf>
            <lib dir="lib" />
            <classes dir="build" />
        </war>
        <delete dir="${lib}" />
    </target>
</project>

 

下面，我们来逐步理解一下上面这个Web服务的实现过程。按照上面脚本的顺序，我们执行以下ant任务。

clean任务：这个ant任务将删除所有临时目录及上次编译生成的所有文件；

init任务：这个ant任务将创建几个新的目录；

precompile任务：这个步骤将编译Java接口类；

java2wsdl任务：java2wsdl将从预先编译过的Java接口中生成WSDL，您可以浏览Apache的http://ws.apache.org/axis/java/reference.html页面，了解上面脚本中java2wsdl任务中的一些选项的意义；

wsdl2java任务：我们现在开始实施契约最先式方法。一旦有了WSDL，我们就可以通过wsdl2java这个工具生成Web服务代码，包括Web服务的实现模板类，这些生成的文件都位于同一个目录中(如本例中的gensrc目录)。同时，本任务执行后也将产生一个用于部署Web服务的deploy.wsdd文件，和一个用于取消部署的undeploy.wsdd文件。在后面我们将通过这两个wsdd文件生成服务器端的配置；

implement任务：前面已经讲过，为了避免向生成的Web服务实现模板中手动添加代码，我们可以利用前面已经写好的一个与实现模板类同名的Java文件，这个文件中包含的类名与模板类也相同(即HelloWebService)，并且它实现了业务逻辑。因此，我们可以将前面准备好的实现类替换生成的模板类，这样做的效果就相当于向生成的模板类中添加了业务代码；

compile任务：我们将通过该任务编译所有生成的类，其中包含业务逻辑的Web服务实现类；

copy任务：该任务将所有需要的Axis库文件拷贝到一个临时目录(如本例中的lib)中，以便于打包只用；

deploy任务：在本任务中，我们使用org.apache.axis.utils.Admin类产生部署描述文件server.config.wsdd，这个类的输入为前面wsdl2java任务生成的deploy.wsdd。然后，我们接下来创建一个标准的Web归档文件(.war)，这样，我们可以非常容易地将它部署到我们钟爱的Web服务器中；