Ant 的使用(ZT)
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腳本,這些會在后續介紹中詳細描述用法。掌握了它們,你就是會在生產過程中大大提高工作效率,別人也會對你刮目相看的,別忘了和你的同事分享哦。
?
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腳本,這些會在后續介紹中詳細描述用法。掌握了它們,你就是會在生產過程中大大提高工作效率,別人也會對你刮目相看的,別忘了和你的同事分享哦。
posted on 2007-01-10 11:43 風人園 閱讀(679) 評論(0) 編輯 收藏 所屬分類: Open Source