ant 使用

build.xml

<?xml version="1.0"?>
<project default="dist" name="test_ant">
	<property name="srcDir" location="src" />
	<property name="buildDir" location="build" />
	<property name="distDir" location="dist" />

	<target name="init">
		<tstamp />
		<mkdir dir="${buildDir}" />
		<mkdir dir="${distDir}" />
	</target>
	<target name="compile" depends="init">
		<javac srcdir="${srcDir}" destdir="${buildDir}" />
	</target>
	<target name="dist" depends="compile">
		<jar destfile="${distDir}/package-${DSTAMP}.jar" basedir="${buildDir}">
			<manifest>
				<attribute name="Built-By" value="${user.name}" />
				<attribute name="Main-Class" value="package.Main" />
			</manifest>
		</jar>
		<jar destfile="${distDir}/package-src-${DSTAMP}.jar" basedir="${srcDir}" />
	</target>
	<target name="clean">
		<delete dir="${buildDir}" />
		<delete dir="${distDir}" />
	</target>
</project>

一、Ant介绍

Ant是Java的生成工具，是Apache的核心项目；直接在apache官网下载即可；

Ant类似于Unix中的Make工具，都是用来编译、生成；

Ant是跨平台的，而Make不能；

Ant的主要目的就是把你想做的事情自动化，不用你手动一步一步做，因为里面内置了javac、java、创建目录、复制文件等功能，所以可以直接点击Ant文件，即可编译生成你的项目；

下载地址： http://ant.apache.org/bindownload.cgi   

二、Ant配置

在Ant安装之前需要安装好JDK，并配置好JAVA_HOME；

Ant配置：

1.新建环境变量ANT_HOME ：值为ANT的主目录；

2.在path中配置%ANT_HOME%/bin ；

配置完成之后，打开命令行，输入ant，当出现：

Buildfile: build.xml does not exist!
Build failed

时说明配置完成；

三、Ant入门

ant的默认生成文件为build.xml；输入ant后，ant会在当前目录下搜索是否有build.xml，如果有，则执行；当然也可以自定义生成文件，通过ant -f a.xml 即可指定a.xml为生成文件；

ant的生成文件是xml文件，整体结构为：

<?
xml
 
version
=
"1.0"
 
encoding
=
"GBK"
?>
<
project
 
default
=
" targetname"
>
    <
target
 
name
=
"name"
>
    </
target
>
</
project
>

project是生成文件的根元素，表示一个工程；

target是project的子元素，表示一个任务；一个project中可以定义多个target元素，表示多个任务；

default属性表示默认执行的target，如果ant命令没有指定target，则执行default的target；

ant targetname;则会执行此target，而忽略default设置的target；

注意：不能有两个相同的targetname；

代码举例：创建并删除hello目录；

<?
xml
 
version
=
"1.0"
 
encoding
=
"gbk"
?>
<
project
 
default
=
"delete"
>
    <
property
 
name
=
"name"
 
value
=
"xiazdong"
/>
    <
target
 
name
=
"delete"
 
depends
=
"mkdir"
>
        <
delete
 
dir
=
"${name}"
/>
    </
target
>
    <
target
 
name
=
"mkdir"
>
        <
mkdir
 
dir
=
"${name}"
/>
    </
target
>
</
project
>

四、Ant的XML元素详解

1.<project>元素

是Ant生成文件的根元素；一般形式如：

<project default="    "[ basedir="." ] [name="projectname"]>

default的值是默认执行的target名；

basedir是指定基准目录，一般都是basedir="."

name是指工程名字；

2.<target>元素

是project元素的子元素，在project元素中能够有多个target；一般形式如下：

<target name="    "  [ depends="  A  "]  [ if ="  prop1 "] [ unless=" prop2"]>

</target>

name表示target的名称；

depends中填写其他target名称(可以有多个名称，用逗号分割)，表示只有targetA完成之后才能够做此target，如果执行此target，则会先执行A；

if的值表示一个属性名，只有设置了该属性名，才能执行此target；

unless的值表示一个属性名，只有没有设置该属性名，才能执行此target；

3.<property>元素

是project的子元素 ；property用于定义属性，一般形如：

(1)<property name="  pname  "   value="  pvalue   "/>

如果要使用此property，则需要${pname}；类似于表达式语言；

(2)<property file="a.properties"/> 通过此属性文件导入属性；

如果单纯想使用$，则通过$$表示；

五、Task介绍

在Ant中Task是target的子元素，即一个target中可以有多个task；而Task分为：

(1)核心Task；

(2)可选Task；

(3)自定义Task；

下面介绍一些常用的核心Task；

1.<echo>

用于单纯输出，一般形如：

<echo>      </echo>

举例：<echo>hello</echo>

2.<javac>

用于编译java文件，一般形式如下：

<javac srcdir="  src   "       destdir="  class   "  [classpath="     "]/>；

srcdir是编译此文件夹下或子文件夹下的全部java文件;

destdir是编译后的class文件放置路径；

classpath指定第三方类库；

3.<java>

运行java类，一般形式如下：

<java classname="    " fork="yes ">

    【<arg line="param1   param2   param3"/>】

</java>

classname用于指定运行的类名称；

fork="yes"表示另起一个JVM来执行java命令，而不是中断ANT命令，因此fork必须为yes ；

4.<jar>

打包成jar包；一般形式如下：

<jar destfile="  main.jar" basedir="    ">

    <manifest>

        <attribute name="Main-Class"   value="classname"/>    <!--指定主类-->

    </manifest>

</jar>

destfiie的值为jar包的名称；一般为${dest}/main.jar ；

basedir的值是需要打成jar包的目录；一般为${classes}

manifest表示设置META-INF；

5.<mkdir>

创建目录，可以多层创建，比如a\b\c，则可以连续创建，一般形式如下：

<mkdir dir="a\b"/>

6.<delete>

删除目录，一般形式如下：

<delete dir="a\b"/> 可以删除a目录下的b目录；

<delete file="1.txt"/>可以删除文件；

7.<tstamp>

时间戳，一般形式如下：

<tstamp />

接下来可以使用${DSTAMP}进行调用当前时间；

8.<copy>

复制文件，一般形式如下：

<copy file="file1" tofile="file2"/>

file是源文件；

tofile是目标文件；

9.<move>

移动文件，一般形式如下：

<move file="file1" tofile="file2"/>

file是源文件；

tofile是目标文件；

10.<replace>

 用于替换字符串，类似于String的replace操作，一般形式如下：

<replace file="filename" token="old" value="new"/>

file表示要执行替换的文件；

token表示被替换的字符串；

value表示替换的字符串；

 

代码举例：一般项目中的ant结构

<
project
 
default
=
"init"
>
    <
property
 
name
=
"src"
 
value
=
"src"
/>
    <
property
 
name
=
"classes"
 
value
=
"classes"
/>
    <
property
 
name
=
"dest"
 
value
=
"dest"
/>
    <
path
 
id
=
"classpath"
>
        <
pathelement
 
path
=
"${classes}"
/>
    </
path
>
    <
target
 
name
=
"help"
>
        <
echo
>
help -打印帮助信息
</
echo
>
        <
echo
>
compile -编译java源文件
</
echo
>
        <
echo
>
run -运行程序
</
echo
>
        <
echo
>
build -打成jar包
</
echo
>
        <
echo
>
clean -清楚全部编译生成文件
</
echo
>
    </
target
>
    <
target
 
name
=
"compile"
>
        <
delete
 
dir
=
"${classes}"
/>
        <
mkdir
 
dir
=
"${classes}"
/>
        <
javac
 
srcdir
=
"${src}"
 
destdir
=
"${classes}"
/>
    </
target
>
    <
target
 
name
=
"run"
 
depends
=
"compile"
>
        <
java
 
classname
=
"org.xiazdong.Test"
 
fork
=
"yes"
>
            <
classpath
 
path
=
"${classes}"
/>
        </
java
>
    </
target
>
    <
target
 
name
=
"build"
 
depends
=
"run"
>
        <
delete
 
dir
=
"${dest}"
/>
        <
mkdir
 
dir
=
"${dest}"
/>
        <
jar
 
destfile
=
"${dest}/Test.jar"
 
basedir
=
"${classes}"
>
            <
manifest
>
                <
attribute
 
name
=
"Main-Class"
 
value
=
"org.xiazdong.Test"
/>
            </
manifest
>
        </
jar
>
    </
target
>
    <
target
 
name
=
"clean"
>
        <
delete
 
dir
=
"${classes}"
/>
        <
delete
 
dir
=
"${dest}"
/>
    </
target
>
</
project
>

 

总结一下：

<?
xml
 
version
 = 
"1.0"
 
encoding
=
"GBK"
?>
<
project
 
name
=
"Test"
 
default
=
""
 
basedir
=
"."
>
    <
property
 
name
=
"src"
 
value
=
"${basedir}\src"
/>
    <
property
 
file
=
"${basedir}\a.properties"
/>
    <!--
    path用法
        1.id属性表示编号，用于被引用
    -->
    <
path
 
id
=
"classpath"
>
    <!--
    pathelement的用法
        1.path表示多个目录，用“;”隔开目录
        2.location表示一个目录
    -->
        <
pathelement
 
path
=
"lib;src"
/>
        <
pathelement
 
location
=
"lib"
/>
    <!--
    dirset的用法
        1.dir属性指定根目录
        2.子元素<
include
 
name
=
"    "
/>
表示包含的目录
        3.子元素<
exclude
 
name
=
"    "
/>
表示不包含的目录
    -->
        <
dirset
 
dir
=
"lib"
>
            <
include
 
name
=
"**/*Test*"
/>
            <
exclude
 
name
=
"**/class"
/>
        </
dirset
>
    <!--
    filelist的用法
        1.dir属性指定根路径
        2.files属性指定文件名的列表，用","隔开
    -->
        <
filelist
 
dir
=
"lib"
 
files
=
"a.xml,b.xml"
/>
    <!--
    fileset用法
        1.dir属性指出根路径
        2.子元素<
include
 
name
=
"   "
/>
指定包含的文件名
    -->
        <
fileset
 
dir
=
"lib"
>
            <
include
 
name
=
"**/*.jar"
/>
        </
fileset
>
    </
path
>
    <!--
    target用法
        1.表示任务,子元素为各种task的集合;
    -->
    <
target
 
name
=
"target1"
>
    <!--
    javac用法
        1.srcdir表示java文件的目录
        2.destdir表示class文件的保存目录
    -->
        <
javac
 
srcdir
=
"src"
 
destdir
=
"bin"
>
    <!--
    classpath用法
        1.refid引用前面的path指定的路径
    -->
            <
classpath
 
refid
=
"classpath"
/>
        </
javac
>
    <!--
    java用法
        1.classname表示要运行的类
        2.fork
=
"yes"
一定要写上！！
    -->
        <
java
 
classname
=
"Test"
 
fork
=
"yes"
>
            <
classpath
 
refid
=
"classpath"
/>
    <!--
        arg表示指定的参数
    -->
            <
arg
 
value
=
"a b c"
/>
        </
java
>
    <!--
    echo表示输出
    -->
        <
echo
>
Hello world
</
echo
>
    <!--
    copy表示复制文件
    delete表示删除文件
    mkdir表示创建目录
    move表示移动文件
    -->
        <
copy
 
file
=
"src.txt"
 
tofile
=
"dest.txt"
/>
        <
delete
 
dir
=
"src"
/>
        <
mkdir
 
dir
=
"src"
/>
        <
move
 
file
=
"src.txt"
 
tofile
=
"dest.txt"
/>
    </
target
>
</
project
>

五、在Eclipse中使用Ant

在Eclipse中虽然没有内置创建Ant的生成文件，但是可以通过配置完成；

(1)点击  window-->preferences-->editors-->file associations;

(2)在File types中创建一个build.xml，并将associated editor的默认项设置为ant editor即可；

当在项目中创建一个build.xml时，这个文件就是ant的生成文件；

 

 

六、模式匹配

在Ant中有一些基本的模式匹配的功能，比如：

*表示任意字符串，**表示任意数量的目录；

(1)*.java，表示任意的java文件；

(2)*/*.java表示当前目录的任意java文件；

(3)**/*.java 表示当前目录结构下的任意java文件；

 

<fileset dir="   src  ">

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

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

    <exclude name="**/*Test*"/>

</fileset>

表示包含src目录下的所有java和txt文件，排除文件名包含Test的文件；

 

举例：将java文件拷贝到dest文件夹下；

<
copy
 
todir
=
"dest"
>
<
span
 
style
=
"white-space:pre"
>
    
</
span
>
<
fileset
 
dir
=
"."
>
<
span
 
style
=
"white-space:pre"
>
        
</
span
>
<
include
 
name
=
"**/*.java"
/>
<
span
 
style
=
"white-space:pre"
>
    
</
span
>
</
fileset
>
</
copy
>

七、自定义任务

 自定义任务类似于JSP中的自定义标签；

步骤：

(1)继承org.apache.tools.Task;

(2)覆写public void execute()throws BuildException;

(3)在类中添加的属性即为任务标签的属性；

(4)在build.xml中声明任务<taskdef name="   "   classname="    "   classpath="bin"/>

举例：复制文件；

package
 org.tools;

import
 java.io.BufferedReader;
import
 java.io.File;
import
 java.io.FileInputStream;
import
 java.io.FileWriter;
import
 java.io.IOException;
import
 java.io.InputStreamReader;
import
 java.io.PrintWriter;

import
 org.apache.tools.ant.BuildException;
import
 org.apache.tools.ant.Task;
public
 
class
 SimpleTask 
extends
 Task{
    private
 File file;
    private
 File tofile;
    public
 File getFile() {
        return
 file;
    }
    public
 
void
 setFile(File file) {
        this
.file = file;
    }
    public
 File getTofile() {
        return
 tofile;
    }
    public
 
void
 setTofile(File tofile) {
        this
.tofile = tofile;
    }
    @Override
    public
 
void
 execute() 
throws
 BuildException {
        try
 {
            PrintWriter out = new
 PrintWriter(
new
 FileWriter(tofile));
            BufferedReader in = new
 BufferedReader(
new
 InputStreamReader(
new
 FileInputStream(file)));
            String line = null
;
            while
((line=in.readLine())!=
null
){
                out.println(line);
            }
            out.close();
            in.close();
        } catch
 (IOException e) {
            e.printStackTrace();
        }

    }

}

build.xml

<
taskdef
 
name
=
"MyCopy"
 
classname
=
"org.tools.SimpleTask"
 
classpath
=
"bin"
>
</
taskdef
>
    <
target
 
name
=
"mycopy"
>
        <
MyCopy
 
file
=
"2.txt"
 
tofile
=
"output.txt"
/>
    </
target
>