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"
failοnerrοr="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"
failοnerrοr="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"
failοnerrοr="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服务器中;