Ant

一，简介：

流程脚本引擎。

用来批量执行编译，打包，部署。

基于Java，用Java的类来扩展功能。

配置文件是XML格式。

 

二，配置文件：

配置文件通常起名为build.xml。

该xml由一个project组成，project可分为几个target，target可分为几个task。

多个target如何确定执行顺序： 根据project的default属性指定第一个执行的target；多个target之间通过depends属性，指定执行顺序。

什么是task：task就是指具体某项操作，如编译javac，打包jar。用户还可自定义task。

小例子：

 

<project name="project-name" default="install">
<target name="install" depends="clean,build,deploy"/>
<target name="clean">
<delete />
</target>
<target name="build">
<javac />
<jar />
</target>
<target name="deploy">
<copy />
</target>
</project>

 

1，project标签

(1) default表示默认的运行目标，这个属性是必须的。
(2) basedir表示项目的基准目录。
(3) name表示项目名。
(4) description表示项目的描述。

 

2，target标签

(1)name表示标明，这个属性是必须的。
(2)depends表示依赖的目标。
(3)if表示仅当属性设置时才执行。
(4)unless表示当属性没有设置时才执行。
(5)description表示项目的描述。

注意：

一个target只能被执行一次，即使有多个target依赖于它。

如果没有if或unless属性，target总会被执行。

 

三，执行：

ant -f build.xml

 

四，变量：

1，基本变量：

本地定义：

(1)name和value，比如：

<property name="src" value=src"/>

 

(2)name和refid，比如：

<property name="src" refid="compile.src"/>

其中compile.src已经定义过了。

 

配置文件定义：

(1)file，导入build.properties属性文件中的属性值。比如：

<property file="build.properties"/>

(2)resource，导入build.properties属性文件中的属性值。比如：

 

 

<propety resource="build.properties"/>

(3)url，导入http://www.blogjava.net/wiflish/build.properties属性文件中的属性值。比如：

 

 

<property url="http://www.blogjava.net/wiflish/build.properties"/>

 

读取机器环境变量：

(1)environment，设置系统的环境变量为前缀env，将系统的tomcat安装目录设置到tomcat.home属性中。比如：

 

<property environment="env"/>
<property name="tomcat.home" value="${env.CATALINA_HOME}"/>

定义路径：

(1)name和location，即将srcdir的值设置为：当前项目根目录的/src目录。比如：

 

<property name="srcdir" location="src"/>

 

 

2，path变量：路径信息十分常用，因此可定义，名为path的元素。

定义：

<path id="classpath" location="lib" />

使用：

<classpath refid="classpath" />

 

五，逻辑值

在Ant中可声明一个逻辑值，该逻辑值可控制target是否执行，通过if和unless。

 

 

<project name="testCondition" default＝“test”>
    <target name="test">
        <condition property="scondition">
            <istrue value="true"/>                    
        </condition>
        <antcall target="isTrue"></antcall>
        <antcall target="isFalse"></antcall>        
    </target>
    <target name="isTrue" if="scondition">
        <echo>is ture</echo>
    </target>
    <target name="isFalse" unless="scondition">
        <echo>is false</echo>
    </target>
</project>

 

 

该逻辑值可通过计算得到：

1，istrue(isfalse)

如果value的值是"true"，则conditionName为true；如果是"false"，则conditionName为false。isfalse相反。

 

<condition property="conditionName">
<istrue value="true"/>                    
</condition>

2，equals

 

如果arg1的值与arg2的值相等返回true，否则为false

 

<condition property="conditionName">
<equals arg1="${name}" arg2="Jason"/>
</condition>

 

3，isset

如果属性name不存在则返回false

<isset property="name"/>

 

4，available

在指定的classpath路径下是否存在资源 Test.class

 

<available resource="Test.class">
<classpath refid="classpath" />        
</available>

 

 

5，filesmatch

如果file1所代表的文件与file2所代表的文件相等返回true，否则为false

 

<filesmatch file1="testfile1.txt" file2="testfile2.txt"/>

 

6，运算

可加<not>,<and>,<or>,<xor>进行逻辑运算。

 

六，常用task详解：

1，javac

用来编译java程序。

(1)srcdir表示源程序的目录。
(2)destdir表示class文件的输出目录。
(3)include表示被编译的文件的模式。
(4)excludes表示被排除的文件的模式。
(5)classpath表示所使用的classpath。
(6)debug表示显示调试信息。
(7)optimize表示是否使用优化。
(8)verbose 表示提供详细的输出信息。
(9)fileonerror表示当碰到错误就自动停止。

常用例子：

<javac nowarn="false" destdir="${build}" source="1.6" target="1.6" debug="true">
<src path="${src}" />
<classpath refid="classpath" />
</javac>

2，jar

用来打包class文件。

(1) destfile表示JAR文件名。
(2) basedir表示被打包的文件名。
(3) includes表示被打包的文件模式。
(4) exchudes表示被排除打包的文件模式。

常用例子：

<jar destfile="${jarname}.jar">
<fileset dir="${build}" />
</jar>

 

3，java

用来执行java文件。

(1)classname 表示将执行的类名。
(2)jar表示包含该类的JAR文件名。
(3)classpath所表示用到的类路径。
(4)fork表示在一个新的虚拟机中运行该类。
(5)failonerror表示当出现错误时自动停止。
(6)output 表示输出文件。
(7)append表示追加或者覆盖默认文件。

4，文件操作

创建：

 <mkdir dir="${build}" />

 

删除：

<delete dir="${build}" />

 

复制：

<copy file="${jarname}.jar" todir="${libs}" />

 

Ant project structure
trunk
->java
->src
->main(class file)
->test(test file)
->config(spring.xml)
->build.xml
->resources(log4j.xml,properties)
->classpath.xml


in classpath.xml
<?xml version="1.0" encoding="UTF-8"?>
<classpath>
<classpathentry kind="src" path="java/src/main"/>
<classpathentry kind="src" path="java/src/test"/>
...
<classpathentry kind="lib" path="java/config"/>
<classpathentry kind="lib" path="resources"/>
</classpath>