1 Ant是什么? 

ApacheAnt是一个基于Java的生成工具。

生成工具在软件开发中用来将源代码和其他输入文件转换为可执行文件的形式(也有可能转换为可安装的产品映像形式)。Ant是Java平台下非常棒的批处理命令执行程序,能非常方便地自动完成编译,测试,打包,部署等等一系列任务,大大提高开发效率。如果你现在还没有开始使用Ant,那就要赶快开始学习使用,使自己的开发水平上一个新台阶。

2下载、安装Ant

安装Ant

下载.zip文件,解压缩到c:\ant1.3(后面引用为%ANT_HOME%)

2.1在你运行Ant之前需要做一些配置工作。

•将bin目录加入PATH环境变量。

•设定ANT_HOME环境变量,指向你安装Ant的目录。在一些OS上,Ant的脚本可以猜测ANT_HOME(Unix和WindosNT/2000)-但最好不要依赖这一特性。

•可选地,设定J***A_HOME环境变量(参考下面的高级小节),该变量应该指向你安装JDK的目录。

注意:不要将Ant的ant.jar文件放到JDK/JRE的lib/ext目录下。Ant是个应用程序,而lib/ext目录是为JDK扩展使用的(如JCE,JSSE扩展)。而且通过扩展装入的类会有安全方面的限制。

2.2运行Ant

运行Ant非常简单,当你正确地安装Ant后,只要输入ant就可以了。

没有指定任何参数时,Ant会在当前目录下查询build.xml文件。如果找到了就用该文件作为buildfile。如果你用-find选项。Ant就会在上级目录中寻找buildfile,直至到达文件系统的根。要想让Ant使用其他的buildfile,可以用参数-buildfilefile,这里file指定了你想使用的buildfile。

可以指定执行一个或多个target。当省略target时,Ant使用标签<project>的default属性所指定的target。

命令行选项总结:

ant[options][target[target2[target3]...]]

Options:

-helpprintthismessage

-projecthelpprintprojecthelpinformation

-versionprinttheversioninformationandexit

-quietbeextraquiet

-verbosebeextraverbose

-debugprintdebugginginformation

-emacsproducelogginginformationwithoutadornments

-logfilefileusegivenfileforlogoutput

-loggerclassnametheclassthatistoperformlogging

-listenerclassnameaddaninstanceofclassasaprojectlistener

-buildfilefileusespecifiedbuildfile

-findfilesearchforbuildfiletowardstherootofthefilesystemandusethefirstonefound

-Dproperty=valuesetpropertytovalue

例子

使用当前目录下的test.xml运行Ant,执行缺省的target。

ant-buildfiletest.xmldist

使用当前目录下的test.xml运行Ant,执行一个叫做dist的target。

ant-buildfiletest.xml-Dbuild=build/classesdist

使用当前目录下的test.xml运行Ant,执行一个叫做dist的target,并设定build属性的值为build/classes。

3编写build.xml

Ant的buildfile是用XML写的。每个buildfile含有一个project。

buildfile中每个task元素可以有一个id属性,可以用这个id值引用指定的任务。这个值必须是唯一的。(详情请参考下面的Task小节)

3.1Projects

project有下面的属性:

AttributeDescriptionRequired

name项目名称.No

default当没有指定target时使用的缺省targetYes

basedir用于计算所有其他路径的基路径。该属性可以被basedirproperty覆盖。当覆盖时,该属性被忽略。如果属性和basedirproperty都没有设定,就使用buildfile文件的父目录。No

项目的描述以一个顶级的<description>元素的形式出现(参看description小节)。

一个项目可以定义一个或多个target。一个target是一系列你想要执行的。执行Ant时,你可以选择执行那个target。当没有给定target时,使用project的default属性所确定的target。

3.2Targets

一个target可以依赖于其他的target。例如,你可能会有一个target用于编译程序,一个target用于生成可执行文件。你在生成可执行文件之前必须先编译通过,所以生成可执行文件的target依赖于编译target。Ant会处理这种依赖关系。

然而,应当注意到,Ant的depends属性只指定了target应该被执行的顺序-如果被依赖的target无法运行,这种depends对于指定了依赖关系的target就没有影响。

Ant会依照depends属性中target出现的顺序(从左到右)依次执行每个target。然而,要记住的是只要某个target依赖于一个target,后者就会被先执行。

<targetname="A"/>

<targetname="B"depends="A"/>

<targetname="C"depends="B"/>

<targetname="D"depends="C,B,A"/>

假定我们要执行targetD。从它的依赖属性来看,你可能认为先执行C,然后B,最后A被执行。错了,C依赖于B,B依赖于A,所以先执行A,然后B,然后C,最后D被执行。

一个target只能被执行一次,即时有多个target依赖于它(看上面的例子)。

如果(或如果不)某些属性被设定,才执行某个target。这样,允许根据系统的状态(javaversion,OS,命令行属性定义等等)来更好地控制build的过程。要想让一个target这样做,你就应该在target元素中,加入if(或unless)属性,带上target因该有所判断的属性。例如:

<targetname="build-module-A"if="module-A-present"/>

<targetname="build-own-fake-module-A"unless="module-A-present"/>

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

可选的description属性可用来提供关于target的一行描述,这些描述可由-projecthelp命令行选项输出。

将你的tstamptask在一个所谓的初始化target是很好的做法,其他的target依赖这个初始化target。要确保初始化target是出现在其他target依赖表中的第一个target。在本手册中大多数的初始化target的名字是"init"。

target有下面的属性:

AttributeDescriptionRequired

nametarget的名字Yes

depends用逗号分隔的target的名字列表,也就是依赖表。No

if执行target所需要设定的属性名。No

unless执行target需要清除设定的属性名。No

description关于target功能的简短描述。No

3.3Tasks

一个task是一段可执行的代码。

一个task可以有多个属性(如果你愿意的话,可以将其称之为变量)。属性只可能包含对property的引用。这些引用会在task执行前被解析。

下面是Task的一般构造形式:

<nameattribute1="value1"attribute2="value2".../>

这里name是task的名字,attributeN是属性名,valueN是属性值。

有一套内置的(built-in)task,以及一些可选task,但你也可以编写自己的task。

所有的task都有一个task名字属性。Ant用属性值来产生日志信息。

可以给task赋一个id属性:

<tasknameid="taskID".../>

这里taskname是task的名字,而taskID是这个task的唯一标识符。通过这个标识符,你可以在脚本中引用相应的task。例如,在脚本中你可以这样:

<script...>

task1.setFoo("bar");

</script>

设定某个task实例的foo属性。在另一个task中(用java编写),你可以利用下面的语句存取相应的实例。

project.getReference("task1").

注意1:如果task1还没有运行,就不会被生效(例如:不设定属性),如果你在随后配置它,你所作的一切都会被覆盖。

注意2:未来的Ant版本可能不会兼容这里所提的属性,因为很有可能根本没有task实例,只有proxies。

3.4Properties

一个project可以有很多的properties。可以在buildfile中用propertytask来设定,或在Ant之外设定。一个property有一个名字和一个值。property可用于task的属性值。这是通过将属性名放在"${"和"}"之间并放在属性值的位置来实现的。例如如果有一个propertybuilddir的值是"build",这个property就可用于属性值:${builddir}/classes。这个值就可被解析为build/classes。

内置属性

如果你使用了<property>task定义了所有的系统属性,Ant允许你使用这些属性。例如,${os.name}对应操作系统的名字。

要想得到系统属性的列表可参考theJavadocofSystem.getProperties。

除了Java的系统属性,Ant还定义了一些自己的内置属性:

basedirproject基目录的绝对路径(与<project>的basedir属性一样)。

ant.filebuildfile的绝对路径。

ant.versionAnt的版本。

ant.project.name当前执行的project的名字;由<project>的name属性设定.

ant.java.versionAnt检测到的JVM的版本;目前的值有"1.1","1.2","1.3"and"1.4".

例子

<projectname="MyProject"default="dist"basedir=".">

<!--setglobalpropertiesforthisbuild-->

<propertyname="src"value="."/>

<propertyname="build"value="build"/>

<propertyname="dist"value="dist"/>

<targetname="init">

<!--Createthetimestamp-->

<tstamp/>

<!--Createthebuilddirectorystructureusedbycompile-->

<mkdirdir="${build}"/>

</target>

<targetname="compile"depends="init">

<!--Compilethejavacodefrom${src}into${build}-->

<javacsrcdir="${src}"destdir="${build}"/>

</target>

<targetname="dist"depends="compile">

<!--Createthedistributiondirectory-->

<mkdirdir="${dist}/lib"/>

<!--Puteverythingin${build}intotheMyProject-${DSTAMP}.jarfile-->

<jarjarfile="${dist}/lib/MyProject-${DSTAMP}.jar"basedir="${build}"/>

</target>

<targetname="clean">

<!--Deletethe${build}and${dist}directorytrees-->

<deletedir="${build}"/>

<deletedir="${dist}"/>

</target>

</project>

3.5Path-likeStructures

你可以用":"和";"作为分隔符,指定类似PATH和CLASSPATH的引用。Ant会把分隔符转换为当前系统所用的分隔符。

当需要指定类似路径的值时,可以使用嵌套元素。一般的形式是

<classpath>

<pathelementpath="${classpath}"/>

<pathelementlocation="lib/helper.jar"/>

</classpath>

location属性指定了相对于project基目录的一个文件和目录,而path属性接受逗号或分号分隔的一个位置列表。path属性一般用作预定义的路径--其他情况下,应该用多个location属性。

为简洁起见,classpath标签支持自己的path和location属性。所以:

<classpath>

<pathelementpath="${classpath}"/>

</classpath>

可以被简写作:

<classpathpath="${classpath}"/>

也可通过<fileset>元素指定路径。构成一个fileset的多个文件加入path-likestructure的顺序是未定的。

<classpath>

<pathelementpath="${classpath}"/>

<filesetdir="lib">

<includename="**/*.jar"/>

</fileset>

<pathelementlocation="classes"/>

</classpath>

上面的例子构造了一个路径值包括:${classpath}的路径,跟着lib目录下的所有jar文件,接着是classes目录。

如果你想在多个task中使用相同的path-likestructure,你可以用<path>元素定义他们(与target同级),然后通过id属性引用--参考Referencs例子。

path-likestructure可能包括对另一个path-likestructurede的引用(通过嵌套<path>元素):

<pathid="base.path">

<pathelementpath="${classpath}"/>

<filesetdir="lib">

<includename="**/*.jar"/>

</fileset>

<pathelementlocation="classes"/>

</path>

<pathid="tests.path">

<pathrefid="base.path"/>

<pathelementlocation="testclasses"/>

</path>

前面所提的关于<classpath>的简洁写法对于<path>也是有效的,如:

<pathid="tests.path">

<pathrefid="base.path"/>

<pathelementlocation="testclasses"/>

</path>

可写成:

<pathid="base.path"path="${classpath}"/>

命令行变量

有些task可接受参数,并将其传递给另一个进程。为了能在变量中包含空格字符,可使用嵌套的arg元素。

AttributeDescriptionRequired

value一个命令行变量;可包含空格字符。只能用一个

line空格分隔的命令行变量列表。

file作为命令行变量的文件名;会被文件的绝对名替代。

path一个作为单个命令行变量的path-like的字符串;或作为分隔符,Ant会将其转变为特定平台的分隔符。

例子

<argvalue="-l-a"/>

是一个含有空格的单个的命令行变量。

<argline="-l-a"/>

是两个空格分隔的命令行变量。

<argpath="/dir;/dir2:\dir3"/>

是一个命令行变量,其值在DOS系统上为\dir;\dir2;\dir3;在Unix系统上为/dir:/dir2:/dir3。

References

buildfile元素的id属性可用来引用这些元素。如果你需要一遍遍的复制相同的XML代码块,这一属性就很有用--如多次使用<classpath>结构。

下面的例子:

<project...>

<target...>

<rmic...>

<classpath>

<pathelementlocation="lib/"/>

<pathelementpath="${java.class.path}/"/>

<pathelementpath="${additional.path}"/>

</classpath>

</rmic>

</target>

<target...>

<javac...>

<classpath>

<pathelementlocation="lib/"/>

<pathelementpath="${java.class.path}/"/>

<pathelementpath="${additional.path}"/>

</classpath>

</javac>

</target>

</project>

可以写成如下形式:

<project...>

<pathid="project.class.path">

<pathelementlocation="lib/"/>

<pathelementpath="${java.class.path}/"/>

<pathelementpath="${additional.path}"/>

</path>

<target...>

<rmic...>

<classpathrefid="project.class.path"/>

</rmic>

</target>

<target...>

<javac...>

<classpathrefid="project.class.path"/>

</javac>

</target>

</project>

所有使用PatternSets, FileSets 或 path-like structures嵌套元素的task也接受这种类型的引用。

4.1 File(Directory)类

4.1.1Mkdir

创建一个目录,如果他的父目录不存在,也会被同时创建。

例子:

<mkdirdir="build/classes"/>

说明:如果build不存在,也会被同时创建

4.1.2Copy

拷贝一个(组)文件、目录

例子:

1.拷贝单个的文件:

<copyfile="myfile.txt"tofile="mycopy.txt"/>

2.拷贝单个的文件到指定目录下

<copyfile="myfile.txt"todir="../some/other/dir"/>

3.拷贝一个目录到另外一个目录下

<copytodir="../new/dir">

<filesetdir="src_dir"/>

</copy>

4.拷贝一批文件到指定目录下

<copytodir="../dest/dir">

<filesetdir="src_dir">

<excludename="**/*.java"/>

</fileset>

</copy>

<copytodir="../dest/dir">

<filesetdir="src_dir"excludes="**/*.java"/>

</copy>

5.拷贝一批文件到指定目录下,将文件名后增加。Bak后缀

<copytodir="../backup/dir">

<filesetdir="src_dir"/>

<mappertype="glob"from="*"to="*.bak"/>

</copy>

6.拷贝一组文件到指定目录下,替换其中的@标签@内容

<copytodir="../backup/dir">

<filesetdir="src_dir"/>

<filterset>

<filtertoken="TITLE"value="FooBar"/>

</filterset>

</copy>

4.1.3Delete

删除一个(组)文件或者目录

例子

1.删除一个文件

<deletefile="/lib/ant.jar"/>

2.删除指定目录及其子目录

<deletedir="lib"/>

3.删除指定的一组文件

<delete>

<filesetdir="."includes="**/*.bak"/>

</delete>

4.删除指定目录及其子目录,包括他自己

<deleteincludeEmptyDirs="true">

<filesetdir="build"/>

</delete>

4.1.4Move

移动或重命名一个(组)文件、目录

例子:

1.移动或重命名一个文件

<movefile="file.orig"tofile="file.moved"/>

2.移动或重命名一个文件到另一个文件夹下面

<movefile="file.orig"todir="dir/to/move/to"/>

3.将一个目录移到另外一个目录下

<movetodir="new/dir/to/move/to">

<filesetdir="src/dir"/>

</move>

4.将一组文件移动到另外的目录下

<movetodir="some/new/dir">

<filesetdir="my/src/dir">

<includename="**/*.jar"/>

<excludename="**/ant.jar"/>

</fileset>

</move>

5.移动文件过程中增加。Bak后缀

<movetodir="my/src/dir">

<filesetdir="my/src/dir">

<excludename="**/*.bak"/>

</fileset>

<mappertype="glob"from="*"to="*.bak"/>

</move>

4.2Java相关

4.2.1Javac

编译java原代码

例子

1.<javacsrcdir="${src}"

destdir="${build}"

classpath="xyz.jar"

debug="on"

/>

编译${src}目录及其子目录下的所有。Java文件,。Class文件将放在${build}指定的目录下,classpath表示需要用到的类文件或者目录,debug设置为on表示输出debug信息

2.<javacsrcdir="${src}:${src2}"

destdir="${build}"

includes="mypackage/p1/**,mypackage/p2/**"

excludes="mypackage/p1/testpackage/**"

classpath="xyz.jar"

debug="on"

/>

编译${src}和${src2}目录及其子目录下的所有。Java文件,但是package/p1/**,mypackage/p2/**将被编译,而mypackage/p1/testpackage/**将不会被编译。Class文件将放在${build}指定的目录下,classpath表示需要用到的类文件或者目录,debug设置为on表示输出debug信息

3.<propertyname="classpath"value=".;./xml-apis.jar;../lib/xbean.jar;./easypo.jar"/>

<javacsrcdir="${src}"

destdir="${src}"

classpath="${classpath}"

debug="on"

/>

路径是在property中定义的

4.2.2java

执行指定的java类

例子:

1.<javaclassname="test.Main">

<classpath>

<pathelementlocation="dist/test.jar"/>

<pathelementpath="${java.class.path}"/>

</classpath>

</java>

classname中指定要执行的类,classpath设定要使用的环境变量

2.<pathid="project.class.path">

<pathelementlocation="lib/"/>

<pathelementpath="${java.class.path}/"/>

<pathelementpath="${additional.path}"/>

</path>

<target...>

<rmic...>

<classpathrefid="project.class.path"/>

</rmic>

</target>

4.3打包相关

4.3.1jar

将一组文件打包

例子:

1.<jardestfile="${dist}/lib/app.jar"basedir="${build}/classes"/>

将${build}/classes下面的所有文件打包到${dist}/lib/app.jar中

2.<jardestfile="${dist}/lib/app.jar"

basedir="${build}/classes"

includes="mypackage/test/**"

excludes="**/Test.class"

/>

将${build}/classes下面的所有文件打包到${dist}/lib/app.jar中,但是包括mypackage/test/所有文件不包括所有的Test.class

3.<jardestfile="${dist}/lib/app.jar"

basedir="${build}/classes"

includes="mypackage/test/**"

excludes="**/Test.class"

manifest=”my.mf”

/>

manifest属性指定自己的META-INF/MANIFEST.MF文件,而不是由系统生成

4.3.2war

对Jar的扩展,用于打包Web应用

例子:

假设我们的文件目录如下:

thirdparty/libs/jdbc1.jar

thirdparty/libs/jdbc2.jar

build/main/com/myco/myapp/Servlet.class

src/metadata/myapp.xml

src/html/myapp/index.html

src/jsp/myapp/front.jsp

src/graphics/images/gifs/small/logo.gif

src/graphics/images/gifs/large/logo.gif

下面是我们的任务的内容:

<wardestfile="myapp.war"webxml="src/metadata/myapp.xml">

<filesetdir="src/html/myapp"/>

<filesetdir="src/jsp/myapp"/>

<libdir="thirdparty/libs">

<excludename="jdbc1.jar"/>

</lib>

<classesdir="build/main"/>

<zipfilesetdir="src/graphics/images/gifs"

prefix="images"/>

</war>

完成后的结果:

WEB-INF/web.xml

WEB-INF/lib/jdbc2.jar

WEB-INF/classes/com/myco/myapp/Servlet.class

META-INF/MANIFEST.MF

index.html

front.jsp

images/small/logo.gif

images/large/logo.gif

4.3.3ear

用于打包企业应用

例子

<eardestfile="${build.dir}/myapp.ear"appxml="${src.dir}/metadata/application.xml">

<filesetdir="${build.dir}"includes="*.jar,*.war"/>

</ear>

4.4时间戳

在生成环境中使用当前时间和日期,以某种方式标记某个生成任务的输出,以便记录它是何时生成的,这经常是可取的。这可能涉及编辑一个文件,以便插入一个字符串来指定日期和时间,或将这个信息合并到JAR或zip文件的文件名中。

这种需要是通过简单但是非常有用的tstamp任务来解决的。这个任务通常在某次生成过程开始时调用,比如在一个init目标中。这个任务不需要属性,许多情况下只需<tstamp/>就足够了。

tstamp不产生任何输出;相反,它根据当前系统时间和日期设置Ant属性。下面是tstamp设置的一些属性、对每个属性的说明,以及这些属性可被设置到的值的例子:

属性说明例子

DSTAMP设置为当前日期,默认格式为yyyymmdd20031217

TSTAMP设置为当前时间,默认格式为hhmm1603

TODAY设置为当前日期,带完整的月份2003年12月17日

例如,在前一小节中,我们按如下方式创建了一个JAR文件:

<jardestfile="package.jar"basedir="classes"/>

在调用tstamp任务之后,我们能够根据日期命名该JAR文件,如下所示:

<jardestfile="package-${DSTAMP}.jar"basedir="classes"/>

因此,如果这个任务在2003年12月17日调用,该JAR文件将被命名为package-20031217.jar。

还可以配置tstamp任务来设置不同的属性,应用一个当前时间之前或之后的时间偏移,或以不同的方式格式化该字符串。所有这些都是使用一个嵌套的format元素来完成的,如下所示:

<tstamp>

<formatproperty="OFFSET_TIME"

pattern="HH:mm:ss"

offset="10"unit="minute"/>

</tstamp>

上面的清单将OFFSET_TIME属性设置为距离当前时间10分钟之后的小时数、分钟数和秒数。

用于定义格式字符串的字符与java.text.SimpleDateFormat类所定义的那些格式字符相同

4.5执行SQL语句

通过jdbc执行SQL语句

例子:

1.<sql

driver="org.gjt.mm.mysql.Driver"

url="jdbc:mysql://localhost:3306/mydb"

userid="root"

password="root"

src="/data.sql"

/>

2.<sql

driver="org.database.jdbcDriver"

url="jdbc:database-url"

userid="sa"

password="pass"

src="/data.sql"

rdbms="oracle"

version="8.1."

>

</sql>

只有在oracle、版本是8.1的时候才执行

4.6发送邮件

使用SMTP服务器发送邮件

例子:

<mailmailhost="smtp.myisp.com"mailport="1025"subject="Testbuild">

<fromaddress="[email protected]"/>

<toaddress="[email protected]"/>

<message>The${buildname}nightlybuildhascompleted</message>

<filesetdir="dist">

<includesname="**/*.zip"/>

</fileset>

</mail>

mailhost:SMTP服务器地址

mailport:服务器端口

subject:主题

from:发送人地址

to:接受人地址

message:发送的消息

fileset:设置附件

----------

 在Eclipse中使用Ant

Eclipse中已经集成了Ant,我们可以直接在Eclipse中运行Ant。

以前面建立的Hello工程为例,创建以下目录结构:

新建一个build.xml,放在工程根目录下。build.xml定义了Ant要执行的批处理命令。虽然Ant也可以使用其它文件名,但是遵循标准能更使开发更规范,同时易于与别人交流。

通常,src存放Java源文件,classes存放编译后的class文件,lib存放编译和运行用到的所有jar文件,web存放JSP等web文件,dist存放打包后的jar文件,doc存放API文档。

然后在根目录下创建build.xml文件,输入以下内容:

 1 ant <? xml version = " 1.0 " ?> 

2<projectname="Helloworld"default="doc">

3

4<!--properies-->

5<propertyname="src.dir"value="src"/>

6<propertyname="report.dir"value="report"/>

7<propertyname="classes.dir"value="classes"/>

8<propertyname="lib.dir"value="lib"/>

9<propertyname="dist.dir"value="dist"/>

10<propertyname="doc.dir"value="doc"/>

11

12<!--定义classpath-->

13<pathid="master-classpath">

14<filesetfile="${lib.dir}/*.jar"/>

15<pathelementpath="${classes.dir}"/>

16</path>

17

18<!--初始化任务-->

19<targetname="init">

20</target>

21

22<!--编译-->

23<targetname="compile"depends="init"description="compilethesourcefiles">

24<mkdirdir="${classes.dir}"/>

25<javacsrcdir="${src.dir}"destdir="${classes.dir}"target="1.4">

26<classpathrefid="master-classpath"/>

27</javac>

28</target>

29

30<!--测试-->

31<targetname="test"depends="compile"description="runjunittest">

32<mkdirdir="${report.dir}"/>

33<junitprintsummary="on"

34haltonfailure="false"

35failureproperty="tests.failed"

36showoutput="true">

37<classpathrefid="master-classpath"/>

38<formattertype="plain"/>

39<batchtesttodir="${report.dir}">

40<filesetdir="${classes.dir}">

41<includename="**/*Test.*"/>

42</fileset>

43</batchtest>

44</junit>

45<failif="tests.failed">

46***********************************************************

47****Oneormoretestsfailed!Checktheoutput****

48***********************************************************

49</fail>

50</target>

51

52<!--打包成jar-->

53<targetname="pack"depends="test"description="make.jarfile">

54<mkdirdir="${dist.dir}"/>

55<jardestfile="${dist.dir}/hello.jar"basedir="${classes.dir}">

56<excludename="**/*Test.*"/>

57<excludename="**/Test*.*"/>

58</jar>

59</target>

60

61<!--输出api文档-->

62<targetname="doc"depends="pack"description="createapidoc">

63<mkdirdir="${doc.dir}"/>

64<javadocdestdir="${doc.dir}"

65author="true"

66version="true"

67use="true"

68windowtitle="TestAPI">

69<packagesetdir="${src.dir}"defaultexcludes="yes">

70<includename="example/**"/>

71</packageset>

72<doctitle><![CDATA[<h1>Hello,test</h1>]]></doctitle>

73<bottom><![CDATA[<i>AllRightsReserved.</i>]]></bottom>

74<tagname="todo"scope="all"description="Todo:"/>

75</javadoc>

76</target>

77</project>

78

79 ant
以上xml依次定义了init(初始化),compile(编译),test(测试),doc(生成文档),pack(打包)任务,可以作为模板。

选中Hello工程,然后选择“Project”,“Properties”,“Builders”,“New…”,选择“Ant Build”:

ant

填入Name:Ant_Builder;Buildfile:build.xml;Base Directory:${workspace_loc:/Hello}(按“Browse Workspace”选择工程根目录),由于用到了junit.jar包,搜索Eclipse目录,找到junit.jar,把它复制到Hello/lib目录下,并添加到Ant的Classpath中:

ant

然后在Builder面板中钩上Ant_Build,去掉Java Builder: ant

再次编译,即可在控制台看到Ant的输出:

Buildfile: F:\eclipse-projects\Hello\build.xml

init:

compile:

[mkdir]Createddir:F:\eclipse-projects\Hello\classes

       [javac] Compiling 2 source files to F:\eclipse-projects\Hello\classes

test:

[mkdir]Createddir:F:\eclipse-projects\Hello\report

[junit]Runningexample.HelloTest

       [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 0.02 sec

pack:

[mkdir]Createddir:F:\eclipse-projects\Hello\dist

         [jar] Building jar: F:\eclipse-projects\Hello\dist\hello.jar

doc:

[mkdir]Createddir:F:\eclipse-projects\Hello\doc

[javadoc]GeneratingJavadoc

[javadoc]Javadocexecution

[javadoc]Loadingsourcefilesforpackageexample...

[javadoc]ConstructingJavadocinformation...

[javadoc]StandardDocletversion1.4.2_04

[javadoc]Buildingtreeforallthepackagesandclasses...

[javadoc]Buildingindexforallthepackagesandclasses...

[javadoc]Buildingindexforallclasses...

[javadoc]GeneratingF:\eclipse-projects\Hello\doc\stylesheet.css...

[javadoc]Note:Customtagsthatcouldoverridefuturestandardtags:@todo.Toavoidpotentialoverrides,useatleastoneperiodcharacter(.)incustomtagnames.

[javadoc]Note:Customtagsthatwerenotseen:@todo

BUILDSUCCESSFUL

Total time: 11 seconds

Ant依次执行初始化,编译,测试,打包,生成API文档一系列任务,极大地提高了开发效率。将来开发J2EE项目时,还可加入部署等任务。并且,即使脱离了Eclipse环境,只要正确安装了Ant,配置好环境变量ANT_HOME=<Ant解压目录>,Path=…;%ANT_HOME%\bin,在命令行提示符下切换到Hello目录,简单地键入ant即可。