Posted on 2005-02-26 18:06
bigseal 閱讀(178)
評論(0) 編輯 收藏
Ant 是著名Java開源組織Apache的一個項(xiàng)目，是一個基于java的build工具。它可以使你通過ant腳本語言，自動你的項(xiàng)目拷貝到某個目錄，發(fā)布項(xiàng)目，或者生成一些代碼，執(zhí)行SQL語言?？傊梢詭椭阃瓿身?xiàng)目開發(fā)中除了開發(fā)代碼以外的大部分輔助性工作。為什么需要手工去編寫ant腳本呢，很多IDE工具會為我們生成ant腳本阿？有人會這么問。要知道靠IDE自動生成的東西，總是有這樣那樣的缺點(diǎn)，以及不足，他不能完全滿足你的很多需要。如果出現(xiàn)了問題，你不得不手動修改ant腳本，這時候如果你不了解ant那么你將會一籌莫展。所以為了能使自己的項(xiàng)目變得更專業(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 也同樣是非常簡單的事。通常的做法就是在你的項(xiàng)目里面建立一個XML文件，名字通常可以取 build.xml 。當(dāng)然你可以取任何你喜歡的名字。這個文件就是你需要ant為你項(xiàng)目做的一些輔助性工作的批處理文件。他的格式可能是這樣的。我們先不具體說ant 標(biāo)記，先有一個感性的認(rèn)識會比較快的上手。
例子：
<?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的一個項(xiàng)目。里面可以看到有 project 以及target 標(biāo)簽。有些項(xiàng)目的build.xml可能不是以“?xml version="1.0" encoding="UTF-8"?”開頭的，不過沒關(guān)系，以后再說明。每一個build.xml 只能有一個project 標(biāo)簽， 每個project 標(biāo)簽里面包含了幾個tartget標(biāo)簽。每一個target可以獨(dú)立執(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 可以獨(dú)立執(zhí)行，但是B、C、D 則依賴于其他target才可以執(zhí)行，也就是說，執(zhí)行D, ant 就會按照 A- B- C 這樣的順序先執(zhí)行其他target。
Project 標(biāo)簽里面有一個 default="all" ，這就是說明了在默認(rèn)情況下 all 這個target 會被執(zhí)行。
定義變量
在這個文件中沒有看到屬性定義，其實(shí)如果你想使用定義變量的話，可以在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信息編譯進(jìn)去，如果不加這個參數(shù)等于在命令行后面加上 -g:none 這個參數(shù)。Encoding 這個參數(shù)指明以何種編碼方式編碼你的source文件，對于有中文文字的代碼來說這項(xiàng)比較重要。
Classpath 指明了你需要應(yīng)用的jar包，或者其它c(diǎn)lass文件的所在地，這也是非常重要的一項(xiàng)選項(xiàng)。使用方式有以下幾種。
<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"
/> |
這就簡單了點(diǎn)。
打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腳本一起打進(jìn)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 指定了需要拷貝的地點(diǎn)，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ù)介紹中詳細(xì)描述用法。掌握了它們，你就是會在生產(chǎn)過程中大大提高工作效率，別人也會對你刮目相看的，別忘了和你的同事分享哦。（T111） |