ant-常用任务(Task)

以下介绍几个常用的<target>任务标签的编写，有些主题与前面介绍重复的，则仅作提示。

   设定属性

当在编写build.xml时发现到有一些属性设定出现过两次以上，例如目录的指定，可以将这些属性使用<property>加以设定，以后若要改变属性设定，就只要改变对应的<property>即可，不必在build.xml中来回搜索与修改。例如：

<target name="setProperties"> 
    <property name="src.dir" value="src"/> 
    <property name="classes.dir" value="classes"/> 
    <property name="lib.dir" value="lib"/> 
    <property name="backup.dir" value="bak"/> 
    <property name="jar.file" value="${lib.dir}/JNameIt.jar"/> 
</target> 

属性设置在A.4节有较详细的介绍，这里不再重复说明。

   提供 help 信息

可以提供一些ant构建时的help信息。例如：

<target name="help" description="Type ant help for detail.">
    <echo message="Help information!!"/>
    <echo>Help! Help!</echo>
    <echo><![CDATA[  
       Here is a help info.
       Write your own information here.
       ]]></echo>
</target>

CDATA表示提供字符信息(Character Data)，在![CDATA["与"]]>之间的文字可以使用自由格式编写，适用于比较长的信息文字的显示。

style='font-family:宋体;KKKK:blue'>在执行ant时加上-projecthelp或-p就会自动显示help这个<target>上的内容。如果<target>上加有description属性，当使用ant -projecthelp时也会一并显示该信息。一个执行的例子如下：

C:\workspace\HelloWorld>ant -p
Buildfile: build.xml
 
Main targets:
 
 help  Type ant help for detail.
Default target: run

要显示详细信息，则需运行ant时指定help这个<target>。下面介绍如何显示详细信息：

C:\workspace\HelloWorld>ant help
Buildfile: build.xml
 
help:
     [echo] Help information!!
     [echo] Help! Help!
     [echo]
     [echo]        Here is a help info.
     [echo]        Write your own information here.
     [echo]
 
BUILD SUCCESSFUL
Total time: 0 seconds

   文件的复制、建立与删除

在每一次构建程序前，会备份前一次的构建结果，可以使用<copy>标签来指定要复制的文件。例如：

<target name="backup"> 
    <copy todir="${backup.dir}"> 
        <fileset dir="${classes.dir}"/> 
    </copy> 
</target> 

在构建程序时，可以使用<mkdir>标签建立一些必要的目录。例如：

<target name="prepareDir" 
         description="prepare necessary dirs"> 
    <mkdir dir="${classes.dir}"/> 
    <mkdir dir="${lib.dir}"/> 
    <mkdir dir="${backup.dir}"/> 
</target>

   编译程序

编译程序的任务当然是最常用的，还可以在编译程序时，加入一些Classpath的指定，这是一个相当方便的功能。例如：

<target name="compile" 
        description="compile the source files"> 
    <javac srcdir="./src" destdir="${classes.dir}"> 
        <classpath> 
            <fileset dir="${lib.dir}"> 
                <include name="**/*.jar"/> 
            </fileset> 
        </classpath> 
    </javac> 
</target>

A.5节中有更多有关路径设定的介绍，这里不再重复介绍。

   执行程序

<java>标签用来执行Java程序。例如：

<java classname="onlyfun.caterpillar.HelloWorld">

     <classpath path="."/>

</java>

   制作jar文件

可以使用<jar>标签将编译完成的文件打包为.jar文件(Java Archive File)，并可以指定MANIFEST文件。例如：

<target name="jar"> 
    <mkdir dir="${libDir}"/>
    <jar jarfile="${libDir}/${jarFile}"
         manifest="META-INF/MANIFEST.MF" 
         basedir="${lib.dir}"/> 
</target> 

如果提供有MANIFEST.MF文件，才需要设定manifest属性。为了完成jar打包的任务，可以在META-INF目录下提供一个MANIFEST.MF文件。例如：

MANIFEST.MF

Manifest-Version: 1.0

Created-By: caterpillar

Main-Class: onlyfun.caterpillar.HelloWorld

Class-Path: HelloWorld.jar

执行ant时可以指定任务与提供lib目录及jar文件的名称。例如：

C:\workspace\HelloWorld>ant jar -DlibDir=lib -DjarFile=HelloWorld.jar
Buildfile: build.xml
 
jar:
      [jar] Building jar: C:\workspace\HelloWorld\lib\HelloWorld.jar
 
BUILD SUCCESSFUL
Total time: 0 seconds

这里的设定所建立的jar由于包括Main-Class设定，而指定的类别中有main()，所以可以直接执行。例如：

C:\workspace\HelloWorld\lib>java -jar HelloWorld.jar
Hello Java!!

   制作war文件

对于网站应用程序的部署，可以使用<war>标签将所有相关的文件包装为war(Web Application Archive)文件。例如：

<target name="war">

    <war destfile="dist/guestbook.war"

         webxml="src/webapp/WEB-INF/web.xml">

        <classes dir="target/classes"/>

        <lib file="beantools.jar"/>

    </war>

</target>