Ant的使用

Ant 是一种基于java的生成工具。作用类似c编程的Make工具（Unix平台使用较多）

Ant具有平台的无关特性，但考虑到解压缩的方便性，通常建议Windows平台下载*.zip压缩包，而Linux平台下载.gz压缩包。

文件结构：

bin：启动和运行Ant的可执行性命令

docs：Ant工具的相关文档，这些文档对学习使用Ant有很大的作用

etc:包含一些样式单文件，通常无需理会该目录下的文件

lib：包含Ant的核心类库，以及编译和运行Ant所依赖的第三方类库。

LICENSES等说明文档

Ant的运行需要如下两个环境变量：

JAVA_HOME：该环境变量应指向JDK的安装路径。 ANT_HOME：该环境变量应指向Ant的安装路径

使用Ant工具

如果运行ant命令时没有指定任何参数，Ant会在当前目录下搜索build.xml文件。如果找到了就以该文件为生成文件，并执行默认的target

-find或-s作用相同，Ant会自动到上级目录中搜索生成文件，直到到达文件系统的根目录。

ant -f a.xml//显示指定使用a.xml作为生成文件

ant -file b.xml//显示指定使用b.xml作为生成文件

-quiet或-q选项  ant运行时只输出少量的必要信息

-verboe或-v   ant运行时输出更多的提示信息

如果希望ant运行时将提示信息输出到指定文件，而不是控制台，则可使用-logfile<file>或-l<file>选项

ant -verbose -l a.log//运行ant时生成更多的提示信息，并将提示信息输出到a.log中

--ant还允许运行时指定一些属性来覆盖生成文件中指定的属性值（使用property task来指定），如-D<property>=<value>,则此处指定的value将会覆盖生成文件中的property的属性值      ant -Dbook=Spring2//该命令将会覆盖生成文件中的book属性值

通过该方法可以将操作系统的环境变量值传入生成文件，如我们在运行Ant工具时使用如下命令： ant -Denvl=%ANT_HOME%

用于生成文件中传入一个env1属性，而该属性的值并没有直接给出，而是用%ANT_HOME%的形式给出--这是Windows下访问环境变量的形式。可以将windows环境变值传入生成文件了，如果希望在生成文件中访问到该环境变量的值，使用$env1

---定义生成文件

使用Ant的关键就是编写生成文件，生成文件定义了该项目的各个生成任务（每个target表示一个生成任务），并定义生成任务之间的依赖关系。

默认生成文件名为build.xml,也可以取其它的名字、

一个典型项目的层次结构

<project>:该文件夹存放了整个项目的全部资源

      <src>:存放源文件、各种配置文件的文件夹

      <classes>存放编译后的class文件的文件夹

      <lib>  存放第三方JAR包的文件夹

      <dist> 存放项目打包、项目发布文件的文件夹

     build.xml  Ant生成问件，根元素是<project../>  子元素是<target.../>

project常见属性default：指定默认的target，属性是必须的。

basedir：指定项目的基准路径，生成文件中其他相对路径都是基于该路径。

name：指定项目名，该属性仅指一个名字，对编译、生成项目没有太大的实际作用。

description：指定项目的描述信息，对编译、生成项目没有太大的实际作用。

<? version="1.0" encoding="GBK"?><!--下面的配置信息指定基准路径是当前路径，默认target为空--><project name="struts2" description="demo" basedir="." default=""></project>

target元素包括

name：该属性是必须的，非常重要，当希望Ant运行指定的生成目标时，就是根据该name来确定生成目标的。所以可以得出一个结论：同一个生成文件里不能有两个同名的targ

</pre>et元素<p></p><p>depends： 该属性可指定一个或多个target名，表示运行该target之前应先运行该depends属性所指定的一个或多个target。</p><p>if：该属性指定一个属性名，用属性表示仅当设置了该属性时才执行此target</p><p>unless ： 该属性指定一个属性名，用属性表示仅当设置了该属性时才执行此target</p><p>description;指定该target的描述信息</p><p></p><pre code_snippet_id="1660848" snippet_file_name="blog_20160425_3_6461572" name="code" class="java"><!--下面表示执行run target之前，必须先执行compile target--><target name="run" depends="compile"/><!--只有当设置了propl属性之后才会执行exA target--><target name="exA" if="propl"/><!--只要没有设置prop2属性，就可以执行exB target--><target name="exB" unless="prop2"/>

每个生成目标有可能由一个或多个任务序列组成，当执行某个生成目标时，实际上就是依次完成该目标所包含的全部任务。每个任务由一段可执行的代码组成。

<name attribute1="value1" attrubute2="value2".../>

----ant 生成文件的属性值不可改变

<!--定义一个名为builddir的属性，其值为dd--><property name="builddir" value="dd">

如需要获取属性值，则使用${propName}的形式      ${builddir}

$在Ant生成文件中具有特设意义，若要将$当成普通字符使用$$

<echo>$${builddir}=${builddir}</echo>

输出结果是  ${builddir}=dd

property元素可以接受的常用属性：

name：指定需要设置的属性名

value：指定需要设置的属性值

resource：指定属性文件的资源名称，Ant将负责从属性文件中读取属性名和属性值

file：指定属性文件的文件名，Ant将负责从属性文件中读取属性名和属性值

encvironment：用于指定系统环境变量的前缀。通过这种方式允许Ant访问系统环境变量

classpath： 指定搜索属性文件的文件和路径集

classpathref：指定搜索属性文件的文件和路径集引用，该属性并不是直接给出系列文件或路径，而是给定文件和路径集引用。

<!--指定读取foo.properties属性文件中的属性名和属性值--><property file="foo.properties"/><!--从网络中读取属性名和属性值--><property url="http://www.crazyit.org/props/foo.properties"/>

属性文件就是普通的属性文件，该文件的内容由系列的name=value组成，

author=Yeeku.H.Lee

book=Light Weight Java EE

price=56

<!--定义访问操作系统环境变量的前缀是env--><property environment="env"/

定义之后可以在Ant生成文件中通过如下形式来访问操作系统环境变量：

<echo>${env.JAVA_HOME}</echo>

2.path元素和classpath元素

通常需要使用Ant编译、运行Java文件，编译、运行Java文件时常常需要引用第三方JAR包，这就需要使用<classpath.../>元素了。用于定义文件和路径集，区别是classpath元素通常作为其他任务的子元素，既可引用已有的文件和目录集，也可临时定义一个文件和目录集；path则作为project元素的子元素，用于定义一个独立的、有名称的文件和目录集，用于被引用。

 二者都用于文件和目录集，定义的内容称为Path-like Structures（似目录结构）

子元素：

pathelement：用于指定一个或多个目录 包括两个属性①path：指定一个或多个目录（或者jar文件），多个目录或jar文件之间以英文（：）或英文分号（；）分开②location：指定一个目录和jar文件

dirset：采用模式字符串的方式指定系列目录

fileset：采用模式字符串的方式指定系列文件

filelist： 采用直接列出系列文件名的方式指定系列文件   

<!--定义/path/to/file2.jar  /path/to/class2和/path/to/class3所组成的目录集--><pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3"/><!--定义由lib/helper.jar单个文件对应的目录--><pathelement location="lib/helper.jar"/>、

如果需要指定多个目录集，则应该使用<dirset.../>,该元素需要一个dir属性，dir属性指定该目录集的根路径。除此之外dirset还可以使用<include.../>和<exclude.../>两个子元素来指定包含和不包含那些目录，

<!--指定该目录集的根路径是build目录--><dirset dir="build"><!--指定包含apps目录下的所有classes目录--><incldue name="apps/**/classed"/><!--指定排除目录名中有Test的目录--><exclude name="apps/**/*Test*"/></dirset>

上面的配置文件代表build/apps目录下，所有名为classes且文件名不包含Test子串的目录

如果给希望配置多个文件，则可用<fileset.../>或者<filelist.../>元素，通常<fileset.../>使用模式字符串来匹配文件集，而<filelist.../>则通过列出文件名的方式指定文件集

<filelist.../>元素需要指定两个属性dir和files，dir指定文件集里多个文件所在的基准路径，必需属性

files：多个文件名列表，多个文件名之间以英文逗号，或空白隔开

<!--配置src/foo.xml和src/bar.xml文件组成的文件集--><filelist id="docfiles" dir="src" files="foo.xml,bar.xml"/>

<!--等价--><filelist id="docfiles" dir="${doc.src}"><!--通过两个file子元素指定的文件列表和通过files属性指定的效果完全一样--><file name="foo.xml"/><file name="bar.xml"/></filelist>

<fileset/>元素可指定两个元素   dir：指定文件集里多个文件所在的基准路径，必需属性   casesensitive：指定是否区分大小写，默认区分大小写

<!--定义src路径下的文件集--><fileset dir="src" casesensitive="yes"><!--包含所有*.java文件--><include name="**/*.java"/><!--排除所有文件中有Test子串的文件--><exclude name="**/*Test*"/></fileset>

下面是比较完整的使用：

<path id="classpath"><!--定义classpath属性值所代表的路径--><pathelement path="${classpath}"/><!--定义lib路径下的所有*.jar文件--><fileset dir="lib"><include name="**/*.jar"/></fileset><!--定义classes路径--><pathelement location="classes"/><!--定义build/app路径下所有classes路径--><dirset dir="build"><include name="apps/**/classed"/><exclude name ="apps/**/*Test*"/></dirset><!--定义res路径下的a.properties和b.xml文件--><filelist dir="res" files="a.properties,b.xml"/></path>