Ant 是一个 Apache 基金会下的跨平台的基于 Java 语言开发的构建工具。在我们详细了解 Apache Ant 之前， 让我们来讲解为什么构建工具是需要最先了解的。
一般情况，开发人员花费大量的时间做一般性的任务，比如：构建和部署，通常包含下面的工作：
为了自动和简化上面的工作，Apache Ant 是非常有用的。这是一个基于开放的操作系统构建和部署的工具，该工具需要从命令行执行。
Apache Ant 是 Apache 软件许可证下发布的。Apache 是一个由一个开源机构认证的完全成熟的开源许可证。Apache Ant 最新的版本包括了以下的部分：完整的源代码， 类文件和文档，这些内容都可以在 http://ant.apache.org上面找到。
安装 Apache Ant 的前提是你的电脑上已经下载并且安装了 Java 开发工具包（JDK）。如果电脑上没有安装的话，请按照下列的提示进行下载和安装。
为了验证你的电脑上是否已经成功安装了 Apache Ant ，你可以在命令提示符中输入 ant。你应该会看到一个与下列相似的输出：
> C:>ant -versionApache Ant(TM) version 1.8.2 compiled on December 20 2010如果你没有看到与上述相类似的输出，请重新检查一下你是否已经正确按照之前的步骤进行了安装。
这个教程也包括了 Ant 和 Eclipse 集成开发环境的整合。因此，如果你还没有安装好 Eclipse， 请下载并安装 Eclipse。
安装 Eclipse 请按照下述步骤：
一般来说，Ant 的构建文件默认为 build.xml，放在项目顶层目录中。然而，并没有限制构建文件必须命名为 bulid.xml，也并不限制放在项目顶层目录中。你可以将构建文件命名为其他名字，也可以将它放在项目的其他地方。
这个教程将以简单的方式向你展示如何利用 Apache Ant 来自动地构建和部署项目的过程。在完成本教程的学习以后，你将会发现你已经具备下一阶段学习 Apache Ant 中等水平的专业知识 。
例如：
<project name="Cesium" default="combine">
属性：
name : 项目名称
default:指定运行的target名称，没有指定时使用缺省的target；
basedir：基准路径，其他的相对路径都是基于这个基准路径的；
description:项目描述信息。
<target name="combine" depends="build,combineJavaScript" description="Combines all source files into a single stand-alone script." />
注意：一个target可以依赖于其他target。例如combine依赖于 build target 和 combineJaveScript target，ant 会按照 depends 中 target 出现的顺序依次执行，并且每个 target 只会被执行一次，即使有多个target依赖于他。
target有以下属性：
name：target名称，这个属性是必须的；
depends：依赖目标，非必须
if：当属性设置时才执行该target，非必须；
unless：当属性没有设置时才执行该target，非必须；
description：target的描述信息，非必须；
Task分为内置task和自定义task，每个task都是一段可执行的代码。
<copy file="${requirejsPath}/require.min.js" tofile="${cesiumViewerOutputDirectory}/require.js" /><glslToJavascript minify="${build.minification}" minifystatefile="${buildDirectory}/minifyShaders.state"> <glslfiles dir="${shadersDirectory}" includes="**/*.glsl" /> <existingjsfiles dir="${shadersDirectory}" includes="**/*.js" excludes="*.profile.js" /></glslToJavascript><scriptdef name="glslToJavascript" language="javascript" src="${tasksDirectory}/glslToJavaScript.js" manager="bsf" classpathref="javascriptClassPath" loaderref="javascript.loader"> <attribute name="minify" /> <attribute name="minifystatefile" /> <element name="glslfiles" type="fileset" /> <element name="existingjsfiles" type="fileset" /></scriptdef>创建一个文件命名为 build.xml 的文件，存储在你电脑的任意地方 ，并包含以下的内容：
<?xml version="1.0"?> <project name="Hello World Project" default="info"> <target name="info"> <echo>Hello World - Welcome to Apache Ant!</echo> </target></project>属性是键值对，其中每个值都与键相关联。属性用于设置可在构建文件中的任何位置访问的值。 设置属性后，无法更改。
Apache Ant提供了<property>标记，可用于设置属性。
Apache Ant属性类型有两种:
Apache Ant提供了各种内置属性，我们可以在构建文件中访问所有这些属性。 下面的表中给出了一些内置属性。
| 属性 | 描述 |
|---|---|
| basedir | 用于项目基础的绝对路径 |
| ant.file | 用于构建文件的绝对路径 |
| ant.version | 用于Ant的版本 |
| ant.project.name | 它包含当前正在执行的项目的名称 |
| ant.project.default-target | 它包含当前正在执行的项目的默认目标的名称 |
| ant.project.invoked-targets | 调用当前项目时的目标列表 |
| ant.java.version | 拥有的JVM版本 |
| ant.core.lib | ant.jar 文件的绝对路径 |
| ant.home | 包含Ant的主目录 |
| ant.library.dir | 包含用于加载Ant的jar的目录。 |
除了内置属性，Apache Ant还提供了在buildfile中创建自定义属性的工具。
要创建属性，请提供<property>标记，该标记使用name和value属性。 name属性是属性的名称，value属性包含的值。
为了进一步了解，让我们来看下面一个例子。
Apache Ant属性示例
<project name="apache-ant project" default="run"> <property name="student-name" value = "Maxsu"></property> <target name="run"> <echo>${student-name} is our student.</echo> </target> <target name="compile"> <javac includeantruntime="false" srcdir="./src" destdir = "test"></javac> </target> </project>当你只需要对小部分属性进行设置时，可以选择直接在构建文件中设置。然而，对于大项目，最好将设置属性的信息存储在一个独立的文件中。
存储属性信息在一个独立的文件中将会提供以下好处：
这里没有硬性规定，但是一般情况下，属性文件都被命名为 build.properties， 并且与 build.xml 存放在同一目录层。 你可以基于部署环境 ——比如： build.properties.dev 和 build.properties.test 创建多个 build.properties 文件。
在下面的例子中展示了 build.xml 文件和与之相联系的 build.properties文件：
<?xml version="1.0"?><project name="Hello World Project" default="info"> <property file="build.properties"/> <target name="info"> <echo>Apache Ant version is ${ant.version} - You are at ${sitename} </echo> </target></project># The Site Namesitename=wiki.51coolma.cnbuildversion=3.3.2注意到上面的练习中，sitename 是一个自定义属性，执行后映射到一个地址为 “wiki.51coolma.cn” 的网站上。你可以用这种方式声明任意数量的属性。在上面的例子中，还有一个自定义属性 buildversioin，它表明了当前构建的版本号。
除了以上提到的两个属性， Ant 还提供了其他内置属性，在前一章节中已经提到，但是下面我们再一次给出相关属性。
| 属性 | 描述 |
| ant.file | 表示 buildfile 的绝对路径。 |
| ant.version | 表示 Ant 的版本。 |
| basedir | 表示 project 基目录的绝对路径。 |
| ant.java.version | 表示 Ant 检测到的 JDK 的版本。 |
| ant.project.name | 表示当前指定的 project 的名字。 |
| ant.project.default-target | 表示当前项目的默认目标。 |
| ant.project.invoked-targets | 表示被当前项目调用的一系列用逗号分隔开的目标。 |
| ant.core.lib | 表示 Ant jar 文件的绝对路径。 |
| ant.home | 表示 Ant 安装的根目录。 |
| ant.library.dir | 表示 Ant 函数库，一般情况下为 ANT_HOME/lib 文件的根目录。 |
在这一章节的例子中，我们用到的 Ant 内置属性是 ant.version 属性。
Ant 提供一些预定义的数据类型。不要将术语“数据类型”和那些在编程语言中可用的数据类型相混淆，而是将他们视作一组已经在产品中配置好的服务。
下述的数据类型是由 Apache Ant 提供的。
文件集的数据类型代表了一个文件集合。它被当作一个过滤器，用来包括或移除匹配某种模式的文件。
例如，参考下面的代码。这里，src 属性指向项目的源文件夹。
文件集选择源文件夹中所有的 .java 文件，除了那些包含有 'Stub' 单词的文件。能区分大小写的过滤器被应用到文件集上，这意味着名为 Samplestub.java 的文件将不会被排除在文件集之外。
<fileset dir="${src}" casesensitive="yes"> <include name="/.java"/> <exclude name="/Stub"/></fileset>一个模式集合指的是一种模式，基于这种模式，能够很容易地过滤文件或者文件夹。模式可以使用下述的元字符进行创建。
下面的例子演示了模式集合的使用。
<patternset id="java.files.without.stubs"> <include name="src//.java"/> <exclude name="src//Stub"/></patternset>该模式集合能够通过一个类似于下述的文件集进行重用：
<fileset dir="${src}" casesensitive="yes"> <patternset refid="java.files.without.stubs"/></fileset>文件列表数据类型与文件集相类似，除了以下几处不同：
让我们来看一个下述的关于文件列表数据类型的例子。在这个例子中，属性 webapp.src.folder 指向该项目中的 Web 应用的源文件夹。
<filelist id="config.files" dir="${webapp.src.folder}"> <file name="applicationConfig.xml"/> <file name="faces-config.xml"/> <file name="web.xml"/> <file name="portlet.xml"/></filelist>使用一个过滤器集合数据类型与拷贝任务，你可以在所有文件中使用一个替换值来替换掉一些与模式相匹配的文本。
一个常见的例子就是对一个已经发行的说明文件追加版本号，代码如下：
<copy todir="${output.dir}"> <fileset dir="${releasenotes.dir}" includes="/.txt"/> <filterset> <filter token="VERSION" value="${current.version}"/> </filterset></copy>在这段代码中：
path 数据类型通常被用来表示一个类路径。各个路径之间用分号或者冒号隔开。然而，这些字符在运行时被替代为执行系统的路径分隔符。
类路径被设置为项目中 jar 文件和类文件的列表，如下面例子所示：
<path id="build.classpath.jar"> <pathelement path="${env.J2EE_HOME}/${j2ee.jar}"/> <fileset dir="lib"> <include name="*/.jar"/> </fileset></path>在这段代码中：
现在我们已经学习了 Ant 的数据类型，是时候在实际过程中运用所学知识了。在这一章节中，我们将会构建一个项目。这一章节的目的是创建一个 Ant build 文件，该文件能够编译 Java 源文件和将这些类文件存储在 WEB-INFclasses 文件夹下。
考虑接下来构建项目的结构：
学习完本教程的剩余部分后，就能知道这个项目是一个 Hello World 传真应用。
C:workFaxWebApplication>treeFolder PATH listingVolume serial number is 00740061 EC1C:ADB1C:.+---db+---src. +---faxapp. +---dao. +---entity. +---util. +---web+---war +---images +---js +---META-INF +---styles +---WEB-INF +---classes +---jsp +---lib下面给出上述项目的 build.xml 文件的内容。让我们来一条语句接一条语句地来分析它。
<?xml version="1.0"?><project name="fax" basedir="." default="build"> <property name="src.dir" value="src"/> <property name="web.dir" value="war"/> <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="build" description="Compile source tree java files"> <mkdir dir="${build.dir}"/> <javac destdir="${build.dir}" source="1.5" target="1.5"> <src path="${src.dir}"/> <classpath refid="master-classpath"/> </javac> </target> <target name="clean" description="Clean output directories"> <delete> <fileset dir="${build.dir}"> <include name="**/*.class"/> </fileset> </delete> </target></project>首先，让我们来声明一些源文件，web 文件和构建文件的一些属性信息。
<property name="src.dir" value="src"/><property name="web.dir" value="war"/><property name="build.dir" value="${web.dir}/WEB-INF/classes"/>在上面的例子中：
属性也可以引用其它属性。在上面的例子中，build.dir 属性引用了 web.dir 属性。
在上面的例子中，src.dir 就是项目源文件存放的地方。
我们项目的默认目标是编译目标。但是首先让我们来看一下 clean 目标。
clean 目标，就像它的名字所表明的意思一样，删除构建文件夹中的所有文件。
<target name="clean" description="Clean output directories"> <delete> <fileset dir="${build.dir}"> <include name="**/*.class"/> </fileset> </delete></target>控制类路径 (master-classpath) 保存类路径的相关信息。在这种情况下，它包含了构建文件夹和 jar 文件夹中的所有的类文件。
<path id="master-classpath"> <fileset dir="${web.dir}/WEB-INF/lib"> <include name="*.jar"/> </fileset> <pathelement path="${build.dir}"/></path>最后，构建目标构建这些文件。首先，我们创建一个构建目录，如果该目录不存在，我们就执行 javac 命令（具体以 jdk 1.5 作为我们目标的编译环境）。 我们对 javac 任务提供源文件夹和类路径，并且通过执行 javac 任务将类文件存放在构建文件夹中。
<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>在这个文件上执行 Ant，编译 java 源文件，并将编译后的类文件存放在构建文件夹的地方。
运行 Ant 文件后，能看到以下输出：
C:>antBuildfile: C:build.xmlBUILD SUCCESSFULTotal time: 6.3 seconds文件被编译后，将存储在 build.dir 文件夹中。
文档在任何项目中都是必须的。文档对一个项目的维护起了至关重要的作用。 通过使用内置的 Javadoc 工具，使用 Java 生成文档变得更加容易。Ant 通过按需生成文档使得这个步骤甚至变得更简单。
如你所知，javadoc 工具具有高度的灵活性，而且其还允许进行一些配置。Ant 通过使用 javadoc 任务的方式来公开这些配置选项。如果你对 javadoc 不熟悉的话，我们建议你先看一下 Java 文档教程。
下述的章节列出了在 Ant 中最常使用的 javadoc 的选项。
源包括源路径，源路径引用或者源文件三个属性。
目标路径是通过使用 destdir 文件夹来指定的，例如 build.dir 。
你能够通过指定应被包括的包的名字来过滤 javadoc 任务。这可以通过使用 packagenames 属性实现，即一个以逗号分隔的包文件列表。
你可以过滤 javadoc 过程以只显示公有的，私有的，包或者被保护的类和成员。这些可以通过使用 private，public，package 和 protected 属性实现。
你也可以通过使用相应的属性来告诉 javadoc 任务去包含作者和版本信息。
你也可以使用 group 属性将所有的包组织在一起，以使得他们更易被操作。
让我们继续我们的主题，Hello world 传真应用程序。让我们给我们的传真应用项目添加一个文档目标。
下面给出的例子是我们在项目中使用的 javadoc 任务。在这个例子中，我们指定 javadoc 去使用 src.dir 作为源目录，doc 作为目标。
我们还定制窗口标题，标题，以及显示在 java 文档页上的页脚信息。
此外，我们还创建了三个组：
您可能会注意到，数据包组含有两个包 -- faxapp.entity 和 faxapp.dao 。
<target name = "generate-javadoc"> <javadoc packagenames="faxapp.*" sourcepath="${src.dir}" destdir = "doc" version = "true" windowtitle = "Fax Application"> <doctitle><![CDATA[= Fax Application =]]></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> <echo message = "java doc has been generated!" /></target>让我们运行 javadoc Ant 任务。它将生成 java 文档文件，并将这些文件放置于 doc 文件夹中。
当执行 javadoc 目标时，其产生以下的输出：
>C:>ant generate-javadoc>Buildfile: C:build.xml>java doc has been generated!>BUILD SUCCESSFUL>Total time: 10.63 secondjava 文档文件现在出现在 doc 文件夹中。
通常情况下，javadoc 文件作为发行版或者包目标的一部分。
编译完你的 java 源文件后，接下来就构建 java 存档，例如： JAR 文件。创建 Ant 中的 JAR 文件十分简单，运用 jar 任务来生成 jar 包。在 jar 任务中常用的属性如下所示：
| 属性 | 描述 |
| basedir | 表示输出 JAR 文件的基目录。默认情况下，为项目的基目录。 |
| compress | 表示告知 Ant 对于创建的 JAR 文件进行压缩。 |
| keepcompression | 表示 project 基目录的绝对路径。 |
| destfile | 表示输出 JAR 文件的名字。 |
| duplicate | 表示发现重复文件时 Ant 执行的操作。可以是添加、保存、或者是使该重复文件失效。 |
| excludes | 表示移除的文件列表，列表中使用逗号分隔多个文件。 |
| excludesfile | 与上同，但是使用模式匹配的方式排除文件。 |
| inlcudes | 与 excludes 正好相反。 |
| includesfile | 表示在被归档的文件模式下，打包文件中已有的文件。与 excludesfile 相反。 |
| update | 表示告知 Ant 重写已经建立的 JAR 文件。 |
继续我们的 Hello World 传真应用项目，通过添加一个新的目标 target 来产生 jar 文件。 但是在此之前，让我们先来考虑下面给出的 jar 任务。
<jar destfile = "${web.dir}/lib/util.jar" basedir = "${build.dir}/classes" includes = "faxapp/util/**" excludes = "**/Test.class" />这里，web.dir 属性指出了 web 源文件的路径。在我们的案例中， web 源文件路径也就是存放 util.jar 的地方。
在我们的案例中，build.dir 属性指出了配置文件夹的存储路径，也就是存放 util.jar 类文件的地方。
在上面的代码中，我们利用来自 faxapp.util 包中的类文件创建了一个名为 util.jar 的 jar 包。然而，我们排除名字为 Test 的类文件。输出的 jar 文件将会存放在 web 应用的配置文件 lib 中。
如果我们想 util.jar 成为可执行文件，只需在 Main-Class 元属性中加入manifest.
这样，上面给出的代码，在加入 Main-Class 元属性后，可以更新为如下形式：
<jar destfile = "${web.dir}/lib/util.jar" basedir = "${build.dir}/classes" includes = "faxapp/util/**" excludes = "**/Test.class"> <manifest> <attribute name = "Main-Class" value = "com.tutorialspoint.util.FaxUtil"/> </manifest></jar>为了执行 jar 任务，将它包装在目标 target 中，最常见的情况是，将 jar 任务包装在配置目标或者打包目标中（build 目标或 package 目标），并执行包装后的目标。
<target name="build-jar"> <jar destfile="${web.dir}/lib/util.jar" basedir="${build.dir}/classes" includes="faxapp/util/**" excludes="**/Test.class"> <manifest> <attribute name="Main-Class" value="com.tutorialspoint.util.FaxUtil"/> </manifest> </jar></target>在上述文件上运行 Ant ，就能创建出 util.jar。
上述文件运行 Ant 后，得到以下的输出：
C:>ant build-jarBuildfile: C:build.xmlBUILD SUCCESSFULTotal time: 1.3 seconds最后得到的输出 util.jar 将被存储在输出文件夹中。
使用 Ant 创建 WAR 文件是极其简单的。这与创建 JAR 文件任务非常类似。 毕竟，WAR 文件与 JAR 文件只是两种不同的 ZIP 文件。
WAR 任务是 JAR 任务的一个扩展，但是其对控制哪些文件进入 WEB-INF/classes 文件夹和生成 web.xml 文件进行了一些很好的补充。WAR 任务对指定 WAR 文件布局是非常有用的。
既然 WAR 任务是 JAR 任务的一个扩展，JAR 任务的所有的属性都适用于 WAR 任务。
| 属性 | 描述 |
|---|---|
| webxml | web.xml 文件的路径 |
| lib | 指定什么文件可以进入 WEB-INFlib 文件夹的一个组 |
| classes | 指定什么文件可以进入 WEB-INFclasses 文件夹的一个组 |
| metainf | 指定生成 MANIFEST.MF 文件的指令 |
继续我们的 Hello World 传真应用项目，让我们添加一个新的目标来生成 jar 文件。 但是在此之前，我们需要考虑一下 war 任务。 请看下面的例子：
<war destfile = "fax.war" webxml = "${web.dir}/web.xml"> <fileset dir = "${web.dir}/WebContent"> <include name = "**/*.*"/> </fileset> <lib dir = "thirdpartyjars"> <exclude name = "portlet.jar"/> </lib> <classes dir = "${build.dir}/web"/></war>按照前面的例子中，web.dir 变量指向源 web 文件夹，即该文件包含 JSP，css 和 javascript 文件等等。
该 build.dir 变量指向输出文件夹，WAR 的包能在该文件夹下找到。 通常情况下， 类将被绑定到 WAR 文件下的 WEB-INF/classes 文件夹下。
在这个例子中，我们创建了一个名为 fax.war 的 war 文件。WEB.XML 文件可以从 web 源文件中获取。 所有 web 下来自 “WebContent” 的文件都被复制到 WAR 文件中。
WEB-INF/lib 文件夹中存储了来自于第三方 jar 文件夹中的 jar 文件。但是，我们排除了 portlet.jar，因为该 jar 文件已经存在于应用服务器的 lib 文件夹中了。最后，我们从一个构建目录下的 web 文件夹中复制所有的类，并将复制的类全部放入 WEB-INF/classes 文件夹下。
将一个 war 任务封装到一个 Ant 任务中并运行它。 这将在指定位置创建一个 WAR 文件。
类，库，metainf 和 webinf 目录完全可以进行嵌套以使得他们都能存在于项目结构下分散的文件夹中。 但是最佳的实践建议是，你的 web 项目的 web 内容架构应该与 WAR 文件类似。 传真应用项目的架构就是使用了这个基本原理。
要执行 war 任务，将其封装在一个目标里面，最常见的是，构建目标或者是包目标，然后运行它们。
<target name="build-war"> <war destfile="fax.war" webxml="${web.dir}/web.xml"> <fileset dir="${web.dir}/WebContent"> <include name="**/*.*"/> </fileset> <lib dir="thirdpartyjars"> <exclude name="portlet.jar"/> </lib> <classes dir="${build.dir}/web"/> </war></target>在这个文件上运行 Ant 会替我们创建 fax.war 文件。
下述的输出就是运行 Ant 文件的结果：
>C:>ant build-war>Buildfile: C:build.xml>BUILD SUCCESSFUL>Total time: 12.3 seconds该 fax.war 文件当前被放置在输出文件夹中。war 文件的内容如下所示：
>fax.war: >+---jsp ：这个文件夹包含了 jsp 文件 >+---css ：这个文件夹包含了 stylesheet 文件 >+---js ：这个文件夹包含了 javascript 文件 >+---images：这个文件夹包含了 image 文件 >+---META-INF：这个文件夹包含了 Manifest.Mf >+---WEB-INF >+---classes ：这个文件夹包含了编译好的类 >+---lib ：第三方库和使用程序 jar 文件 >WEB.xml ：定义 WAR 包的配置文件 我们通过 Hello World Fax Web 应用，已经琐碎地学习了 Ant 的不同方面的知识了。
现在是时候把我们所学的知识都运用起来创建一个全面和完整的 build.xml 文件了。考虑下面给出的 build.properties 和 build.xml 文件：
eploy.path = c: omcat6webapps<?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>在上面给出的例子中：
上述的例子向我们展示了两个部署目标： deploy 和 deploywar 。
这个 deploy 目标将文件从 web 目录复制到部署目录，并保存最后修改日期时间戳。这样很有用，特别是当我们将项目部署到服务器上,并且该服务器支持热部署。（释义：所谓热部署，就是在应用正在运行的时候升级软件，却不需要重新启动应用。）
这个 clean 目标清楚所有之前的构建文件。
这个 deploywar 目标构建 war 文件,然后将 war 文件复制到应用程序服务器的部署目录。
在之前的章节中，我们已经学会了如何去打包一个应用程序以及怎样将其部署到一个文件夹中。
在这个章节中，我们将要直接将 web 应用程序部署到一个应用服务器的部署文件夹中。随后，我们将添加一些 Ant 目标来启动和停止服务。让我们继续 Hello World fax web 应用程序。 这一章节是对之前的章节的一个延续，所有新的组件会用粗体突出显示。
# Ant properties for building the springappappserver.home=c:installapache-tomcat-7.0.19# for Tomcat 5 use $appserver.home}/server/lib# for Tomcat 6 use $appserver.home}/libappserver.lib=${appserver.home}/libdeploy.path=${appserver.home}/webappstomcat.manager.url=http://www.tutorialspoint.com:8080/managertomcat.manager.username=tutorialspointtomcat.manager.password=secret<?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><!-- ============================================================ --><!-- Tomcat tasks --><!-- ============================================================ --><path id="catalina-ant-classpath"><!-- We need the Catalina jars for Tomcat --><!-- * for other app servers - check the docs --> <fileset dir="${appserver.lib}"> <include name="catalina-ant.jar"/> </fileset></path><taskdef name="install" classname="org.apache.catalina.ant.InstallTask"> <classpath refid="catalina-ant-classpath"/></taskdef><taskdef name="reload" classname="org.apache.catalina.ant.ReloadTask"> <classpath refid="catalina-ant-classpath"/></taskdef><taskdef name="list" classname="org.apache.catalina.ant.ListTask"> <classpath refid="catalina-ant-classpath"/></taskdef><taskdef name="start" classname="org.apache.catalina.ant.StartTask"> <classpath refid="catalina-ant-classpath"/></taskdef><taskdef name="stop" classname="org.apache.catalina.ant.StopTask"> <classpath refid="catalina-ant-classpath"/></taskdef><target name="reload" description="Reload application in Tomcat"> <reload url="${tomcat.manager.url}"username="${tomcat.manager.username}" password="${tomcat.manager.password}" path="/${name}"/></target></project>在这个例子中，我们已经使用 Tomcat 作为我们应用的服务器。 首先，在构建属性文件中，我们已经定义了一些附加属性。
在 Tomcat 中的应用程序能通过使用 Tomcat 管理应用程序进行启动和停止。管理应用程序的统一资源定位器（URL），用户名和密码也在 build.properties 文件夹中进行指定。 接下来，我们声明一个新的 CLASSPATH 来包含 catalina-ant.jar。 若要通过 Apache Ant 来运行 Tomcat， 这个 jar 文件是必须的。
catalina-ant.jar 提供了下述的任务：
| 属性 | 描述 |
|---|---|
| InstallTask | 安装一个 web 应用程序。 类名字为： org.apache.catalina.ant.InstallTask |
| ReloadTask | 重新安装一个 web 应用程序。类名字为： org.apache.catalina.ant.ReloadTask |
| ListTask | 列出所有的 web 应用程序。类名字为： Class Name: org.apache.catalina.ant.ListTask |
| StartTask | 启动一个 web 应用程序。类名字为： org.apache.catalina.ant.StartTask |
| StopTask | 停止一个 web 应用程序。类名字为： org.apache.catalina.ant.StopTask |
| ReloadTask | 重新加载一个无需停止的 web 应用程序。类名字为：org.apache.catalina.ant.ReloadTask |
重载任务需要下列附加参数：
让我们发出部署 war (deploy-war)的命令来复制 web 应用程序到 Tomcat 的 webapps 文件夹中。同时，我们重新加载传真 web 应用程序。下述的输出是运行 Ant 文件的结果。
>C:>ant deploy-war>Buildfile: C:build.xml>BUILD SUCCESSFUL>Total time: 6.3 seconds>C:>ant reload>Buildfile: C:build.xml>BUILD SUCCESSFUL>Total time: 3.1 seconds一旦上述的任务被运行，web 应用程序就是已经被部署好且重新加载了的。
你可以用 Ant 来执行 Java 代码。在下面的例子中，给出的 java 类文件需要一个参数（管理员的邮箱地址），执行后将发送一封邮件。
public class NotifyAdministrator{ public static void main(String[] args) { String email = args[0]; notifyAdministratorviaEmail(email); System.out.println("Administrator "+email+" has been notified"); } public static void notifyAdministratorviaEmail(String email { //...... }}这里给出上面 java 类文件需要的 build.xml 构建文件。
<?xml version="1.0"?><project name="sample" basedir="." default="notify"> <target name="notify"> <java fork="true" failonerror="yes" classname="NotifyAdministrator"> <arg line="admin@test.com"/> </java> </target></project>当 build.xml 被执行后，将会产生下面的输出：
C:>antBuildfile: C:build.xmlnotify: [java] Administrator admin@test.com has been notifiedBUILD SUCCESSFULTotal time: 1 second在这里例子中， java 代码完成了一件简单的事情 —— 发送一封邮件。我们也可以运用 Ant 任务来完成这项操作。然而，既然你已经有了这个想法，你可以扩展你的 build.xml 文件来调用 java 代码，完成同样的事情，比如：你还可以加密你的代码。
如果你已经下载并安装了 Eclipse， 你只要再做一点点事情就可以开始了。Eclipse 附带预先绑定的 Ant 插件，随时可以使用。
按照以下简单的步骤，将 Ant 集成到 Eclipse 中。
你的 Ant 视图类似于：
点击目标，build/clean/usage 将运行 Ant 以及目标。
点击 “fax” 将执行默认的目标－usage。
Ant 的 Eclipse 插件还附带了一个很好的编辑器，其可用来编辑 build.xml 文件。该编辑器可以识别 build.xml 模式，并可以协助你完成代码。
为了使用 Ant 编辑器，右键单击你的 build.xml（从工程资源管理器中），然后选择用 Ant 编辑器打开。 Ant编辑器看起来应该类似于下图：
JUnit 是一个 Java 语言的单元测试框架。它易于使用且易于扩展。有许多可用的 JUnit 扩展。如果你对 JUnit 不是很熟悉，你可以在 www.junit.org 网址上下载相关手册。
这一章节将向你展示如何用 Ant 来扩展 JUnit 。Ant 直接使用 JUnit 任务。
下面给出 JUnit 任务的相关属性：
| 属性 | 描述 |
| dir | 表示从哪里调用 VM。当 **fork** 被禁用的时候，这个属性将会被忽略。 |
| jvm | 表示调用 JVM 的命令。当 **fork** 被禁用的时候，这个属性将会被忽略。 |
| fork | 表示在独立的 java 虚拟机中运行测试文件。 |
| errorproperty | 表示当有一个 JUnit 失效的时候，设置属性的名字。 |
| failureproperty | 表示当有一个 JUnit 失效的时候，设置属性的名字。 |
| haltonerror | 表示当一个测试有错误的时候，停止执行过程。 |
| haltonfailure | 表示当有故障发生的时候，停止执行过程。 |
| printsummary | 表示告知 Ant 展示每个测试例子的简单统计。 |
| showoutput | 表示告知 Ant 展示输出结果到 log 日志文件或者格式器上。 |
| tempdir | 表示存放 Ant 将会运用到的临时文件。 |
| timeout | 表示测试过程耗时太长，超过了设置时间（毫秒级）。 |
让我们继续 Hello World 传真应用这个主题，并加入 JUnit 任务。
下面给出的例子展示了一个简单的 JUnit 测试例子的执行过程：
<target name="unittest"> <junit haltonfailure="true" printsummary="true"> <test name="com.tutorialspoint.UtilsTest"/> </junit></target>上面给出的例子展示了 com.tutorialspoint.UtilsTest junit 类的执行过程。运行上面的代码，将会看到以下输出：
test:[echo] Testing the application[junit] Running com.tutorialspoint.UtilsTest[junit] Tests run: 12, Failures: 0, Errors: 0, Time elapsed: 16.2 secBUILD PASSEDAnt 带有一组预定义的任务，但是你可以创建自己的任务，如下面的例子所示。
定制 Ant 任务应扩展 org.apache.tools.ant.Task 类，同时也应该拓展 execute() 方法。下面是一个简单的例子：
package com.tutorialspoint.ant;import org.apache.tools.ant.Task;import org.apache.tools.ant.Project;import org.apache.tools.ant.BuildException;public class MyTask extends Task { String message; public void execute() throws BuildException { log("Message: " + message, Project.MSG_INFO); } public void setMessage(String message) { this.message= message; }}为了运行定制的任务，你需要添加下列内容到 Hello World 传真 web 应用程序中：
<target name="custom"> <taskdef name="custom" classname="com.tutorialspoint.ant.MyTask" /> <custom message="Hello World!"/></target>执行上述的定制任务后将打印出一条信息为： 'Hello World!'
>c:>ant custom>test:>[custom] Message : Hello World!>elapsed: 0.2 sec>BUILD PASSED这只是一个简单的例子，你可以使用 Ant 的能力去做任何你想提高你的构建和部署过程效率的事情。