Ant介紹以及基本使用指南
Ant 是著名Java開源組織Apache的一個項目,是一個基于java的build工具。它可以使你通過ant腳本語言,自動你的項目拷貝到某個目錄,發(fā)布項目,或者生成一些代碼,執(zhí)行SQL語言。總之它可以幫助你完成項目開發(fā)中除了開發(fā)代碼以外的大部分輔助性工作。為什么需要手工去編寫ant腳本呢,很多IDE工具會為我們生成ant腳本阿?有人會這么問。要知道靠IDE自動生成的東西,總是有這樣那樣的缺點,以及不足,他不能完全滿足你的很多需要。如果出現(xiàn)了問題,你不得不手動修改ant腳本,這時候如果你不了解ant那么你將會一籌莫展。所以為了能使自己的項目變得更專業(yè)化,或者想在領(lǐng)導(dǎo)面前show一下的話(有時候很有用)。還是了解一下ant吧。
Ant 的安裝使用
安裝
Ant安裝很簡單,只要你從apache網(wǎng)站上下載他的zip包,然后解壓到任何本地磁盤上,在環(huán)境變量中添加 Path 的值加上 %ANT_HOME%/bin 就可以了,這樣在Dos提示符中就可以使用 ant 這個命令了。其他的你需要設(shè)置一下 ANT_HOME 這個環(huán)境變量為你解壓后的目錄。還有就是你要檢查一下你的JDK安裝目錄JAVA_HOME是不是加到你的環(huán)境變量里面去了。
使用
概述
使用ant 也同樣是非常簡單的事。通常的做法就是在你的項目里面建立一個XML文件,名字通常可以取 build.xml 。當(dāng)然你可以取任何你喜歡的名字。這個文件就是你需要ant為你項目做的一些輔助性工作的批處理文件。他的格式可能是這樣的。我們先不具體說ant 標(biāo)記,先有一個感性的認識會比較快的上手。
例子:
<?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 標(biāo)簽。有些項目的build.xml可能不是以<?xml version="1.0" encoding="UTF-8"?>開頭的,不過沒關(guān)系,以后再說明。每一個build.xml 只能有一個project 標(biāo)簽, 每個project 標(biāo)簽里面包含了幾個tartget標(biāo)簽。每一個target可以獨立執(zhí)行或者依賴于其他target執(zhí)行完畢才能執(zhí)行。
以下是一個典型的例子。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
當(dāng)中target A 可以獨立執(zhí)行,但是B、C、D 則依賴于其他target才可以執(zhí)行,也就是說,執(zhí)行D, ant 就會按照 A- B- C 這樣的順序先執(zhí)行其他target。
Project 標(biāo)簽里面有一個 default="all" ,這就是說明了在默認情況下 all 這個target 會被執(zhí)行。
定義變量
在這個文件中沒有看到屬性定義,其實如果你想使用定義變量的話,可以在project 標(biāo)簽下 定義如這樣的標(biāo)簽
<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 這個任務(wù)標(biāo)簽
其中看到 有 srcdir 、destdir、debug 、encoding 等屬性,還有一個 classpath 的子標(biāo)簽。Srcdir就是目標(biāo)source,需要編譯的源文件,destdir就是目的地,編譯出來的class的存放地。Debug參數(shù)是指明source是不是需要把debug信息編譯進去,如果不加這個參數(shù)等于在命令行后面加上 -g:none 這個參數(shù)。Encoding 這個參數(shù)指明以何種編碼方式編碼你的source文件,對于有中文文字的代碼來說這項比較重要。
Classpath 指明了你需要應(yīng)用的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 引用預(yù)先定義的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就是你的目標(biāo)class文件,其它的復(fù)雜參數(shù)手冊上都有,可以對照參考。
<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包內(nèi)。
復(fù)制文件操作
<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是否忽略目的目錄結(jié)構(gòu),只得是不管什么目錄,直接拷貝文件到目的地,丟棄其所在結(jié)構(gòu)。
<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>
以上操作也是很容易理解的。
執(zhí)行ant 腳本
在有build.xml 的目錄提示符下使用 ant 就可以了。如果是其他的名字,那就使用ant -buildfile <文件名> 就可以了。
其它的就是在具體開發(fā)過程中real-world式的比較經(jīng)典的一些操作。比方說利用XDoclet自動生成hibernate配置文件,執(zhí)行SQL腳本,這些會在后續(xù)介紹中詳細描述用法。掌握了它們,你就是會在生產(chǎn)過程中大大提高工作效率,別人也會對你刮目相看的,別忘了和你的同事分享哦。
作者:Spike Spiegel ,
Blog: http://blog.csdn.net/hk2000c/
About copyright:歡迎轉(zhuǎn)載,請注明作者。
參考資料
Apache Ant 主站:http://ant.apache.org/
posted on 2007-11-15 14:57 最後の騎士 閱讀(544) 評論(0) 編輯 收藏 所屬分類: java技術(shù)