Ant
介紹以及基本使用指南
Ant
是著名
Java
開源組織
Apache
的一個項目，是一個基于
java
的
build
工具。它可以使你通過
ant
腳本語言，自動你的項目拷貝到某個目錄，發布項目，或者生成一些代碼，執行
SQL
語言。總之它可以幫助你完成項目開發中除了開發代碼以外的大部分輔助性工作。為什么需要手工去編寫
ant
腳本呢，很多
IDE
工具會為我們生成
ant
腳本阿？有人會這么問。要知道靠
IDE
自動生成的東西，總是有這樣那樣的缺點，以及不足，他不能完全滿足你的很多需要。如果出現了問題，你不得不手動修改
ant
腳本，這時候如果你不了解
ant
那么你將會一籌莫展。所以為了能使自己的項目變得更專業化，或者想在領導面前
show
一下的話
(
有時候很有用
)
。還是了解一下
ant
吧。
?
Ant
的安裝使用
?
安裝
Ant
安裝很簡單，只要你從
apache
網站上下載他的
zip
包，然后解壓到任何本地磁盤上，在環境變量中添加
Path
的值加上
%ANT_HOME%/bin
就可以了，這樣在
Dos
提示符中就可以使用
ant
這個命令了。其他的你需要設置一下
ANT_HOME
這個環境變量為你解壓后的目錄。還有就是你要檢查一下你的
JDK
安裝目錄
JAVA_HOME
是不是加到你的環境變量里面去了。
?
使用
概述
?
使用
ant
也同樣是非常簡單的事。通常的做法就是在你的項目里面建立一個
XML
文件，名字通常可以取
build.xml
。當然你可以取任何你喜歡的名字。這個文件就是你需要
ant
為你項目做的一些輔助性工作的批處理文件。他的格式可能是這樣的。我們先不具體說
ant
標記，先有一個感性的認識會比較快的上手。
?
例子：
<?xml version="1.0" encoding="UTF-8"?>
?
<project default="all" name="pluto-project" basedir=".">
?
?
?
?????? <target name="all" depends="api, container, portal">
?????? </target>
?
?????? <target name="clean" depends="api-clean, container-clean, portal-clean">
?????? </target>
?
?????? <target name="api">
????????????? <property name="final.name" value="portlet-api-@@DATE@@"/>
????????????? <ant antfile="build.xml" dir="api" target="jar" inheritAll="false" />
?????? </target>
?????? <target name="api-clean">
????????????? <ant antfile="build.xml" dir="api" target="clean" inheritAll="false" />
?????? </target>
?
?????? <target name="container" depends="api">
????????????? <ant antfile="build.xml" dir="container" target="jar" inheritAll="false" />
?????? </target>
?
?????? <target name="container-clean">
????????????? <ant antfile="build.xml" dir="container" target="clean" inheritAll="false" />
?????? </target>
?
?????? <target name="portal" depends="container">
????????????? <ant antfile="build.xml" dir="portal" target="jar" inheritAll="false" />
?????? </target>
?????? <target name="portal-clean">
????????????? <ant antfile="build.xml" dir="portal" target="clean" inheritAll="false" />
?????? </target>
?
</project>
?
?
這個
build.xml
文件引自
apache
的一個項目。里面可以看到有
project
以及
target
標簽。有些項目的
build.xml
可能不是以
<?xml version="1.0" encoding="UTF-8"?>
開頭的，不過沒關系，以后再說明。每一個
build.xml
只能有一個
project
標簽，
每個
project
標簽里面包含了幾個
tartget
標簽。每一個
target
可以獨立執行或者依賴于其他
target
執行完畢才能執行。
以下是一個典型的例子。
?
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
?
?
當中
target A
可以獨立執行，但是
B
、
C
、
D
則依賴于其他
target
才可以執行，也就是說，執行
D, ant
就會按照
A- B- C
這樣的順序先執行其他
target
。
Project
標簽里面有一個
default="all"
，這就是說明了在默認情況下
all
這個
target
會被執行。
?
定義變量
?
在這個文件中沒有看到屬性定義，其實如果你想使用定義變量的話，可以在
project
標簽下
定義如這樣的標簽
<project ……>
<property name="src" location="src"/>
? <property name="build" location="build"/>
<target ……>
這樣你在引用的時候就可以使用形如
${build}
<target name="init">
……
<mkdir dir="${build}"/>
……
? </target>
這樣的變量了，省得自己去修改每一處需要用到變量的地方
?
?
添加目錄操作
?
<target name="init">
????????????? <mkdir dir="${dist.dir}" />
????????????? <mkdir dir="${dist.classes.dir}" />
????????????? <mkdir dir="${dist.webapps.dir}" />
?????? </target>
?
這里的
dist.dir
等用
${}
括起來的，是我們定義的變量。
?
編譯
java
文件的操作
?
?
<target name="compile">
????????????? <javac srcdir="${src.dir}" destdir="${dist.classes.dir}" debug="true" encoding="GBK">
???????????????????? <classpath refid="classpath" />
????????????? </javac>
?????????????
????????????? <jar destfile="${dist.classes.dir}/lib/app.jar" basedir="${dist.classes.dir}"/>
?????? </target>
?
這里說一下
javac
這個任務標簽
?
其中看到
有
srcdir
、
destdir
、
debug
、
encoding
等屬性，還有一個
classpath
的子標簽。
Srcdir
就是目標
source,
需要編譯的源文件，
destdir
就是目的地，編譯出來的
class
的存放地。
Debug
參數是指明
source
是不是需要把
debug
信息編譯進去，如果不加這個參數等于在命令行后面加上
-g:none
這個參數。
Encoding
這個參數指明以何種編碼方式編碼你的
source
文件，對于有中文文字的代碼來說這項比較重要。
?
Classpath
指明了你需要應用的
jar
包，或者其它
class
文件的所在地，這也是非常重要的一項選項。使用方式有以下幾種。
?
<property name="lib.dir" value="${basedir}/lib" />
…….
<path id="classpath">
??????????? <fileset dir="${lib.dir}">
????????????????? <include name="*.jar"/>
??????????? </fileset>
??????? </path>
……
?
<classpath refid="classpath" />
?
作為
classpath
引用預先定義的
jar
包位置
,refid
指明了一個引用變量。一般在
real-world
情況下會這樣使用。簡單的使用是這樣的：
<javac srcdir="${src}"
???????? destdir="${build}"
???????? classpath="xyz.jar"
???????? debug="on"
? />
?
這就簡單了點。
?
打
jar
包操作
?
<jar destfile="${dist}/lib/app.jar" basedir="${dist.classes.dir}"/>
?
這個就是把編譯好的文件打成
jar
包的
ant
腳本，和上面
javac
一樣，可以放在任意位置。很明顯
destfile
就是
你想要打成的包，
basedir
就是你的目標
class
文件
,
其它的復雜參數手冊上都有，可以對照參考。
<jar destfile="${dist}/lib/app.jar">
??? <fileset dir="${build}/classes"
???????????? excludes="**/Test.class"
??? />
??? <fileset dir="${src}/resources"/>
? </jar>
?
上面這段腳本也很容易理解，就是除了
Test.class
文件以外，把一個
source
的
resource
目錄，連同編譯后的
class
腳本一起打進
app.jar
包內。
?
復制文件操作
?
<copy todir="${dist.webapps.dir}/WEB-INF/lib" overwrite="true" flatten="true">
???????????????????? <fileset dir="${lib.dir}">
??????????????????????????? <include name="*.jar" />
??????????????????????????? <exclude name="j2ee.jar" />
???????????????????? </fileset>
????????????? </copy>
?
上面腳本很容易理解。
Todir
指定了需要拷貝的地點，
overwrite
是否需要覆蓋，
flatten
是否忽略目的目錄結構，只得是不管什么目錄，直接拷貝文件到目的地，丟棄其所在結構。
?
<fileset dir="${lib.dir}">
??????????????????????????? <include name="*.jar" />
??????????????????????????? <exclude name="j2ee.jar" />
???????????????????? </fileset>
選定除了
j2ee.jar
包以外的所有在
lib.dir
變量所定義的包下面的
jar
包
?
?
其它拷貝樣式
?
<copy file="myfile.txt" todir="../some/other/dir"/>
單文件拷貝
<copy file="myfile.txt" todir="../some/other/dir"/>
文件到目錄拷貝
<copy todir="../new/dir">
??? <fileset dir="src_dir"/>
? </copy>
目錄對拷貝
?
比較有用的命令
?
<copy todir="../backup/dir">
??? <fileset dir="src_dir"/>
??? <filterset>
????? <filter token="TITLE" value="Foo Bar"/>
??? </filterset>
? </copy>
拷貝
sr_dir
目錄到
backup/dir
目錄，并且把所有文件中的
@TITLE@
替換成
Foo Bar
。還有很多用法，等到要使用的時候可以去查手冊。
?
?
刪除操作
?
<target name="clean">
??????
?????? <delete dir="${dest.dir}"/>
????????????? <delete file="${dest2.dir}"/>
?????? </target>
?
以上操作也是很容易理解的。
?
?
?
?
?
?
?
執行
ant
腳本
?
在有
build.xml
的目錄提示符下使用
ant
就可以了。如果是其他的名字，那就使用
ant -buildfile <
文件名
>??
就可以了。
?
?
?
其它的就是在具體開發過程中
real-world
式的比較經典的一些操作。比方說利用
XDoclet
自動生成
hibernate
配置文件，執行
SQL
腳本，這些會在后續介紹中詳細描述用法。掌握了它們，你就是會在生產過程中大大提高工作效率，別人也會對你刮目相看的，別忘了和你的同事分享哦。
?
?
?
?
作者：
Spike Spiegel ,
Blog: http://blog.csdn.net/hk2000c/
?
About copyright
：歡迎轉載，請注明作者。
?
?
?
參考資料
Apache Ant
主站：
http://ant.apache.org/
?
?
?
?
?
?