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>