我們通過 Hello World Fax Web 應用，已經瑣碎地學習了 Ant 的不同方面的知識了。

現(xiàn)在是時候把我們所學的知識都運用起來創(chuàng)建一個全面和完整的 build.xml 文件了。考慮下面給出的 build.properties 和 build.xml 文件：

build.properties

eploy.path = c:\tomcat6\webapps

build.xml

<?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>

在上面給出的例子中：

• 我們首先在 build.properties 文件中聲明了存放 Tomcat 的 webapp 文件夾的路徑，并用變量 deploy.path 來保存。
• 我們聲明一個源文件夾來存放 java 文件，并用變量 src.dir 來保存。
• 接下來，我們聲明另一個源文夾來存放 web 文件，并用變量 web.dir 來保存。變量 javadoc.dir 用來存儲 java 文檔，變量 build.dir 是用來存儲配置輸出文件的路徑。
• 然后，我們給這個 web 應用命名，也就是 fax 傳真。
• 我們還定義了包含 JAR 文件的基本類路徑，在上面給出的項目中也就是： WEB-INF/lib 文件夾。
• 我們還將 build.dir 中的類文件存放在基本類路徑下。
• 這個 Javadoc 目標產生項目所需的文檔，以及說明目標使用的 javadoc 文檔。

上述的例子向我們展示了兩個部署目標： deploy 和 deploywar 。

這個 deploy 目標將文件從 web 目錄復制到部署目錄，并保存最后修改日期時間戳。這樣很有用，特別是當我們將項目部署到服務器上,并且該服務器支持熱部署。（釋義：所謂熱部署，就是在應用正在運行的時候升級軟件，卻不需要重新啟動應用。）

這個 clean 目標清楚所有之前的構建文件。

這個 deploywar 目標構建 war 文件,然后將 war 文件復制到應用程序服務器的部署目錄。