Ant 简明教程

Ant - Packaging Applications

我们已零散地了解了 Hello World Fax Web 应用程序中使用 Ant 的不同方面。

We have learnt the different aspects of Ant using the Hello World Fax web application in bits and pieces.

现在，是时候将所有内容放在一起，以创建一个完整而全面的 build.xml 文件了。考虑 build.properties 和 build.xml 文件如下：

Now, it is time to put everything together to create a full and complete build.xml file.Consider build.properties and build.xml files as follows −

build.properties

build.properties 文件中的内容如下。

The file is given below for build.properties.

deploy.path=c:\tomcat6\webapps

build.xml

build.xml 文件如下：

The build.xml file is as follows −

<?xml version="1.0"?>

<project name="fax" basedir="." default="usage">
   <property file="build.properties"/>
   <property name="src.dir" value="src"/>
   <property name="web.dir" value="war"/>
   <property name="javadoc.dir" value="doc"/>
   <property name="build.dir" value="${web.dir}/WEB-INF/classes"/>
   <property name="name" value="fax"/>

   <path id="master-classpath">
      <fileset dir="${web.dir}/WEB-INF/lib">
         <include name="*.jar"/>
      </fileset>
      <pathelement path="${build.dir}"/>
   </path>

   <target name="javadoc">
      <javadoc packagenames="faxapp.*" sourcepath="${src.dir}"
         destdir="doc" version="true" windowtitle="Fax Application">
      <doctitle><![CDATA[<h1>= Fax Application =</h1>]]></doctitle>
      <bottom><![CDATA[Copyright © 2011. All Rights Reserved.]]></bottom>
      <group title="util packages" packages="faxapp.util.*"/>
      <group title="web packages" packages="faxapp.web.*"/>
      <group title="data packages" packages="faxapp.entity.*:faxapp.dao.*"/>
      </javadoc>
   </target>

   <target name="usage">
      <echo message=""/>
      <echo message="${name} build file"/>
      <echo message="-----------------------------------"/>
      <echo message=""/>
      <echo message="Available targets are:"/>
      <echo message=""/>
      <echo message="deploy --> Deploy application as directory"/>
      <echo message="deploywar --> Deploy application as a WAR file"/>
      <echo message=""/>
   </target>

   <target name="build" description="Compile main source tree java files">
      <mkdir dir="${build.dir}"/>
      <javac destdir="${build.dir}" source="1.5"
         target="1.5" debug="true"
         deprecation="false" optimize="false" failonerror="true">
         <src path="${src.dir}"/>
         <classpath refid="master-classpath"/>
      </javac>
   </target>
   <target name="deploy" depends="build" description="Deploy application">

   <copy todir="${deploy.path}/${name}" preservelastmodified="true">
      <fileset dir="${web.dir}">
         <include name="**/*.*"/>
      </fileset>
   </copy>
   </target>

   <target name="deploywar" depends="build" description="Deploy application as a WAR file">
      <war destfile="${name}.war" webxml="${web.dir}/WEB-INF/web.xml">
         <fileset dir="${web.dir}">
            <include name="**/*.*"/>
         </fileset>
      </war>
      <copy todir="${deploy.path}" preservelastmodified="true">
         <fileset dir=".">
            <include name="*.war"/>
         </fileset>
      </copy>
   </target>

   <target name="clean" description="Clean output directories">
      <delete>
         <fileset dir="${build.dir}">
            <include name="**/*.class"/>
         </fileset>
      </delete>
   </target>
</project>

在上述示例中，

In the above mentioned example −

  1. We first declare the path to the webapps folder in Tomcat in the build properties file as the deploy.path variable.

  2. We also declare the source folder for the java files in the src.dir variable.

  3. Then, we declare the source folder for the web files in the web.dir variable. javadoc.dir is the folder for storing the java documentation, and build.dir is the path for storing the build output files.

  4. After that, we declare the name of the web application, which is fax in our case.

  5. We also define the master class path, which contains the JAR files present in the WEB-INF/lib folder of the project.

  6. We also include the class files present in the build.dir in the master class path.

  7. The Javadoc target produces the javadoc required for the project and the usage target is used to print the common targets that are present in the build file.

上述示例展示了两个部署目标： deploy 和 deploywar 。

The above example shows two deployment targets: deploy and deploywar.

部署目标从 Web 目录将文件复制到部署目录，同时保留上次修改的时间戳。这对于部署到支持热部署的服务器时非常有用。

The deploy target copies the files from the web directory to the deploy directory preserving the last modified date time stamp. This is useful, when deploying to a server that supports hot deployment.

clean 目标清除先前构建的所有文件。

The clean target clears all the previously built files.

deploywar 目标构建 war 文件，然后将 war 文件复制到应用程序服务器的部署目录。

The deploywar target builds the war file and then, copies the war file to the deploy directory of the application server.