Ant的使用

这些天刚上线一个项目，找了个机会温故一下ant的使用，也是为新手们提供一个学习ant的东西吧。

首先我会提供一个ant的模板，ant的默认文件是build.xml,我想刚开始接触web开发的新人们，也会很奇怪这个在项目根目录下的xml东西是干嘛用的。其实它就是大名鼎鼎的ant默认文件，部署和发布一个项目的最佳利器。下面就是我用的项目的一个实际应用模板：

<?xml version="1.0" encoding="UTF-8"?> <!-- name:对应工程的名字；default:需要的缺省任务(运行"ant"不指明任务时执行的任务) --> <project name="CDNManageSystem" default="dist" basedir="."> <!-- 建立目录结构 src JAVA源码编辑目录 lib jar包(类库)存放目录 bin 编译生成的class文件存放目录 dist war和javadoc存放目录 WebRoot jsp文件存放地方 config 配置文件存放地方 --> <property name="appName" value="CDNManageSystem"/> <property name="src.dir" value="src"/> <property name="lib.dir" value="WebRoot/WEB-INF/lib"/> <property name="dist.dir" value="dist"/> <property name="classes.dir" value="WebRoot/WEB-INF/classes"/> <property name="webapps.dir" value="C:/Tomcat6.0/webapps"/> <property name="webroot.dir" value="WebRoot"/> <property name="test.dir" value="testdist" /> <property name="www.dir" value="www" /> <property name="tomcat.home" value="C:/Tomcat6.0/"/> <!-- Compilation Classpath 路径设置 --> <path id="compile.classpath"> <pathelement location="${classes.dir}"/> <fileset dir="${lib.dir}" includes="**/*.jar" /> </path> <!-- Clean Target 删除先前的目录结构 --> <target name="clean" description="Delete old build and dist directories"> <delete dir="${classes.dir}"/> <delete dir="${dist.dir}/*.war"/> </target> <!-- Prepare Target 建立打包的目的目录结构 --> <target name="prepare"> <mkdir dir="${classes.dir}"/> <mkdir dir="${dist.dir}"/> <mkdir dir="${test.dir}"/> </target> <!-- Compile Target 编译代码，在这之前先由prepare建立目录结构 --> <target name="compile" depends="prepare" description="Compile java sources"> <!-- Compile java class as necessary --> <javac srcdir="${src.dir}" destdir="${classes.dir}" encoding="utf-8" debug="true" debuglevel="source,lines,vars" includeantruntime="on"> <classpath refid="compile.classpath"/> </javac> </target> <!-- Dist Target 将应用打包成线上环境使用的war--> <target name="dist" depends="clean,compile" description="create war file for the fomal envionment"> <copy todir="${classes.dir}"> <fileset dir="${www.dir}"> <exclude name="*.svn"/> <include name="**/*.xml"/> <include name="**/*.properties" /> </fileset> </copy> <jar jarfile="${dist.dir}/${appName}.war" basedir="${webroot.dir}"/> </target> <target name="testdist" depends="clean,compile" description="create war file for the test(10.5.22.99) envionment"> <copy todir="${classes.dir}"> <fileset dir="${src.dir}"> <exclude name="*.svn"/> <include name="**/*.xml"/> <include name="**/*.properties" /> </fileset> </copy> <jar jarfile="${test.dir}/${appName}.war" basedir="${webroot.dir}"/> </target> <target name="testdeploy" description="deploy test war to local tomcat"> <delete dir="${webapps.dir}/${appName}.war"/> <delete dir="${webapps.dir}/${appName}"/> <delete dir="${classes.dir}"/> <delete dir="${test.dir}"/> <mkdir dir="${classes.dir}"/> <mkdir dir="${test.dir}"/> <copy todir="${classes.dir}"> <fileset dir="${src.dir}"> <exclude name="*.svn"/> <include name="**/*.xml"/> <include name="**/*.properties" /> </fileset> </copy> <javac srcdir="${src.dir}" destdir="${classes.dir}" encoding="utf-8" debug="true" debuglevel="source,lines,vars"> <classpath refid="compile.classpath"/> </javac> <jar jarfile="${webapps.dir}/${appName}.war" basedir="${webroot.dir}"/> </target> <!--target name="test" depends="tomcat.stop,start-tomcat,testdeploy" description="deploy test war to tomcat and restart tomcat"> </target--> </project>

大家看了是不是有点害怕，其实并不用太担心，接下我就解释一下ant的关键元素以及最重要的ant的常用的方法：

1.Ant的关键元素

project：是Ant的根元素，每一个ant文件至少包含一个project元素。其中包含多个target

属性有name(项目名称），default(默认执行target名称）,basedir(用于指定基路径的位置,未指定时默认为ant文件的父目录 路径）

<project name="CDNManageSystem" default="dist" basedir=".">

target:它为ant的基本执行单元，包括一个或多个任务，特别多个target可以存在项目的依赖关系。

属性：name

depends

if

unless

description

<!-- Dist Target 将应用打包成线上环境使用的war--> <target name="dist" depends="clean,compile" description="create war file for the fomal envionment"> <copy todir="${classes.dir}"> <fileset dir="${www.dir}"> <exclude name="*.svn"/> <include name="**/*.xml"/> <include name="**/*.properties" /> </fileset> </copy> <jar jarfile="${dist.dir}/${appName}.war" basedir="${webroot.dir}"/> </target>

property:它可以看作参数和参数的定义，project的属性可以通过property来设定，如果要在外部引入某文件，例如build.properties，<property file="build.properties"/>,而且也可以作为task的属性值。

2.Ant的常用方法

在Ant文件里，每一个target都封装了要执行的功能。是ant工具的基本执行单位。

copy 任务：该任务主要是用对文件和目录的复制功能。

1）复制单个文件：<copy file="file.txt" tofile="copy.txt"/>;

2)对文件目录进行复制：

<copy todir="../newdir/dest_dir">

<fileset dir="src/src_dir"/>

</copy>

3)将文件复制到另为的目录:<copy file="file.txt" todir="../newdir/dest_dir"/>

delete 任务：该任务负责删除文件和目录

1）删除某个文件： <delete file="file.txt"/>

2)删除某个目录:<delete dir="src"/>

3)删除所有的备份目录和空目录：<delete includeEmptyDirs="true">

<fileset dir="." includes="**/*.bak"/>

</delete>

mkdir 任务：创建目录，<mkdir dir="build"/>

move 任务：移动文件或目录

1）移动单个文件: <move file="file.txt" tofile="tofile.txt"/>

2）移动单个文件到另一个目录：<move file="file.txt" todir="../newdir“/>

3）移动某个目录到另一个目录:<move todir="../newdir">

<fileset dir="build"/>

</move>

echo 任务：该任务根据日志和监控器级别输出信息。它包括：message，file，append和level四个属性

<echo message="hello,world" file="logging.log" append="true"/>

*利用ant构建和部署java工程

Ant可以代替javac java 和jar命令来执行java操作，从而轻松完成构建和部署java工程的工作。

<!-- Compile Target 编译代码，在这之前先由prepare建立目录结构 -->

<target name="compile" depends="prepare" description="Compile java sources">

<!-- Compile java class as necessary -->

<javac srcdir="${src.dir}" destdir="${classes.dir}" encoding="utf-8" debug="true" debuglevel="source,lines,vars" includeantruntime="on">

<classpath refid="compile.classpath"/>

</javac>

</target>

*使用ant的war任务来给java EE项目打包

<!-- Dist Target 将应用打包成线上环境使用的war-->

<target name="dist" depends="clean,compile" description="create war file for the fomal envionment">

<copy todir="${classes.dir}">

<fileset dir="${www.dir}">

<exclude name="*.svn"/>

<include name="**/*.xml"/>

<include name="**/*.properties" />

</fileset>

</copy>

<jar jarfile="${dist.dir}/${appName}.war" basedir="${webroot.dir}"/>

</target>