一、Ant簡介
Ant是用來編譯/運行/測試java程序,構建、包裝和發佈過程中幾乎每一件事都可以由Ant的任務來處理.
二、Ant管理項目
當開始一個新的項目時,首先應該編寫Ant的構建文件,構建文件定義了構建過程,並被團隊開發中每個人使用。Ant構建文件的默認命名爲build.xml,也可以取其他的名字,只不過把這個命名當成參數傳遞給Ant,構建文件可以放置任何位置,一般是放到項目頂級目錄中, 這樣可以保持項目的整潔和清晰,下面是一個典型的項目層次結構,如下所示:
- build存放編譯的class文件和jsp文件。
- class存放編譯後的文件。
- src存放文件。
- lib存放第三方JAR包。
- dist存放打包,發佈以後的代碼
Ant構建文件是XML文件,每個構建文件定義一個唯一的項目(Project元素),每個項目下可以定義很多目標(target元素),這些目標元素可以有依賴關係,當執行這些目標元素時需要執行他們所依賴的目標元素,每個目標中可以定義多個任務,目標中還定義了所要執行的任務序列。Ant在構建目標時必須調用所定義的任務。任務定義了Ant實際執行的命令。Ant中的任務可以爲3類,如下所示:
- 核心任務。核心任務是Ant自帶的任務。
- 可選任務。可選任務實來自第三方的任務,因此需要一個附加的JAR文件。
- 用戶自定義的任務。用戶自定義的任務實用戶自己開發的任務。
1、<project>標籤
每個構建文件對應一個項目,project標籤是構建文件的跟標籤,它可以有多個內在屬性,各個屬性的含義分別如下所示:
- default表示默認的執行目標,這個屬性是必須的。
- basedir表示項目的基準路徑,這個屬性是必須的。
- name表示項目名稱。
- description表示項目的描述(或者是對這個標籤的作用進行表述)。
每個構建文件都對應於一個項目,但是大型項目經常包含大量的子項目,每一個子項目都可以有自己的構建文件。
2、<target>標籤
一個項目標籤下可以有一個或多個target標籤,一個target標籤可以依賴其他target標籤,target所有屬性如下所示:
- name表示這個標籤的名字,這個屬性是必須的。
- depends表示依賴的目標。
- if表示僅當屬性設置時才執行。
- unless表示當屬性沒有設置時才執行。
- description表示項目的描述(或者是對這個標籤的作用進行表述)。
Ant的depends屬性指定了target的執行順序,Ant會依照depends屬性中target標籤出現順序依次執行每個target,在執行之前首先執行它所依賴的target標籤,例如:
項目中的名爲run的target的depends屬性compile,而名爲compile的target的depends屬性是init,所以這幾個target標籤的執行順序是init—》compile—》run。一個target只能被執行一次,即使有多個target依賴於它。如果沒有if或unless屬性,target總會被執行。
3、<mkdir>標籤
該標籤用戶創建一個目錄,它有一個屬性dir用戶指定所創建的目錄,其代碼如下:
<mkdir dir="目錄名"/>
4、<jar>標籤
該標籤用來生成一個JAR包,其屬性如下:
- jarfile表示生產JAR文件名。
- basedir表示被歸檔的目錄。
- includes表示別歸檔的文件模式。
- exchudes表示被排除的文件模式。
5、<javac標籤>
該標籤用於編譯一個或一組java文件,其屬性如下:
- srcdir表示java源程序的目錄。
- destdir表示class文件的輸出目錄。
- includes表示別歸檔的文件模式。
- exchudes表示被排除的文件模式。
- debug表示包含的調試信息。
- optimize表示是否使用優化。
- classpath表示所使用的類路徑。
- verbose 表示提供詳細的輸出信息。
- fileonerror表示當碰到錯誤就自動停止。
6、<java>標籤
該標籤用來執行編譯生成的.class文件,其屬性如下:
- classname 表示將執行的類名。
- jar表示包含該類的JAR文件名。
- classpath所表示用到的類路徑。
- fork表示在一個新的虛擬機中運行該類。
- failonerror表示當出現錯誤時自動停止。
- output 表示輸出文件。
- append表示追加或者覆蓋默認文件。
7、<delete>標籤
該標籤用於刪除一個文件或一組文件,其屬性如下:
- file表示要刪除的文件。
- dir表示要刪除的目錄。
- includeEmptyDirs 表示指定是否要刪除空目錄,默認值是刪除。
- failonerror 表示指定當碰到錯誤是否停止,默認值是自動停止。
- verbose表示指定是否列出所刪除的文件,默認值爲不列出。
8、<copy>標籤
該標籤用於文件或文件集的拷貝,其屬性如下:
- file 表示源文件。
- tofile 表示目標文件。
- todir 表示目標目錄。
- overwrite 表示指定是否覆蓋目標文件,默認值是不覆蓋。
- includeEmptyDirs 表示制定是否拷貝空目錄,默認值爲拷貝。
- failonerror 表示指定如目標沒有發現是否自動停止,默認值是停止。
- verbose 表示制定是否顯示詳細信息,默認值不顯示。
9、<war>標籤
該標籤用來生成一個WAR包,其屬性如下:
- destfile表示生產JAR文件名。
- dir表示被歸檔的文件目錄。
- includes表示別歸檔的文件模式。
- exchudes表示被排除的文件模式。
10、<echo>標籤
該標籤用來在控制檯輸出信息,其輸入如下:
- message表示輸入的內容。
Ant的數據類型
在構建文件中爲了標識文件或文件組,經常需要使用數據類型。數據類型包含在
org.apache.tool.ant.types包中。簡單介紹構建文件中一些常用的數據類型。
1. argument 類型
由Ant構建文件調用的程序,可以通過<arg>元素向其傳遞命令行參數,如apply,exec和java任務均可接受嵌套<arg>元素,可以爲各自的過程調用指定參數。以下是<arg>的所有屬性:
- values 是一個命令參數,如果參數有空格,但又想將它作爲單獨一個值,則使用此屬性。
- file表示一個參數的文件名。在構建文件中,此文件名相對於當前的工作目錄。
- line表示用空格分隔的多個參數列表。
- path表示路徑。
2.ervironment 類型
由Ant構建文件調用的外部命令或程序,<env>元素制定了哪些環境變量要傳遞給正在執行的系統命令,<env>元素可以接受以下屬性:
- file表示環境變量值得文件名。此文件名要被轉換位一個絕對路徑。
- path表示環境變量的路徑。Ant會將它轉換爲一個本地約定。
- value 表示環境變量的一個直接變量。
- key 表示環境變量名。
注意 file path 或 value只能取一個。
3.filelist類型
Filelist 是一個支持命名的文件列表的數據類型,包含在一個filelist類型中的文件不一定是存在的文件。以下是其所有的屬性:
- dir是用於計算絕對文件名的目錄。
- files 是用逗號分隔的文件名列表。
- refid 是對某處定義的一個<filelist>的引用。
注意 dir 和 files 都是必要的,除非指定了refid(這種情況下,dir和files都不允許使用)。
4.fileset類型
Fileset 數據類型定義了一組文件,並通常表示爲<fileset>元素。不過,許多ant任務構建成了隱式的fileset,這說明他們支持所有的fileset屬性和嵌套元素。以下爲fileset 的屬性列表。
- dir表示fileset 的基目錄。
- casesensitive的值如果爲false,那麼匹配文件名時,fileset不是區分大小寫的,其默認值爲true.
- defaultexcludes 用來確定是否使用默認的排除模式,默認爲true。
- excludes 是用逗號分隔的需要派出的文件模式列表。
- excludesfile 表示每行包含一個排除模式的文件的文件名。
- includes 是用逗號分隔的,需要包含的文件模式列表。
- includesfile 表示每行包括一個包含模式的文件名。
5.patternset 類型 Fileset 是對文件的分組,而patternset是對模式的分組,他們是緊密相關的概念。
<patternset>支持4個屬性:includes excludex includexfile 和 excludesfile,與fileset相
同。Patternset 還允許以下嵌套元素:include,exclude,includefile 和 excludesfile.
6.filterset 類型
Filterset定義了一組過濾器,這些過濾器將在文件移動或複製時完成文件的文本替換。
主要屬性如下:
- begintoken 表示嵌套過濾器所搜索的記號,這是標識其開始的字符串。
- endtoken表示嵌套過濾器所搜索的記號這是標識其結束的字符串。
- id是過濾器的唯一標誌符。
- refid是對構建文件中某處定義一個過濾器的引用。
7.Path類型Path元素用來表示一個類路徑,不過它還可以用於表示其他的路徑。在用作多個屬性時,路徑中的各項用分號或冒號隔開。在構建的時候,此分隔符將代替當前平臺中所有的路徑分隔符,其擁有的屬性如下:
- location 表示一個文件或目錄。Ant在內部將此擴展爲一個絕對路徑。
- refid 是對當前構建文件中某處定義的一個path的引用。
- path表示一個文件或路徑名列表。
8.mapper類型Mapper類型定義了一組輸入文件和一組輸出文件間的關係,其屬性如下:
- classname 表示實現mapper類的類名。當內置mapper不滿足要求時,用於創建定製mapper.
- classpath表示查找一個定製mapper時所用的類型路徑。
- classpathref是對某處定義的一個類路徑的引用。
- from屬性的含義取決於所用的mapper.
- to屬性的含義取決於所用的mapper.
- type屬性的取值爲identity,flatten glob merge regexp 其中之一,它定義了要是用的內置mapper的類型。
本文轉載自:http://shawnfree.javaeye.com/blog/346328