騎士の圣殿

           

          Ant介紹以及基本使用指南

          Ant 是著名Java開源組織Apache的一個項目,是一個基于javabuild工具。它可以使你通過ant腳本語言,自動你的項目拷貝到某個目錄,發(fā)布項目,或者生成一些代碼,執(zhí)行SQL語言。總之它可以幫助你完成項目開發(fā)中除了開發(fā)代碼以外的大部分輔助性工作。為什么需要手工去編寫ant腳本呢,很多IDE工具會為我們生成ant腳本阿?有人會這么問。要知道靠IDE自動生成的東西,總是有這樣那樣的缺點,以及不足,他不能完全滿足你的很多需要。如果出現了問題,你不得不手動修改ant腳本,這時候如果你不了解ant那么你將會一籌莫展。所以為了能使自己的項目變得更專業(yè)化,或者想在領導面前show一下的話(有時候很有用)。還是了解一下ant吧。

          Ant 的安裝使用

          安裝

          Ant安裝很簡單,只要你從apache網站上下載他的zip包,然后解壓到任何本地磁盤上,在環(huán)境變量中添加 Path 的值加上 %ANT_HOME%/bin 就可以了,這樣在Dos提示符中就可以使用 ant 這個命令了。其他的你需要設置一下 ANT_HOME 這個環(huán)境變量為你解壓后的目錄。還有就是你要檢查一下你的JDK安裝目錄JAVA_HOME是不是加到你的環(huán)境變量里面去了。

          使用

          概述

          使用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可以獨立執(zhí)行或者依賴于其他target執(zhí)行完畢才能執(zhí)行。

          以下是一個典型的例子。

          <target name="A"/>
          <target name="B" depends="A"/>
          <target name="C" depends="B"/>
          <target name="D" depends="C,B,A"/>

          當中target A 可以獨立執(zhí)行,但是BCD 則依賴于其他target才可以執(zhí)行,也就是說,執(zhí)行D, ant 就會按照 A- B- C 這樣的順序先執(zhí)行其他target

          Project 標簽里面有一個 default="all" ,這就是說明了在默認情況下 all 這個target 會被執(zhí)行。

          定義變量

          在這個文件中沒有看到屬性定義,其實如果你想使用定義變量的話,可以在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 destdirdebug 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文件以外,把一個sourceresource目錄,連同編譯后的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>

          以上操作也是很容易理解的。

          執(zhí)行ant 腳本

          在有build.xml 的目錄提示符下使用 ant 就可以了。如果是其他的名字,那就使用ant -buildfile <文件名>   就可以了。

          其它的就是在具體開發(fā)過程中real-world式的比較經典的一些操作。比方說利用XDoclet自動生成hibernate配置文件,執(zhí)行SQL腳本,這些會在后續(xù)介紹中詳細描述用法。掌握了它們,你就是會在生產過程中大大提高工作效率,別人也會對你刮目相看的,別忘了和你的同事分享哦。

          作者:Spike Spiegel ,

          Blog: http://blog.csdn.net/hk2000c/

          About copyright:歡迎轉載,請注明作者。

          參考資料

          Apache Ant 主站:http://ant.apache.org/

          posted on 2007-11-15 14:57 最後の騎士 閱讀(549) 評論(0)  編輯  收藏 所屬分類: java技術

          導航

          統(tǒng)計

          常用鏈接

          留言簿(1)

          隨筆分類

          隨筆檔案

          文章分類

          搜索

          最新評論

          閱讀排行榜

          評論排行榜

          主站蜘蛛池模板: 沁源县| 张掖市| 德保县| 故城县| 行唐县| 襄汾县| 五家渠市| 土默特右旗| 斗六市| 武定县| 通辽市| 连江县| 开封县| 广安市| 玛沁县| 潼关县| 西贡区| 柯坪县| 津南区| 都安| 师宗县| 谷城县| 吉安市| 和田县| 桃江县| 宣城市| 大港区| 香格里拉县| 宜章县| 区。| 宁化县| 高雄县| 兴化市| 宜州市| 莫力| 响水县| 修水县| 修武县| 体育| 明水县| 南城县|