Ant脚本的使用

程序猿在coding

于 2014-03-14 00:31:10 发布

阅读量2.7k

点赞数 1

分类专栏： ant 文章标签： ant

ant 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

一,什么时候使用ant
也许你听到别人说起ant，一时冲动准备学习一下ant，当你看完了上边的第一个实例，也许你感觉ant真好，也许你感觉ant不过如此，得出这些结论都不能说错，虽然ant很好用，
但并不是在任何情况下都是最好的选择，例如windows上有更多更简单，更容易使用的工具，比如eclipse+myeclipse eclipse+wtp等等，无论是编译，部署，运行使用起来比ant更
容易，方便但有些情况则是ant发挥的好地方：
1,服务器上部署的时候
当你的程序开发完成，部署人员要部署在服务器上的时候，总不能因为安装一个程序就配置一个eclipse+myeclipse吧，ant在这个时候是个很好的选择，因为它小巧，容易配
置，你带着你写好的build.xml到任何一台服务器上，只需要做简单的修改（一些设定，例如目录），然后一两个命令完成，这难道不是一件美好的事情吗。
2,linux上，很多时候是这样的，程序开发是在windows下，但是程序要在linux或者unix上运行，在linux或者
在unix(特别是unix上)部署是个麻烦的事情，这个时候ant的特点又出来了，因为ant是跨平台的，你在build.xml可以在大多数操作系统上使用，基本不需要修改。
3,当服务器维护者不懂编程的时候
很多人都有过这样的经历，使用你们程序的人，并不懂得写程序。你得程序因为版本更新，因为修正bug需要一次又一次得重新部署。这个时候你会发现教一个人是如此得困难。但
是有ant后，你只需要告诉他，输入ant xxx等一两个命令，一切ok.
以上是我遇到得一些情况。
看完以上得情况，好好考虑一下，你是否需要使用ant，如果是继续。

进一步学习一个稍微复杂一点点的ant
在实际的工作过程中可能会出现以下一些情况，一个项目分成很多个模块，每个小组或者部门负责一个模块，为了测试，他们自己写了一个build.xml,而你负责把这些模块组合到
一起使用，写一个build.xml
这个时候你有两种选择：
1,自己重新写一个build.xml ，这将是一个麻烦的事情
2,尽量利用他们已经写好的build.xml，减少自己的工作
举个例子：
假设你下边有三个小组，每个小组负责一个部分，他们分别有一个src 和一个写好的build.xml
这个时候你拿到他们的src，你需要做的是建立三个文件夹src1 ,src2, src3分别把他们的src和build.xml放进去，然后写一个build.xml
<?xml version="1.0" encoding="UTF-8" ?>
<project name="main" default="build" basedir=".">
<property name="bin" value="${basedir}\bin" />
<property name="src1" value="${basedir}\src1" />
<property name="src2" value="${basedir}\src2" />
<property name="src3" value="${basedir}\src3" />
<target name="init">
  <mkdir dir="${bin}" />
</target>
<target name="run">
  <ant dir="${src1}" target="run" />
  <ant dir="${src2}" target="run" />
  <ant dir="${src3}" target="run" />
</target>
<target name="clean">
  <ant dir="${src1}" target="clean" />
  <ant dir="${src2}" target="clean" />
  <ant dir="${src3}" target="clean" />
</target>
<target name="build" depends="init,call">
  <copy todir="${bin}">
   <fileset dir="${src1}">
    <include name="*.jar" />
   </fileset>
   <fileset dir="${src2}">
    <include name="*.jar" />
   </fileset>
   <fileset dir="${src3}">
    <include name="*.jar" />
   </fileset>
  </copy>
</target>
<target name="rebuild" depends="build,clean">
  <ant target="clean" />
  <ant target="build" />
</target>
</project>
ok你的任务完成了。

ok,上边你完成了任务，但是你是否有些感触呢，在那些build.xml中，大多数是重复的，而且更改一次目录需要更改不少东西。是否能让工作做的更好一点呢，答案是肯定的。
引入两个东西：
1,propery
2,xml include
这两个东西都有一个功能，就是能把build.xml中<propery />中的内容分离出来，共同使用
除此之外它们各有特点：
propery的特点是维护简单，只需要简单的键值对，因为并不是所有人都喜欢xml的格式
xml include的特点是不单可以提取出属性来，连target也可以。
还是以前的例子：
例如我们想把src1 src2 src3这三个属性从xml中提出来，可以新建一个文件叫all.properties
里边的内容
src1=D:\\study\\ant\\src1
src2=D:\\study\\ant\\src2
src3=D:\\study\\ant\\src3
然后你的build.xml文件可以这样写，别人只需要更改配置文件，而不许要更改你的build.xml文件了
<?xml version="1.0" encoding="UTF-8" ?>
<project name="main" default="build" basedir=".">
<property file="all.properties" />
<property name="bin" value="${basedir}\bin" />
<target name="init">
  <mkdir dir="${bin}" />
</target>
<target name="run">
  <ant dir="${src1}" target="run" />
  <ant dir="${src2}" target="run" />
  <ant dir="${src3}" target="run" />
</target>
<target name="clean">
  <ant dir="${src1}" target="clean" />
  <ant dir="${src2}" target="clean" />
  <ant dir="${src3}" target="clean" />
</target>
<target name="build" depends="init,call">
  <copy todir="${bin}">
   <fileset dir="${src1}">
    <include name="*.jar" />
   </fileset>
   <fileset dir="${src2}">
    <include name="*.jar" />
   </fileset>
   <fileset dir="${src3}">
    <include name="*.jar" />
   </fileset>
  </copy>
</target>
<target name="rebuild" depends="build,clean">
  <ant target="clean" />
  <ant target="build" />
</target>
<target name="test">
  <ant dir="${src1}" target="test" />
  <ant dir="${src2}" target="test" />
  <ant dir="${src3}" target="test" />
</target>
</project>
如果你自己看的话你会看到这样一个target
<target name="test">
<ant dir="${src1}" target="test" />
<ant dir="${src2}" target="test" />
<ant dir="${src3}" target="test" />
</target>
有的时候你想给每个小组的build.xml加入几个target，一种做法是每个里边写，然后在这里调用
但是有一种更好的方法。
你可以写一个include.xml文件，内容如下
<?xml version="1.0" encoding="UTF-8" ?>
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<target name="test" >
<ant target="run" />
</target>
然后更改你三个小组的build.xml文件,每个里边加入如下内容

<!DOCTYPE project [
<!ENTITY share-variable SYSTEM "file:../include.xml">
]>
&share-variable;
变成如下的样子
这个时候，你只要在include.xml添加propery , 添加target，三个build.xml会同时添加这些propery和target
而且不会让三个组的build.xml变得更复杂。
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE project [
<!ENTITY share-variable SYSTEM "file:../include.xml">
]>
<project name="HelloWorld" default="run" basedir=".">

&share-variable;


<property name="hello_jar" value="hello1.jar"/>

<target name="init">
  <mkdir dir="${dest}"/>
</target>
<target name="compile" depends="init">
  <javac srcdir="${src}" destdir="${dest}"/>
</target>
<target name="build" depends="compile">
  <jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
<target name="run" depends="build">
  <java classname="test.ant.HelloWorld" classpath="${hello_jar}"/>
</target>
<target name="clean">
  <delete dir="${dest}" />
  <delete file="${hello_jar}" />
</target>
<target name="rerun" depends="clean,run">
  <ant target="clean" />
  <ant target="run" />
</target>
</project>

掌握了上边的那些内容之后，你就知道如何去写一个好的ant，但是你会发现当你真的想去做的时候，你不能马上作出好的build.xml，因为你知道太少的ant的默认提供的命令.这
个时候如果你想完成任务，并提高自己，有很多办法：
1,很多开源的程序都带有build.xml，看看它们如何写的
2,ant的document，里边详细列写了ant的各种默认命令，及其丰富
3,google，永远不要忘记它
ok,在这之后随着你写的ant build越来越多，你知道的命令就越多，ant在你的手里也就越来越强大了。
这个是一个慢慢积累的过程。

ant的例子很好找，各种开源框架都会带有一个build.xml仔细看看，会有很大收获
另外一个经常会用到的，但是在开源框架的build.xml一般没有的是cvs
如果使用的是远程的cvs，可以这样使用
<xml version="1.0" encoding="utf-8"?>
<project>
     <property name="cvsroot" value=":pserver:wang:@192.168.1.2:/cvsroot"/>
     <property name="basedir" value="/tmp/testant/"/>
     <property name="cvs.password" value="wang"/>
     <property name="cvs.passfile" value="${basedir}/ant.cvspass"/>
     <target name="initpass">
             <cvspass cvsroot="${cvsroot}" password="${cvs.password}" passfile="${cvs.passfile}"/>
     </target>
     <target name="checkout" depends="initpass">
             <cvs cvsroot="${cvsroot}" command="checkout" cvsrsh="ssh" package="myproject" dest="${basedir}"
              passfile="${cvs.passfile}"/>
      </target>
</project>

在eclipse里边先天支持ant，所以你可以在eclipse里边直接写build.xml
因为eclipse提供了提示功能，自动补充功能，它能让你事半功倍。
使用方法，只需要建立一个工程，然后建立一个叫build.xml的文件。然后就可以在里边写你的ant build了
但是时刻记住http://www.apache.org/永远能找到你需要的东西

2.1 在你运行Ant之前需要做一些配置工作。
? 将bin目录加入PATH环境变量。
? 设定ANT_HOME环境变量，指向你安装Ant的目录。在一些OS上，Ant的脚本可以猜测ANT_HOME（Unix和Windos NT/2000）－但最好不要依赖这一特性。
? 可选地，设定JAVA_HOME环境变量（参考下面的高级小节），该变量应该指向你安装JDK的目录。
注意：不要将Ant的ant.jar文件放到JDK/JRE的lib/ext目录下。Ant是个应用程序，而lib/ext目录是为JDK扩展使用的（如JCE，JSSE扩展）。而且通过扩展装入的类会有安全方面的限制。
2.2 运行Ant

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

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

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

命令行选项总结：
ant [options] [target [target2 [target3] ...]]
Options:
-help print this message
-projecthelp print project help information
-version print the version information and exit
-quiet be extra quiet
-verbose be extra verbose
-debug print debugging information
-emacs produce logging information without adornments
-logfile file use given file for log output
-logger classname the class that is to perform logging
-listener classname add an instance of class as a project listener
-buildfile file use specified buildfile
-find file search for buildfile towards the root of the filesystem and use the first one found
-Dproperty=value set property to value
例子
ant
使用当前目录下的build.xml运行Ant，执行缺省的target。
ant -buildfile test.xml
使用当前目录下的test.xml运行Ant，执行缺省的target。
ant -buildfile test.xml dist
使用当前目录下的test.xml运行Ant，执行一个叫做dist的target。
ant -buildfile test.xml -Dbuild=build/classes dist
使用当前目录下的test.xml运行Ant，执行一个叫做dist的target，并设定build属性的值为build/classes。

3 编写build.xml

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

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

3.1 Projects

project有下面的属性：
Attribute Description Required
name 项目名称. No
default 当没有指定target时使用的缺省target Yes
basedir 用于计算所有其他路径的基路径。该属性可以被basedir property覆盖。当覆盖时，该属性被忽略。如果属性和basedir property都没有设定，就使用buildfile文件的父目录。 No
项目的描述以一个顶级的<description>元素的形式出现（参看description小节）。

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

3.2 Targets

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

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

Ant会依照depends属性中target出现的顺序（从左到右）依次执行每个target。然而，要记住的是只要某个target依赖于一个target，后者就会被先执行。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
假定我们要执行target D。从它的依赖属性来看，你可能认为先执行C，然后B，最后A被执行。错了，C依赖于B，B依赖于A，所以先执行A，然后B，然后C，最后D被执行。

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

如果（或如果不）某些属性被设定，才执行某个target。这样，允许根据系统的状态（java version, OS, 命令行属性定义等等）来更好地控制build的过程。要想让一个target这样做，你就应该在target元素中，加入if（或unless）属性，带上target因该有所判断的属性。例如：
<target name="build-module-A" if="module-A-present"/>
<target name="build-own-fake-module-A" unless="module-A-present"/>
如果没有if或unless属性，target总会被执行。

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

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

target有下面的属性：
Attribute Description Required
name target的名字 Yes
depends 用逗号分隔的target的名字列表，也就是依赖表。 No
if 执行target所需要设定的属性名。 No
unless 执行target需要清除设定的属性名。 No
description 关于target功能的简短描述。 No

3.3 Tasks

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

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

下面是Task的一般构造形式：
<name attribute1="value1" attribute2="value2" ... />
这里name是task的名字，attributeN是属性名，valueN是属性值。

有一套内置的（built-in）task，以及一些可选task，但你也可以编写自己的task。

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

可以给task赋一个id属性：
<taskname id="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.4 Properties

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

内置属性

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

要想得到系统属性的列表可参考the Javadoc of System.getProperties。

除了Java的系统属性，Ant还定义了一些自己的内置属性：
basedir project基目录的绝对路径 (与<project>的basedir属性一样)。
ant.file buildfile的绝对路径。
ant.version Ant的版本。
ant.project.name 当前执行的project的名字；由<project>的name属性设定.
ant.java.version Ant检测到的JVM的版本；目前的值有"1.1", "1.2", "1.3" and "1.4".

例子
<project name="MyProject" default="dist" basedir=".">

<property name="src" value="."/>
<property name="build" value="build"/>
<property name="dist" value="dist"/>

<target name="init">

<tstamp/>

<mkdir dir="${build}"/>
</target>

<target name="compile" depends="init">

<javac srcdir="${src}" destdir="${build}"/>
</target>

</project>

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

当需要指定类似路径的值时，可以使用嵌套元素。一般的形式是
<classpath>
<pathelement path="${classpath}"/>
<pathelement location="lib/helper.jar"/>
</classpath>
location属性指定了相对于project基目录的一个文件和目录，而path属性接受逗号或分号分隔的一个位置列表。path属性一般用作预定义的路径－－其他情况下，应该用多个location属性。

为简洁起见，classpath标签支持自己的path和location属性。所以：
<classpath>
<pathelement path="${classpath}"/>
</classpath>
可以被简写作：
<classpath path="${classpath}"/>
也可通过<fileset>元素指定路径。构成一个fileset的多个文件加入path-like structure的顺序是未定的。
<classpath>
<pathelement path="${classpath}"/>
<fileset dir="lib">
<include name="**/*.jar"/>
</fileset>
<pathelement location="classes"/>
</classpath>
上面的例子构造了一个路径值包括：${classpath}的路径，跟着lib目录下的所有jar文件，接着是classes目录。

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

path-like structure可能包括对另一个path-like structurede的引用（通过嵌套<path>元素）：
<path id="base.path">
<pathelement path="${classpath}"/>
<fileset dir="lib">
<include name="**/*.jar"/>
</fileset>
<pathelement location="classes"/>
</path>
<path id="tests.path">
<path refid="base.path"/>
<pathelement location="testclasses"/>
</path>
前面所提的关于<classpath>的简洁写法对于<path>也是有效的，如：
<path id="tests.path">
<path refid="base.path"/>
<pathelement location="testclasses"/>
</path>
可写成：
<path id="base.path" path="${classpath}"/>
命令行变量

有些task可接受参数，并将其传递给另一个进程。为了能在变量中包含空格字符，可使用嵌套的arg元素。
Attribute Description Required
value 一个命令行变量；可包含空格字符。只能用一个
line 空格分隔的命令行变量列表。
file 作为命令行变量的文件名；会被文件的绝对名替代。
path 一个作为单个命令行变量的path-like的字符串；或作为分隔符，Ant会将其转变为特定平台的分隔符。

例子
<arg value="-l -a"/>
是一个含有空格的单个的命令行变量。
<arg line="-l -a"/>
是两个空格分隔的命令行变量。
<arg path="/dir;/dir2:\dir3"/>
是一个命令行变量，其值在DOS系统上为\dir;\dir2;\dir3；在Unix系统上为/dir:/dir2:/dir3 。

References

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

下面的例子：
<project ... >
<target ... >
<rmic ...>
<classpath>
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</classpath>
</rmic>
</target>
<target ... >
<javac ...>
<classpath>
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</classpath>
</javac>
</target>
</project>
可以写成如下形式：
<project ... >
<path id="project.class.path">
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</path>
<target ... >
<rmic ...>
<classpath refid="project.class.path"/>
</rmic>
</target>
<target ... >
<javac ...>
<classpath refid="project.class.path"/>
</javac>
</target>
</project>
所有使用PatternSets, FileSets 或 path-like structures嵌套元素的task也接受这种类型的引用。

4.1 File（Directory）类
4.1.1 Mkdir
n 创建一个目录，如果他的父目录不存在，也会被同时创建。
n 例子：
<mkdir dir="build/classes"/>
n 说明：如果build不存在，也会被同时创建
4.1.2 Copy
n 拷贝一个（组）文件、目录
n 例子：
1. 拷贝单个的文件：
<copy file="myfile.txt" tofile="mycopy.txt"/>
2. 拷贝单个的文件到指定目录下
<copy file="myfile.txt" todir="../some/other/dir"/>
3. 拷贝一个目录到另外一个目录下
  <copy todir="../new/dir">
    <fileset dir="src_dir"/>
  </copy>
4. 拷贝一批文件到指定目录下
  <copy todir="../dest/dir">
    <fileset dir="src_dir">
      <exclude name="**/*.java"/>
    </fileset>
  </copy>

  <copy todir="../dest/dir">
    <fileset dir="src_dir" excludes="**/*.java"/>
  </copy>
5. 拷贝一批文件到指定目录下，将文件名后增加。Bak后缀
  <copy todir="../backup/dir">
    <fileset dir="src_dir"/>
    <mapper type="glob" from="*" to="*.bak"/>
  </copy>
6. 拷贝一组文件到指定目录下，替换其中的@标签@内容
  <copy todir="../backup/dir">
    <fileset dir="src_dir"/>
    <filterset>
      <filter token="TITLE" value="Foo Bar"/>
    </filterset>
  </copy>
4.1.3 Delete
n 删除一个（组）文件或者目录
n 例子
1. 删除一个文件
<delete file="/lib/ant.jar"/>
2. 删除指定目录及其子目录
  <delete dir="lib"/>
3. 删除指定的一组文件
  <delete>
    <fileset dir="." includes="**/*.bak"/>
  </delete>
4. 删除指定目录及其子目录，包括他自己
  <delete includeEmptyDirs="true">
    <fileset dir="build"/>
  </delete>
4.1.4 Move
n 移动或重命名一个（组）文件、目录
n 例子：
1. 移动或重命名一个文件
<move file="file.orig" tofile="file.moved"/>
2. 移动或重命名一个文件到另一个文件夹下面
<move file="file.orig" todir="dir/to/move/to"/>
3. 将一个目录移到另外一个目录下
<move todir="new/dir/to/move/to">
<fileset dir="src/dir"/>
</move>
4. 将一组文件移动到另外的目录下
<move todir="some/new/dir">
<fileset dir="my/src/dir">
<include name="**/*.jar"/>
<exclude name="**/ant.jar"/>
</fileset>
</move>
5. 移动文件过程中增加。Bak后缀
<move todir="my/src/dir">
<fileset dir="my/src/dir">
<exclude name="**/*.bak"/>
</fileset>
<mapper type="glob" from="*" to="*.bak"/>
</move>

前言

　　ant是java开发者工具箱的重要一环，junit,xdoclet等都与它紧密关联，程序员可能习惯了IDE提供的自动构建，甚至部署的功能，从而忽略了ant本身，其实，主流的IDE通常是内置ant任务来完成这些工作的，熟悉ant内在的机理，可以阅读或简单修改build.xml无疑可以帮助你更灵活地集成、管理应用项目,如果需要学习maven这种开源项目管理解决方案，也是要以理解ant为基础的哟。另外，使用ant的过程实际上对构建进行了文档化，它是无关于IDE的，想象一下，你的同事中可能三分之一在用JbuilderX,三分之一用eclipse，还有一些是别的。

　　本人使用eclipse3.0.1，以前的构建和发布工作都由myeclipse插件作了，趁周末实践了一下手动构建，记此备忘。

实践

　　准备工作：这是我的个人习惯，把所有公用的类库jar置于一个固定目录，分好类，不要丢在一个文件夹下，如jakarta-commons、hibernate、spring、struts等，这些是源码构建时需要用到的，在部署时可能有一些不用再打进去了，比如servlet.jar。如果你们有自己的framework,也一并放在这里。然后，打开eclipse,进入Windows-＞Preferences-＞Java-＞User Libraries,增加一个自己的库，比如说mylib,把刚才那些公共的jar全部添入，这样有个好处，在eclipse项目中，不用再看到烦人的长长的jar列表了，比较整洁。

　　下来正式进行：

　　1.新建一个Java Project，此时就不要再选你的j2ee插件内置的一些选项了，至简即可。

　　2.在root下建几个文件夹，我们在网上下载的开源项目中经常可以看到这些，比如：

　　src - 源码
　　classes - 编译
　　web - jsp等
　　lib - 库,这里可以简单地把mylib下的东东copy过来，便于将来发布源码。
　　dlist - 输出的jar或war

　　当然，我们要建一个build.xml，eclipse中会出现一个蚂蚁的小图标，一般这个文件建立后，下一个项目简单的copy过去，稍加改动就可以了。

　　3.打开项目的属性页，在Java Build Path的库选项中，加入我们自定义的公共库mylib.至于Builders方式就不用改了，使用默认的Java Builer即可，我只是项目部署时使用ant，平常的排错工作就交给IDE吧。

　　4.重中之重，写你的build.xml，网上文章很海，我这里就不再啰嗦了，基本上就分那几个任务：

　　4.1 先要声明一些路径变量，如

　　＜property name="war.dir" value="dlist" /＞

　　也可以将其写至properties文件中，在这里引用;

　　4.2 声明编译的类路径，如下:

　　＜path id="master-classpath"＞
　　＜fileset dir="${lib.root}/struts"＞
　　＜include name="struts-menu-2.3.jar" /＞
　　＜include name="struts.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/jakarta-commons"＞
　　＜include name="commons-*.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/ibatis2.0.9"＞
　　＜include name="ibatis-*.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/jdbcdriver"＞
　　＜include name="jtds-0.9-rc2.jar" /＞
　　＜/fileset＞s
　　......
　　＜/path＞

　　4.3 清空输出目录，如web,dlist等。

　　4.4 编译构建:

　　＜target name="build" description="Compile main source tree java files into class files, generate jar files"＞

　　＜mkdir dir="${build.dir}" /＞

　　＜javac destdir="${build.dir}" source="1.3" target="1.3" debug="true" deprecation="false" optimize="false" failοnerrοr="true"＞
　　＜src path="${src.dir}" /＞
　　＜classpath refid="master-classpath" /＞
　　＜/javac＞

　　＜copy todir="${build.dir}" preservelastmodified="true"＞
　　＜fileset dir="${src.dir}"＞
　　＜include name="**/*.xml" /＞
　　＜include name="**/*.properties" /＞
　　＜/fileset＞
　　＜/copy＞
　　＜!-- ============================================= --＞
　　＜!-- 据测试，资源文件不能被打到jar文件中，其余均可 --＞
　　＜!-- ============================================= --＞
　　＜copy todir="${webclasses.dir}/conf" preservelastmodified="true"＞
　　＜fileset dir="${src.dir}/conf"＞
　　＜include name="springResources*.properties" /＞
　　＜/fileset＞
　　＜/copy＞

　　＜mkdir dir="${weblib.dir}" /＞

　　＜jar jarfile="${weblib.dir}/${name}.jar" compress="true"＞
　　＜fileset dir="${build.dir}"＞
　　＜include name="**" /＞
　　＜/fileset＞
　　＜/jar＞

　　＜copy todir="${weblib.dir}" preservelastmodified="true"＞

　　＜fileset dir="${lib.root}"＞
　　＜include name="log4j-1.2.8.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/struts"＞
　　＜include name="struts-menu-2.3.jar" /＞
　　＜include name="struts.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/jakarta-commons"＞
　　＜include name="commons-*.jar" /＞
　　＜/fileset＞
　　＜fileset dir="${lib.root}/spring-1.1.3"＞
　　＜include name="spring.jar" /＞
　　＜include name="aopalliance.jar" /＞
　　＜/fileset＞
　　......

　　＜/copy＞

　　＜/target＞

　　＜!-- ============================================= --＞
　　＜!-- Compile main Java sources and copy libraries --＞
　　＜!-- ============================================= --＞
　　＜target name="warfile" description="Build the web application archive"＞

　　＜mkdir dir="${dist.dir}" /＞
　　＜war warfile="${dist.dir}/${name}.war" basedir="${war.dir}" webxml="${war.dir}/WEB-INF/web.xml"＞
　　＜include name="*" /＞
　　＜include name="WEB-INF/*.*" /＞
　　＜exclude name="WEB-INF/web.xml" /＞
　　＜include name="WEB-INF/classes/*.*" /＞
　　＜include name="WEB-INF/lib/**" /＞
　　＜exclude name="**/.*" /＞
　　＜/war＞

　　＜/target＞

　　4.5 打成war

　　＜target name="warfile" description="Build the web application archive"＞

　　＜mkdir dir="${dist.dir}" /＞
　　＜war warfile="${dist.dir}/${name}.war" basedir="${war.dir}" webxml="${war.dir}/WEB-INF/web.xml"＞
　　＜include name="*" /＞
　　＜include name="WEB-INF/*.*" /＞
　　＜exclude name="WEB-INF/web.xml" /＞
　　＜include name="WEB-INF/classes/*.*" /＞
　　＜include name="WEB-INF/lib/**" /＞
　　＜exclude name="**/.*" /＞
　　＜/war＞

　　＜/target＞

　　4.6 把几个任务串起来，弄一个default target

　　＜target name="all"＞
　　＜antcall target="clean" /＞
　　＜antcall target="build" /＞
　　＜antcall target="warfile" /＞
　　＜/target＞

　　打完收功。在实践中发现，一些配置文件，如struts-config.xml ibatis和spring的xml都可以打进jar文件，spring资源文件好象不行，得单独copy至WEB-INFclasses下，另外，你的web文件夹下，事先得放好web.xml，以及一些tld文件哟

本文主要介绍 Ant 在多用户开发的情况下，如何用 Eclipse，并且根据不同的目标环境编译不同的部署包。文中首先介绍一个场景，给出在开发、编译、部署过程中遇到的问题；然后介绍如何用 Eclipse 来简化你的 Ant 开发过程；文章的最后解释如何通过编写有效的 Ant 脚本来提高你的工作效率。

读者定位为具有 Java 和 Ant 使用经验的开发人员。

读者可以学习到如何使用 Ant 解决一些多用户开发环境中，根据不同的目标环境编译成不同部署包的问题。

工作场景

现在有一个 web 项目，是多人进行开发的，通过 CVS 来管理。另外该项目还有一些测试人员，他们测试部署在测试服务器上的应用程序，发现 bug 后通过 bug 管理系统通知开发人员，在开发人员修复 bug 并经过本地测试后，由专门的人负责检出（check out）代码，编译打包后部署到测试服务器上。

该项目的成员小A就是负责检出代码、编译打包，并部署到服务器上的人。除了这个任务之外，他还是该项目的编程人员。在项目进入测试阶段后，小A在得到组中别的成员修复了 bug 并且检入（check in）了代码的消息后（也有可能是小A自己检入了代码），小A首先更新本地的代码，先在本地做测试，确认修复了 bug 后打成 WAR 包部署到测试服务器上，并通知测试人员已经修复了 bug，让测试人员继续进行测试。

小A的烦恼

在该项目中，有一些为测试方便开发而写的代码和页面，比如跳过用户认证，但是在部署到测试机环境的时候，需要删除这些代码和页面；另外作为一个具有灵活性和扩展性的应用程序，又有一些配置文件，配置文件中的值会根据环境的改变而变动。例如，在项目中使用了 Log4j 记录日志，需要给 Log4j 指定日志文件的保存路径，本地程序员开发的时候用的是 Windows 系统，给 Log4j 指定的也是 Windows 的文件系统，在测试阶段的时候，需要部署到 Linux 系统中，那么日志的保存路径也需要做相应的改动。部署到测试服务器上的时候，除了 Log4j 需要改之外，还有很多别的配置项目也需要变动，并且分散在各个 package 中。小A的烦恼也随之而来，每次他在做完本地测之后，就根据测试机的需要逐个找配置文件，更改相应的值，并删除那些为测试方便写的代码和页面，每天可能根据需要做好几次这样的事情，最烦的是他在快做完对测试机环境更改的时候，某开发人员突然通知小A说：“我又改了一点代码，刚检入，你再重打一个包吧。”，小A又不得不从头开始做新一轮的检出代码、本地测试、更改配置文件、删除不需要的文件、打包部署的工作。另外小A在测试阶段的后期被通知要求除了每次生成一个测试环境的 WAR 包外还必须生成一个在产品环境下的 WAR 包，他做的事情就更多了。

从上面的场景可以看出，小A的工作效率低而且容易出错，甚至有可能导致整个项目的工作效率低下。其实可以通过 Ant 来帮助小A快速而且有效地完成这个工作。在 Ant 中，根据目标环境的需要，可以把所有要更改的配置文件的项目集中写到某个配置文件中。这样根据不同的目标环境得到不同的配置文件，Ant 在编译包时根据不同的目标环境切换不同的配置文件即可。比如小A现在碰到的有 3 中环境：开发环境、测试环境以及产品环境，根据这三种环境可以生成三个不同的配置文件：develop_deploy.property、test_deploy. property和product_deploy. property，当小A想生成不同的包时只需在这三个配置文件之间切换就可以了。

在正式开始编写脚本之前，我们需要下载安装相应的软件。

· Eclipse：为了使 Ant 的开发更加简单，我们选择了 Eclipse3.1 作为开发环境。当然你可以使用任何你喜欢的文本编辑工具来开发你的 Ant。Eclipse 的最新版本可以在 http://eclipse.org/ 上下载。

· Ant：Ant 是基于 Java 的编译工具，它就像 C/C++ 中的 make，但是没有 make 那样难用。Ant 的最新版本可以在 http://ant.apache.org/bindownload.cgi 上下载。如果你用 Eclipse 来开发 Ant，则不用去单独下载 Ant，因为在 Eclipse 中已经集成了 Ant。

· CVS 客户端（cvs.exe）：CVS 可以在 http://www.nongnu.org/cvs/ 上下载

回页首

用 Eclipse3.1 来创建 Ant 脚本

如果你使用 Eclipse 来编写 Ant，建议使用 Eclipse 3.1 以后的版本。除了以前 Ant 编辑器提供的语法高亮，提示语法错误等功能外，Eclipse3.1 版本增加了许多新的功能。比如：脚本代码的折叠；快速定位某属性或者目标（target）段的定义；在同一 builder 文件中重构属性名和目标名（快捷方式Alt + Shift +R）；调试 Ant 脚本等。

下面我们就来看看 Eclipse 3.1 中对 Ant 的支持

· 打开“File”－“New”－“Project”－“Simple”－“Project”，点击“Next”，输入工程名“Ant”，然后点击直到“Finish”

· 在新建的 Ant 工程中，新建 Test.xml，并且拷贝下面的脚本。该段脚本的内容就不做介绍了，我们主要看 Eclipse 提供了哪些功能。注意这时候打开的并不是 Ant 编辑器，将内容拷贝进去之后，关掉打开的“Test.xml”，然后再重新打开它，这样 Eclipse 就会用 Ant 编辑器打开它，并且也语法高亮了。

<?xml version="1.0" encoding="UTF-8"?> <project name="Test" default="init" basedir="."> <property name="test" value="test"/> <target name="init"> <echo>${test}</echo> </target> </project>

· 自动提示和代码折叠功能。如果是 Ant 内置的命令或者前面已经定义的变量，编辑器会自动提示；编辑器右边的加/减号可以代码折叠。如下所示：

· 快速定位目标（target）或者定义变量处。在上图中，将鼠标移至 default=”init” 中的 init 上之后，按下 ctrl 键，鼠标变成手状，单击就可以定位到定义该目标的地方

· 快速重构目标名或者属性名。选中目标/属性名，按下 Alt + Shift + R，然后键入你要修改后的值，所有引用到的地方都会随之改动。如下图所示，选中 init 后，按下快捷键，改成 initial：

· 调试 Ant 脚本。在标签“<target name=..”的左边设置一断点，然后在编辑器中右击，出现的菜单中选“Debug As”－“Ant Build”，出现后的窗口与调试 Java 程序的界面差不多。

这是调试窗口，这里可以选择单步跟进、跳出等：

下面是运行时变量窗口。可以看到 test 变量的值是“test”：

运行结果窗口：

由此可见，如果使用好 Eclipse Ant 编辑器所提供强大的功能的话能大大提高写 Ant 脚本的效率。

回页首

Ant 中使用 property（属性）文件

刚开始写 Ant 的初学者可能会把所有的信息都放在 build.xml 中，下面就是这样的一个例子。

<project name="testBuild" default="compile" basedir="."> <target name="init"> <mkdir dir="c:/temp/dest/testProj" /> </target> <target name="compile" depends="init"> <javac srcdir="c:/temp/src/testProj" destdir="c:/temp/dest/testProj "/> <echo>Build into c:/temp/dest/testProj, successfully.</echo> </target> </project>

在上面的例子中，所有的路径信息都是写在 build.xml 中。但是 Ant 脚本可能在不同的机器或者不同的系统上运行，也有可能一些值需要根据环境的不同而变化，在 Ant 中可以把所有这些可能变化的地方都放到一个配置文件中，然后在 Ant 脚本中引用这个配置文件就可以了，针对上面的例子，如下所示：

<project name="testBuild" default="compile" basedir="."> <property file="build.properties"/> <target name="init"> <mkdir dir="${dest.dir}" /> </target> <target name="compile" depends="init"> <javac srcdir="${src.dir}" destdir="${dest.dir}"/> <echo>Build into ${dest.dir}, successfully.</echo> </target> </project> build.properties的内容： dest.dir=c:/temp/dest/testProj src.dir=c:/temp/src/testProj

如果想在 Ant 脚本中引用值的话，只需用$符号开头，在一对"{}"中写入要引用的键值。如上例中，需要引用编译的目标路径用"${dest.dir}"。

回页首

使用 Ant 任务从 CVS 中检出（check out）源代码，并编译打包

Ant 中提供了 cvs 任务（Task）可以从 CVS 服务器中检出资源（注意：在使用 Ant 的 cvs 任务之前，请先将 cvs.exe 下载到你的机器，并且将它添加到你本地的 PATH 环境变量中，然后重新启动 Eclipse。否则在执行下面脚本的时候就会得到 error=2 的错误）。cvs 的可选用属性很多，在这里介绍经常使用到的几个属性。从 CVS 中检出资源一般需要指定：

· CVS 所在的服务器地址：目标 CVS 服务器地址

· 用户名：登录该 CVS 服务器你指定的用户名

· 密码：登录该 CVS 服务器需要的密码

· 库路径（Repository Path）：服务器中的库路径

· 模块名：当前需要检出的模块名，一般都是以工程的名字作为模块名

· 标签名：需要从 CVS 中检出哪个标签

在介绍使用 Ant 的 cvs 之前，先说一下本地的目录结构。在 C 盘的 temp 目录下，分别有四个目录，如下所示：

· build 目录：放编译后的类以及资源文件

· dist 目录：放生成的 jar 文件或者 war 文件

· lib 目录：放在编译过程中需要用到的 jar 文件

· src 目录：放从 cvs 中检出的源文件（包括 JSP 等）

在 Ant 中这样写就可以从中检出资源：

这段脚本片断的意思就是从叫"cvs.server"的服务器中，用用户名是 username、密码为 pwd 的用户检出在库路径是 /home/testPath 下的 TestProj 模块（项目），检出后的资源放入本地目录 c:/temp/src/testProj 中。在上面这段脚本中，可以看到有很多值可能会根据不同的环境或者用户随之改变的，比如用户名和密码等；而且从脚本的重复可利用性来说，需要把有些值抽出来放到配置文件中，如服务器的地址和库路径等。因此把这些可能需要更改的地方放到 property 文件中，效果会更好。改完后的完整 Ant 脚本如下所示：

<?xml version="1.0"?> <project name="testWeb" default="checkout" basedir="."> <target name="checkout"> <property file="TestWeb.properties" /> <cvs cvsRoot="${cvs.root}" package="${cvs.projectName}" tag="${cvs.tag}" dest="${src.dir}" failοnerrοr="true" /> </target> </project>

对应的 TestWeb.properties 文件内容如下所示：

base.dir=c:/temp/ src.dir=${base.dir}/src cvs.server=cvs.server cvs.user=username cvs.pw=pwd cvs.repositoryPath=/home/testPath cvs.projectName=TestProj cvs.root=:pserver:${cvs.user}:${cvs.pw}@${cvs.server}:${cvs.repositoryPath} cvs.tag=

在检出了资源后，需要对其进行编译打包。为了使 Ant 脚本更加具有可读性和灵活性，我们需要对上面的 Ant 脚本进行一些改动。首先将 Ant 脚本中进行分段，如下所示：

<?xml version="1.0"?> <project name="testWeb" default="all" basedir="."> <target name="all" depends="init,clean,checkout,build">  </target> <target name="init">  </target> <target name="clean">  </target> <target name="checkout">  </target> <target name="build">  </target> </project>

上面的脚本中，总共分成了5个目标（target），脚本的入口点是"all"，all 按顺序调用 init，clean，checkout，build。其中：

· init 是用来做初始化属性文件和设置 classpath 等设置初始条件的事情

· clean 用来删除上一次留下的没用的目录和文件

· checkout 已经介绍过了，是用来从 CVS 中检出资源

· build 用来编译源文件并打 WAR 包到指定的目录

详细的 Ant 脚本可以参见随本文所附的 TestWeb.xml 和 TestWeb.properties。

回页首

编译过程与产生不同目标环境的脚本分开执行

在前面介绍的 Ant 脚本中，根据从 CVS 服务器中检出的资源打成了一个默认的 war 包，并没有考虑根据不同的目标环境来生成不同的包，从下一节开始介绍如何根据不同的环境来生成不同的部署包。

还有一个问题是：为什么需要把从 CVS 中检出资源、编译的过程跟根据目标环境打包的过程分开？

这是因为本身 CVS 检出资源是需要花一定的时间，如果资源比较多这个过程就会花费挺长时间；另外，在多人开发的情况下必须保证在生成不同的部署包的时候是用的是同一套代码生成的，否则会出现各个服务器上运行的版本不一致，如果检出资源、编译的过程跟生成包的脚本一起执行的话就会出现这个问题（比如小A在测试服务器测试通过的时候之后，再生成一个在产品环境下的部署包，如果分两次从 CVS 服务器中检出资源的话，在此期间可能会有开发人员往 CVS 服务器中检入代码，导致生成的版本不一致），因此，必须将这两个过程分开执行。现在我们开始建立另外一个 Ant 脚本文件，叫 deploy.xml，专门用来生成包；另外与 deploy.xml 相对应的还有一个 deploy.properties 文件。在 deploy.xml 中会引用 deploy.properties 文件。另外根据在前面的场景中碰到的环境，创建三个不同的属性文件, develop_deploy.property、test_deploy. property 和 product_deploy. Property，在打包的时候，根据不同的目标环境，将相应属性文件中的内容拷贝至 deploy.properties 文件中（或者也可以直接在 deploy.xml 中直接切换不同的属性文件），然后在 Eclipse 中直接执行 deploy.xml；如果在命令行中，可以用下面的命令来执行：

ant –f deploy.xml

回页首

解开 WAR 包

我们首先得建立一个目录（这里是 unpack）用来存放解压后的文件。Ant 中提供了 unzip 命令用来解压 ear/war/jar 包。除了这个目录外，根据不同的目标环境，在运行目录下建立一个与目标环境相对应的目录，重新打好的 war 包就放在这个目录下，比如针对场景中的情况，如果需要创建一个产品环境下的部署包，我们可以建立一个 TestWebProduct 目录，目录名写在配置文件中（${pack.base.dir}）。

<target name="init"> <echo>init in deploy</echo> <property file="deploy.properties" /> <delete dir="${unpack.base.dir}" failοnerrοr="false" /> <delete dir="${pack.base.dir}" failοnerrοr="false" /> <mkdir dir="${unpack.base.dir}" /> <mkdir dir="${pack.base.dir}" /> </target> <target name="unpack"> <echo>unpack the ${war.name}</echo> <copy file="${dest.dir}/${war.name}" todir="${unpack.base.dir}" /> <unzip src="${unpack.base.dir}/${war.name}" dest="${unpack.base.dir}/${projectName}" /> <delete file="${unpack.base.dir}/${war.name}" /> </target>

在 init 段中首先删除掉上次解压的目录和目标打包目录，然后重新建立目录；在 unpack 中，首先将编译好的默认 war 包拷贝至 unpack 定义的目录，解压之后把 unpack 下的 war 包删除。下面是这时候对应的属性文件。

projectName=MTSWeb war.name=MTSWeb.war #根目录 base.dir=c:/temp #默认的war包所在的目录 dest.dir=${base.dir}/dist #解压后的目录 unpack.base.dir=${base.dir}/unpack #目标环境相对应的目录 pack.base.dir=${base.dir}/TestWebProduct

回页首

利用 Ant 提供的 filter 任务替换属性值

现在根据不同环境的需要，对某些配置文件的值做一些替换。在 Ant 中，提供了 filter 任务，使得替换值很方便。当然也可以使用下面介绍的正则表达式来替换属性值。filter 主要用来在同一行内容中的替换，而正则表达式一下子可以替换多行内容。filter 的使用例子：

这段脚本的意思就是在 src.dir 目录下的所有文件中，如果有预先定义好的"@log4j.logger@"占位符的话，在拷贝到 dest.dir 目录后，所有的占位符都被替换成了"INFO"。

你也可以将所有被替换的值放到某个属性文件中，filter 任务将属性文件中的每一个条目读出来并且设置成一个 Filter。如下所示：

上面的脚本表示所有在 deploy_env 中出现的条目将被作为一个 filter，在拷贝到 dest.dir 目录后，所有 src.dir 目录中存在的占位符将被替换成 deploy_env 中的值。具体的例子可以参见随本文附带的 deploy.xml， deploy_env.properties 和 Test.properties。

其中 deploy.xml 是 ant 脚本，deploy_env.properties 中包含所有要替换的值，在 Test.properties 中是包含有占位符的资源文件。

回页首

利用正则表达式替换属性值

Ant 中支持多种正则表达式，在运行 Ant 的时候用哪种正则表达式可以通过设置 ant.regexp.regexpimpl 的值来切换，Ant 支持的的正则表达式有：

· java.util.regex package of JDK 1.4

· jakarta-regexp

· installation dependencies

正则表达式的例子：

byline 属性用来确认被替换的时候是一次替换一行还是多行；pattern 属性用来指明正则表达式；substitution expression 中是替换的值，替换的值都定义在相对应的配置文件中；fileset 属性中的 dir 用来指定被替换文件所在的目录，includes 用来指定要替换哪个文件。需要注意的是，如果在正则表达式或者替换的值中出现"<"的话，需要用转义符"<"。

在 Eclipse3.1 中已经内置了对正则表达式的支持；但是如果你在命令行中运行需要正则表达式支持的脚本的话，则需要自己将正则表达式的包下载下来加到 classpath 中。在随文章的 deploy.xml 中提供了一个简单的替换属性文件的值的例子。正则表达式的例子可以在本文所带的 deploy.xml 中找到。

回页首

Ant 使用条件表达式，根据属性值删除不需要的文件

在生成部署包的时候，还有可能会根据目标环境的不同，删除一些不同的文件。比如在产品环境中那些作为测试需要的代码往往需要删除，但是测试环境中并不需要。因此就需要条件表达式来做判断。如下所示：

</condition>

</target> <target name="falseCondition" unless="isTestEnv"> <echo message="false condition in ${projectName}" />

</target>

在上面的例子中，先读出 ${deploy.isTestEnv} 的值（在配置文件 deloy.properties 中），根据读出的值对属性 isTestEnv 设值，如果 ${deploy.isTestEnv} 的值是 true，isTestEnv 的值也是 true；否则是 false。然后分别调用目标段 trueCondition 和 falseCondition。在这里，表达式值的判断是用"istrue"，在 Ant 中还提供了很多别的表达式，比如 not/and/or，equals 等等，具体关于条件表达式的信息可以参考：http://ant.apache.org/manual/CoreTasks/condition.html ，该页也可以在随下载下来的文档中找到。