隨筆 - 154  文章 - 60  trackbacks - 0
          <2008年4月>
          303112345
          6789101112
          13141516171819
          20212223242526
          27282930123
          45678910

          聲明:

          該blog是為了收集資料,認(rèn)識(shí)朋友,學(xué)習(xí)、提高技術(shù),所以本blog的內(nèi)容除非聲明,否則一律為轉(zhuǎn)載!!

          感謝那些公開(kāi)自己技術(shù)成果的高人們!!!

          支持開(kāi)源,尊重他人的勞動(dòng)!!

          常用鏈接

          留言簿(3)

          隨筆分類(lèi)(148)

          隨筆檔案(143)

          收藏夾(2)

          其他

          學(xué)習(xí)(技術(shù))

          觀察思考(非技術(shù))

          搜索

          •  

          最新評(píng)論

          閱讀排行榜

          評(píng)論排行榜

          本內(nèi)容包含了Ant的歷史簡(jiǎn)要介紹,Ant的功能以及Ant框架的介紹,并對(duì)下載安裝使用Ant進(jìn)行了示例介紹,同時(shí)通過(guò)一個(gè)Java程序講解了Ant的基本使用方法。


          1.       Ant簡(jiǎn)介:這里引用Ant幫助文檔中對(duì)Ant的介紹:

               Apache Ant是一個(gè)基于Java的構(gòu)建工具。從理論上講,也是一種類(lèi)似于Make的工具,只是去除了Make工具的缺點(diǎn)。
              
                既然已經(jīng)有了make, gnumake, nmake, jam以及其他的構(gòu)件工具,為什么還要Ant呢?因?yàn)锳nt的早期開(kāi)發(fā)者發(fā)現(xiàn)所有以上這些工具都或多或少的有一些局限性,使得在跨平臺(tái)開(kāi)發(fā)軟件成為困難。類(lèi)似于Make的工具都是傳統(tǒng)的基于Shell的--首先進(jìn)行依賴性檢查,然后執(zhí)行命令。這意味著你可以輕易的通過(guò)使用或者編寫(xiě)程序來(lái)擴(kuò)展這些工具,以滿足不同的平臺(tái)。當(dāng)然,這也意味著你將局限于特定的平臺(tái),至少可以說(shuō)局限于特定類(lèi)型的平臺(tái),例如:Unix平臺(tái)。
                                                                                                

              同時(shí),Make文件也有一些先天的缺陷。好多人都會(huì)遇到恐怖的tab問(wèn)題。Ant的最初開(kāi)發(fā)者多次說(shuō)“我的命令不能執(zhí)行因?yàn)槲以趖ab前面加了一個(gè)空格!”。一些工具如Jam一定程序上解決了這個(gè)問(wèn)題,但仍有其它的格式問(wèn)題。


              Ant與從基于命令的那些擴(kuò)展開(kāi)來(lái)的那些工具不同,Ant是由java類(lèi)擴(kuò)展的。不用編寫(xiě)shell命令,而是配置基于XML的文件,形成多個(gè)任務(wù)的目標(biāo)配置樹(shù)。每一個(gè)任務(wù)都是通過(guò)一個(gè)實(shí)現(xiàn)了一個(gè)規(guī)定接口的java類(lèi)來(lái)運(yùn)行的。

              ant缺少了一些直接執(zhí)行shell命令的能力,如find . -name foo -exec rm {},但它給用戶提供了跨平臺(tái)的能力,可以在任何地方工作。實(shí)際上,Ant也提供了命令execute用來(lái)執(zhí)行shell命令,這就是它的任務(wù),它允許執(zhí)行基于操作系統(tǒng)的命令。


              簡(jiǎn)單的說(shuō),Ant是一個(gè)基于Java,并且主要用于Java工程的構(gòu)建工具。Ant本意是Another Neat Tool,也就是另一種整潔的工具,取首字符就是Ant。


          構(gòu)建工具就是為了減少重復(fù)工作而產(chǎn)生的。


          2.       Ant的一些核心概念:
          XML:構(gòu)建文件是以XML文件來(lái)描述的,采用XML格式有很多好處。這里就不一一列舉。
          陳述式語(yǔ)法:構(gòu)建文件短小精悍,且易于理解。
          每個(gè)構(gòu)建文件包含一個(gè)工程(project)
          每個(gè)工程包含若干個(gè)目標(biāo)(target)
          目標(biāo)可以依賴于其他的目標(biāo)(depends)
          目標(biāo)包含任務(wù)(task)
          易于使用Java語(yǔ)言增加新的任務(wù)---易于擴(kuò)展(自定義)。
          3.       Ant結(jié)構(gòu):
          Ant的結(jié)構(gòu)如下圖所示:


          構(gòu)建文件的概念視圖:工程包含一個(gè)目標(biāo)的集合。在每個(gè)目標(biāo)里是任務(wù)的聲明,它們是對(duì)
          Ant用于構(gòu)建該目標(biāo)的行為說(shuō)明。目標(biāo)生成一個(gè)依賴關(guān)系圖表來(lái)聲明該目標(biāo)的依賴關(guān)系。當(dāng)執(zhí)行一個(gè)目標(biāo)時(shí),必須先執(zhí)行它們依賴的目標(biāo)。
           
          例子:一個(gè)典型的構(gòu)建文件
          <?xml version="1.0" ?>
          <project name="OurProject" default="deploy">
          <target name="init">
          <mkdir dir="build/classes" />
          <mkdir dir="dist" />
          </target>
          <target name="compile" depends="init" >
          <javac srcdir="src" destdir="build/classes"/>
          </target>
          <target name="doc" depends="init" >
          <javadoc destdir="build/classes" sourcepath="src" packagenames="org.*" />
          </target>
          <target name="deploy" depends="compile,doc" >
              <jar destfile="dist/project.jar" basedir="build/classes"/>
                   <ftp server="" userid="" password="">
               <fileset dir="dist"/>
          </ftp>
          </target>
          </project>
           
          該構(gòu)建過(guò)程如下:
          系統(tǒng)初始化1、編譯  2、生成JAVADOC   4、打包  5、上傳到FTP,其中后兩步結(jié)合到一起叫部署。
           
          執(zhí)行時(shí)輸出如下:
          > ant -propertyfile ftp.properties
          Buildfile: build.xml
          init:
          [mkdir] Created dir: /home/ant/Projects/OurProject/build/classes
          [mkdir] Created dir: /home/ant/Projects/OurProject/dist
          compile:
          [javac] Compiling 1 source file to /home/ant/Projects/OurProject/build/
          classes
          doc:
          [javadoc] Generating Javadoc
          [javadoc] Javadoc execution
          [javadoc] Loading source files for package org.example.antbook.lesson1...
          [javadoc] Constructing Javadoc information...
          [javadoc] Building tree for all the packages and classes...
          [javadoc] Building index for all the packages and classes...
          [javadoc] Building index for all classes...
          deploy:
          [jar] Building jar: /home/ant/Projects/OurProject/dist/project.jar
          [ftp] sending files
          [ftp] 1 files sent
          BUILD SUCCESSFUL
          Total time: 5 seconds.

          在執(zhí)行時(shí)使用命令行參數(shù)以傳入一個(gè)屬性文件,屬性文件中包含連接FTP服務(wù)器使用的服務(wù)器名,用戶名,用戶密碼來(lái)給特性使用。
          這個(gè)例子很好的展示了Ant的一些基本要素:目標(biāo)依賴、特性的使用、編譯、文檔生成、JAR打包(tar,Zip,WAR,EAR等),最后是部署。
           
          Ant的簡(jiǎn)單任務(wù)(<mkdir>)都是由Java類(lèi)庫(kù)來(lái)實(shí)現(xiàn)相應(yīng)的功能。而一些復(fù)雜的任務(wù)<ftp>、<junit>還需要第三方庫(kù)的支持。
           
              Ant的一個(gè)強(qiáng)大之處:它總能工作。只要正確的指定構(gòu)建文件,Ant就能計(jì)算出目標(biāo)的依賴性,并且按照正確的順序調(diào)用目標(biāo)。目標(biāo)通過(guò)任務(wù)按序執(zhí)行,而任務(wù)自身處理其文件依賴性以及實(shí)際的操作來(lái)完成工作。因?yàn)槊總€(gè)任務(wù)通常都是在高層陳述,所以一兩行XML語(yǔ)句經(jīng)常就已經(jīng)足夠描述任務(wù)的內(nèi)容。
           
          4.   下載并安裝Ant
               使用Ant前提條件,系統(tǒng)中已經(jīng)安裝JDK以及Ant。在文檔編寫(xiě)之時(shí),Ant的最新版本是Ant 1.7,但是為了穩(wěn)定性,本文檔使用版本為Ant 1.6.5.
          首先下載Ant,到apache軟件網(wǎng)站http://www.apache.org/
          其次,解壓縮文件,放到指定的系統(tǒng)目錄中,例如C:\Ant。
          再次,將其添加到path,以便從命令行使用。(一些IDE,例如Eclipse可以不需要設(shè)置path,而通過(guò)IDE相關(guān)設(shè)置將Ant添加到path中。)
          再次,設(shè)置一些環(huán)境變量指向JDK以及ANT。
          最后,添加需要的可選庫(kù)。
           
          在Windows安裝過(guò)程(以筆者的安裝過(guò)程為例)
              下載apache-ant-1.6.5-bin.zip到本地硬盤(pán),解壓縮之后將文件夾命名為Ant,放在C:\Ant中。這個(gè)目錄就是Ant主目錄。
          應(yīng)該將主目錄中的bin目錄添加到path屬性中,這樣就可以在命令行中調(diào)用ant命令,ANT_HOME是批處理文件所在目錄的上級(jí)目錄。最好明確設(shè)定。
          現(xiàn)在許多工具已經(jīng)集成了特定版本的Ant,一些操作系統(tǒng)甚至默認(rèn)的已經(jīng)安裝了Ant。所以,你的系統(tǒng)中可能已經(jīng)安裝了Ant
          首先可以通過(guò)運(yùn)行以下命令:
          ant -version

          ant -diagnostics
          來(lái)確定。我們推薦您不設(shè)置CLASSPATH來(lái)運(yùn)行Ant命令。如果任何版本的Ant可以從CLASSPATH加載 ,這時(shí)就會(huì)由于加載了不兼容的類(lèi)而產(chǎn)生許多錯(cuò)誤。
           
          一些其他問(wèn)題請(qǐng)參閱Ant的FAQ設(shè)置。
          正常情況下,執(zhí)行ant ?Cversion即可顯示Ant版本,則說(shuō)明安裝配制成功:

           
          5.       運(yùn)行第一個(gè)構(gòu)建文件:
          首先創(chuàng)建一個(gè)Java工程,名為AntProject,工程中源文件和目標(biāo)文件是分開(kāi)的,分別為文件夾src和bin,然后創(chuàng)建一個(gè)Java類(lèi)文件,類(lèi)名為
          com.neusoft.test.AntTest,只是為了測(cè)試,所以類(lèi)的內(nèi)容很簡(jiǎn)單:
          package com.neusoft.test;
          /**
           *This is just a test class.
           */
          public class AntTest{
                public static void main(String[] args){
                     for(int i=0;i<args.length;i++){
                           System.out.println(args[i]);
                     }
                }
          }
           
          然后我們?cè)诠こ痰穆窂较旅娼⒁粋€(gè)構(gòu)建文件build.xml,內(nèi)容如下:
          <?xml version="1.0" ?>
          <project name="structured" default="archive" >
          <target name="init">
          <mkdir dir="build/classes" />
          <mkdir dir="dist" />
          </target>
          <target name="compile" depends="init" >
            <javac srcdir="src" destdir="build/classes"/>
          </target>
          <target name="archive" depends="compile" >
          <jar destfile="dist/project.jar"
          basedir="build/classes" />
          </target>
          <target name="clean" depends="init">
          <delete dir="build" />
          <delete dir="dist" />
          </target>
          </project>
          構(gòu)建文件說(shuō)明如下圖:


          關(guān)于XML的知識(shí),請(qǐng)參考其他書(shū)籍,這里不做介紹。
          以上創(chuàng)建完成后,目錄結(jié)構(gòu)如下圖:


           
               Ant構(gòu)建文件總是有一個(gè)<project>元素做為根元素,它有兩個(gè)屬性,name和default,<target>元素是<project>元素的子元素,可以有多個(gè),它有兩個(gè)屬性,name和depends,<target>元素包含的元素就是一些任務(wù)元素。

          <target>可以由命令行進(jìn)行顯示的調(diào)用,也可以在內(nèi)部使用如可以直接調(diào)用ant init、ant compile等。如果不寫(xiě)參數(shù),則默認(rèn)的build文件是build.xml,默認(rèn)的目標(biāo)是<project>的default屬性定義的目標(biāo)。目標(biāo)的名稱(chēng)是唯一的,可以是任意字符串。
           
          下面我們先運(yùn)行一下這個(gè)Ant構(gòu)建,再講解其他的內(nèi)容,進(jìn)入工程目錄,執(zhí)行
          ant
          這里就相當(dāng)于執(zhí)行默認(rèn)的目標(biāo),也就是<project name="structured" default="archive" >中的archive目標(biāo)。

           
          這里說(shuō)明了首先初始化創(chuàng)建兩個(gè)目錄,然后編譯了一個(gè)JAVA文件,然后進(jìn)行了打包的操作。
           
          這里講解一下如果構(gòu)建失敗了怎么辦?
          首先有可能是XML語(yǔ)法書(shū)寫(xiě)不正確(將<target>寫(xiě)成<targe>),或者在任務(wù)執(zhí)行過(guò)程中出現(xiàn)了錯(cuò)誤(.java文件中包含編譯錯(cuò)誤),或者任務(wù)名稱(chēng)書(shū)寫(xiě)錯(cuò)誤(將<javac>寫(xiě)成<javacc>)等等,這些都不是Ant的錯(cuò)誤,不需要填寫(xiě)B(tài)ug Report。寫(xiě)XML時(shí)一定要細(xì)心,一些IDE已經(jīng)有驗(yàn)證功能,可以很好的防止書(shū)寫(xiě)的錯(cuò)誤。
           
          出現(xiàn)錯(cuò)誤時(shí),可以使用
          ant ?Cverbose
          或者
          ant ?Cdebug來(lái)獲取更加詳細(xì)的構(gòu)建信息,以解決問(wèn)題。
          下圖是使用ant ?Cverbose時(shí)的輸出,使用ant ?Cdebug將獲取比這更詳細(xì)的信息,這里就不舉例了。

           
          本例中直接使用了軟件工程中的構(gòu)建結(jié)構(gòu),使用src作為源文件目錄,build/class作為中間生成文件,以dist作為可發(fā)布文件。在最后把一些可執(zhí)行文件可以放在bin目錄中。此時(shí)目錄結(jié)構(gòu)如下圖所示:

           
          我們需要一種辦法來(lái)確定某些任務(wù)先執(zhí)行,而有些任務(wù)后執(zhí)行,比如必須先編譯,才能執(zhí)行程序或者打包。我們?cè)诼暶髂繕?biāo)的時(shí)候,就在其依賴屬性中列出其依賴關(guān)系:
          <target name="compile" depends="init" >
          <target name="archive" depends="compile" >
          <target name="clean" depends="init">
          如果一個(gè)目標(biāo)依賴與多個(gè)其他目標(biāo),需要將它們都寫(xiě)到依賴屬性中,例如:
          depents=”compile,test”。在我們的構(gòu)建中,archive依賴于init和compile,但是我們不需要去寫(xiě),因?yàn)閏ompile已經(jīng)依賴于init了。即:Ant的依賴關(guān)系是傳遞的,但不是自反的。


          如果在執(zhí)行過(guò)程中兩個(gè)目標(biāo)共享同一個(gè)目標(biāo),則先導(dǎo)目標(biāo)只被執(zhí)行一次。
          可以通過(guò)指定目標(biāo)來(lái)運(yùn)行構(gòu)建:
          例如執(zhí)行完ant后,可以執(zhí)行ant clean來(lái)清理構(gòu)建:

           
          ant等價(jià)于ant archive
          ant init
          ant clean
          ant compile
          ant archive
          ant clean archive
           
          當(dāng)構(gòu)建完成一次以后,再次執(zhí)行構(gòu)建會(huì)發(fā)生什么呢?

           
          第二次執(zhí)行構(gòu)建時(shí)只花了2s,相比第一次的4s。并且沒(méi)有任何一個(gè)目標(biāo)表示做了任何工作。
          原因如下:所有的任務(wù)都檢查了它們的依賴關(guān)系:
          <mkdir>沒(méi)有創(chuàng)建目錄因?yàn)橐呀?jīng)存在
          <javac>比較了源文件和類(lèi)文件的時(shí)間戳
          <jar>比較了要被加入文件與已經(jīng)存在文件的時(shí)間
          只有更新的時(shí)候才進(jìn)行任務(wù)執(zhí)行。
           
          Ant如何處理命令行上的多個(gè)目標(biāo)?
          執(zhí)行ant compile archive會(huì)怎么樣?
          先實(shí)驗(yàn)一下:

           
          Ant依次執(zhí)行每個(gè)目標(biāo)和其依賴目標(biāo),即Ant的執(zhí)行順序是init compile init compile archive,雖然這樣看起來(lái)增加了額外的工作,但是通過(guò)上面的執(zhí)行過(guò)程就會(huì)發(fā)現(xiàn),由于其依賴性檢查的阻止,第二次的init和compile并未真正的執(zhí)行,執(zhí)行時(shí)間與直接執(zhí)行archive的時(shí)間是一樣的。
           
          運(yùn)行程序:
          普通執(zhí)行該類(lèi)的方法是:
          java ?Ccp build/class com.neusoft.test.AntTest args1 args2
          而我們使用Ant的任務(wù)來(lái)執(zhí)行它僅僅需要增加一個(gè)任務(wù),好處在于:
          讓用于執(zhí)行的目標(biāo)依賴與編譯的目標(biāo),確保運(yùn)行最新版本
          易于傳遞復(fù)雜參數(shù)
          設(shè)置classpath更方便
          在Ant自身的JVM中運(yùn)行,載入更快
          增加一個(gè)新的目標(biāo):
          <target name="execute" depends="compile">
          <java classname="com.neusoft.test.AntTest"
          classpath="build/classes">
          <arg value="a"/>
          <arg value="b"/>
          <arg file="."/>
          </java>
          </target>
           
          最后一個(gè)參數(shù)是file=”.”,表示傳入的參數(shù)是一個(gè)目錄,為文件絕對(duì)路徑。
          運(yùn)行該目標(biāo),輸出如下:

           
          Ant命令行選項(xiàng):
           
          請(qǐng)參閱相關(guān)手冊(cè)進(jìn)行查詢相關(guān)選項(xiàng)的功能。
           
          當(dāng)有多個(gè)構(gòu)建文件時(shí),可以指定構(gòu)建文件:
          ant ?Cbuildfile build.xml compile
          來(lái)表示執(zhí)行build.xml這個(gè)構(gòu)建文件中的compile目標(biāo)。
           
          控制提供的信息量:
          ant ?Cquiet:安靜模式,不給出任何輸出。

           
          ant ?Cemacs:簡(jiǎn)單模式,不顯示任務(wù)名稱(chēng)。

           
          ant ?Cprojecthelp:獲取項(xiàng)目信息。

           
          最終的構(gòu)建文件,添加了description屬性。
          <?xml version="1.0" ?>
          <project name="secondbuild" default="execute" >
          <description>Compiles and runs a simple program</description>
          <target name="init">
          <mkdir dir="build/classes" />
          <mkdir dir="dist" />
          </target>
          <target name="compile" depends="init"
          description="Compiles the source code">
          <javac srcdir="src" destdir="build/classes"/>
          </target>
          <target name="archive" depends="compile"
          description="Creates the JAR file">
          <jar destfile="dist/project.jar" basedir="build/classes"/>
          </target>
          <target name="clean" depends="init"
          description="Removes the temporary directories used">
          <delete dir="build" />
          <delete dir="dist" />
          </target>
          <target name="execute" depends="compile"
          description="Runs the program">
          <echo level="warning" message="running" />
          <java classname="org.example.antbook.lesson1.Main"
          classpath="build/classes">
          <arg value="a"/>
          <arg value="b"/>
          <arg file="."/>
          </java>
          </target>

          </project>

          posted on 2008-04-21 16:19 lk 閱讀(625) 評(píng)論(0)  編輯  收藏 所屬分類(lèi): j2se
          主站蜘蛛池模板: 嘉禾县| 新闻| 措美县| 玉溪市| 吴川市| 乐亭县| 邳州市| 平度市| 开封县| 中牟县| 嘉禾县| 泰兴市| 双鸭山市| 霍林郭勒市| 南陵县| 杨浦区| 藁城市| 彝良县| 商水县| 乌拉特中旗| 定安县| 抚顺县| 汉阴县| 隆回县| 西宁市| 稷山县| 佛山市| 民勤县| 巴林右旗| 琼海市| 新和县| 托克托县| 祁门县| 抚顺县| 光泽县| 儋州市| 那曲县| 辰溪县| 盐城市| 恭城| 仁化县|