Posted on 2005-02-26 18:06
bigseal 閱讀(175)
評論(0) 編輯 收藏
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腳本，這些會在后續介紹中詳細描述用法。掌握了它們，你就是會在生產過程中大大提高工作效率，別人也會對你刮目相看的，別忘了和你的同事分享哦。（T111） |