Ant的最完整build.xml解釋

1、ant 的概念make 命令是一個項目管理工具，而 ant 所實現(xiàn)功能與此類似。像 make，gnumake 和 nmake這些編譯工具都有一定的缺陷，但是 ant 卻克服了這些工具的缺陷。最初 ant 開發(fā)者在開發(fā)跨平臺的應(yīng)用時，用樣也是基于這些缺陷對ant 做了更好的設(shè)計。ant 與 makefile makefile 有一些不足之處，比如很多人都會碰到的煩人的tab 問題。最初的ant 開發(fā)者多次強調(diào) ” 只是我在tab 前面加了一個空格，所以我的命令就不能執(zhí)行” 。有一些工具在一定程度上解決了這個問題，但還是有很多其他的問題。ant 則與一般基于命令的工具有所不同，它是 java類的擴

2、展。 ant 運行需要的xml 格式的文件不是shell 命令文件。它是由一個project組成的，而一個project 又可分成可多target ，target 再細分又分成很多task，每一個 task 都是通過一個實現(xiàn)特定接口的java 類來完成的。ant 的優(yōu)點ant 是 apache 軟件基金會jakarta 目錄中的一個子項目，它有以下的優(yōu)點。跨平臺性。 ant 是存 java語言編寫的，所示具有很好的跨平臺性。操作簡單。 ant 是由一個內(nèi)置任務(wù)和可選任務(wù)組成的。ant 運行時需要一個xml 文件 (構(gòu)建文件 )。ant 通過調(diào)用target 樹，就可以執(zhí)行各種task。每個 t

3、ask 實現(xiàn)了特定接口對象。由于ant 構(gòu)建文件時xml 格式的文件，所以和容易維護和書寫，而且結(jié)構(gòu)很清晰。ant 可以集成到開發(fā)環(huán)境中。由于ant 的跨平臺性和操作簡單的特點，它很容易集成到一些開發(fā)環(huán)境中去。ant 開發(fā)ant 的構(gòu)建文件當開始一個新的項目時，首先應(yīng)該編寫ant 構(gòu)建文件。 構(gòu)建文件定義了構(gòu)建過程，并被團隊開發(fā)中每個人使用。ant 構(gòu)建文件默認命名為build.xml ，也可以取其他的名字。只不過在運行的時候把這個命名當作參數(shù)傳給ant。構(gòu)建文件可以放在任何的位置。一般做法是放在項目頂層目錄中，這樣可以保持項目的簡潔和清晰。下面是一個典型的項目層次結(jié)構(gòu)。(1) src存放文件

4、。(2) class存放編譯后的文件。(3) lib 存放第三方j(luò)ar包。(4) dist 存放打包，發(fā)布以后的代碼。ant 構(gòu)建文件是xml 文件。每個構(gòu)建文件定義一個唯一的項目(project 元素 )。每個項目下可以定義很多目標(target元素 )，這些目標之間可以有依賴關(guān)系。當執(zhí)行這類目標時，需要執(zhí)行他們所依賴的目標。 每個目標中可以定義多個任務(wù)，目標中還定義了所要執(zhí)行的任務(wù)序列。ant 在構(gòu)建目標時必須調(diào)用所定義的任務(wù)。任務(wù)定義了ant 實際執(zhí)行的命令。ant 中的任務(wù)可以為 3 類。（1） 核心任務(wù)。核心任務(wù)是ant 自帶的任務(wù)。（2） 可選任務(wù)。可選任務(wù)實來自第三方的任務(wù)，因此

5、需要一個附加的jar文件。（3） 用戶自定義的任務(wù)。用戶自定義的任務(wù)實用戶自己開發(fā)的任務(wù)。1. 標簽每個構(gòu)建文件對應(yīng)一個項目。標簽時構(gòu)建文件的根標簽。它可以有多個內(nèi)在屬性，就如代碼中所示，其各個屬性的含義分別如下。(1) default 表示默認的運行目標，這個屬性是必須的。(2) basedir 表示項目的基準目錄。(3) name 表示項目名。(4) description 表示項目的描述。每個構(gòu)建文件都對應(yīng)于一個項目，但是大型項目經(jīng)常包含大量的子項目，每一個子項目都可以有自己的構(gòu)建文件。2. 標簽一個項目標簽驢梢雜幸桓齷蚨喔?/spantarget 標簽。一個target 標簽可以依賴其

6、他的target標簽。例如，有一個target 用于編譯程序，另一個target 用于聲稱可執(zhí)行文件。在生成可執(zhí)行文件之前必須先編譯該文件，因策可執(zhí)行文件的target 依賴于編譯程序的target 。t arget的所有屬性如下。(1).name 表示標明，這個屬性是必須的。(2).depends 表示依賴的目標。(3)if 表示僅當屬性設(shè)置時才執(zhí)行。(4)unless 表示當屬性沒有設(shè)置時才執(zhí)行。(5)description 表示項目的描述。ant 的 depends 屬性指定了target 的執(zhí)行順序。ant 會依照 depends 屬性中 target 出現(xiàn)順序依次執(zhí)行每個target

7、。在執(zhí)行之前，首先需要執(zhí)行它所依賴的target。程序中的名為run 的target 的 depends 屬性 compile，而名為compile 的 target 的 depends 屬性是 prepare，所以這幾個 target 執(zhí)行的順序是prepare-compile-run 。一個 target 只能被執(zhí)行一次，即使有多個 target 依賴于它。如果沒有if 或 unless屬性， target 總會被執(zhí)行。3.標簽該標簽用于創(chuàng)建一個目錄，它有一個屬性dir 用來指定所創(chuàng)建的目錄名，其代碼如下：通過以上代碼就創(chuàng)建了一個目錄，這個目錄已經(jīng)被前面的property 標簽所指定。4標

8、簽該標簽用來生成一個jar文件，其屬性如下。(1) destfile 表示 jar文件名。(2) basedir 表示被歸檔的文件名。(3) includes 表示別歸檔的文件模式。(4) exchudes表示被排除的文件模式。5 該標簽用于編譯一個或一組java 文件，其屬性如下。(1).srcdir 表示源程序的目錄。(2).destdir 表示 class文件的輸出目錄。(3).include 表示被編譯的文件的模式。(4).excludes 表示被排除的文件的模式。(5).classpath 表示所使用的類路徑。(6).debug 表示包含的調(diào)試信息。(7).optimize 表示是否

9、使用優(yōu)化。(8).verbose 表示提供詳細的輸出信息。(9).fileonerror 表示當碰到錯誤就自動停止。6標簽該標簽用來執(zhí)行編譯生成的.class文件，其屬性如下。(1).classname 表示將執(zhí)行的類名。(2).jar 表示包含該類的jar文件名。(3).classpath 所表示用到的類路徑。(4).fork 表示在一個新的虛擬機中運行該類。(5).failonerror 表示當出現(xiàn)錯誤時自動停止。(6).output 表示輸出文件。(7).append 表示追加或者覆蓋默認文件。7.標簽該標簽用于刪除一個文件或一組文件，去屬性如下。(1)/file 表示要刪除的文件。(2

10、).dir 表示要刪除的目錄。(3).includeemptydirs 表示指定是否要刪除空目錄，默認值是刪除。(4).failonerror 表示指定當碰到錯誤是否停止，默認值是自動停止。(5).verbose 表示指定是否列出所刪除的文件，默認值為不列出。8.標簽該標簽用于文件或文件集的拷貝，其屬性如下。(1).file 表示源文件。(2).tofile 表示目標文件。(3).todir 表示目標目錄。(4).overwrite 表示指定是否覆蓋目標文件，默認值是不覆蓋。(5).includeemptydirs 表示制定是否拷貝空目錄，默認值為拷貝。(6).failonerror 表示指定

11、如目標沒有發(fā)現(xiàn)是否自動停止，默認值是停止。(7).verbose 表示制定是否顯示詳細信息，默認值不顯示。ant 的數(shù)據(jù)類型在 構(gòu) 建 文 件 中 為 了 標 識 文 件或 文 件 組 ， 經(jīng) 常 需 要使 用 數(shù) 據(jù) 類 型 。 數(shù)據(jù) 類 型 包 含 在org.apache.tool.ant.types包中。下面簡單介紹構(gòu)建文件中常用的數(shù)據(jù)類型。1. argument 類型由 ant 構(gòu)建文件調(diào)用的程序，可以通過 元素向其傳遞命令行參數(shù)，如 apply,exec 和 java任務(wù)均可接受嵌套元素，可以為各自的過程調(diào)用指定參數(shù)。以下是的所有屬性。(1).values 是一個命令參數(shù)。如果參數(shù)種

12、有空格，但又想將它作為單獨一個值，則使用此屬性。(2).file 表示一個參數(shù)的文件名。在構(gòu)建文件中，此文件名相對于當前的工作目錄。(3).line 表示用空格分隔的多個參數(shù)列表。(4).path 表示路徑。2.ervironment 類型由 ant 構(gòu)建文件調(diào)用的外部命令或程序，元素制定了哪些環(huán)境變量要傳遞給正在執(zhí)行的系統(tǒng)命令，元素可以接受以下屬性。(1).file 表示環(huán)境變量值得文件名。此文件名要被轉(zhuǎn)換位一個絕對路徑。(2).path 表示環(huán)境變量的路徑。ant 會將它轉(zhuǎn)換為一個本地約定。(3).value 表示環(huán)境變量的一個直接變量。(4).key 表示環(huán)境變量名。注意file pat

13、h 或 value 只能取一個。3.filelist 類型filelist 是一個支持命名的文件列表的數(shù)據(jù)類型，包含在一個filelist類型中的文件不一定是存在的文件。以下是其所有的屬性。(1).dir 是用于計算絕對文件名的目錄。(2).files 是用逗號分隔的文件名列表。(3).refid 是對某處定義的一個的引用。注意dir 和 files 都是必要的，除非指定了refid( 這種情況下， dir 和 files 都不允許使用)。4.fileset 類型fileset 數(shù)據(jù)類型定義了一組文件，并通常表示為元素。不過，許多ant 任務(wù)構(gòu)建成了隱式的fileset,這說明他們支持所有的f

14、ileset 屬性和嵌套元素。以下為 fileset 的屬性列表。(1).dir 表示 fileset 的基目錄。(2).casesensitive 的值如果為false，那么匹配文件名時，fileset 不是區(qū)分大小寫的，其默認值為 true. (3).defaultexcludes 用來確定是否使用默認的排除模式，默認為true 。(4).excludes 是用逗號分隔的需要派出的文件模式列表。(5).excludesfile 表示每行包含一個排除模式的文件的文件名。(6).includes 是用逗號分隔的，需要包含的文件模式列表。(7).includesfile 表示每行包括一個包含模式

15、的文件名。5.patternset 類型fileset 是對文件的分組， 而 patternset 是對模式的分組， 他們是緊密相關(guān)的概念。支持 4 個屬性： includes excludex includexfile 和 excludesfile,與 fileset 相同。 patternset 還允許以下嵌套元素：include,exclude,includefile 和 excludesfile. 6.filterset 類型filterset 定義了一組過濾器，這些過濾器將在文件移動或復(fù)制時完成文件的文本替換。主要屬性如下：(1).begintoken 表示嵌套過濾器所搜索的記號，這

16、是標識其開始的字符串。(2).endtoken 表示嵌套過濾器所搜索的記號這是標識其結(jié)束的字符串。(3).id 是過濾器的唯一標志符。(4).refid 是對構(gòu)建文件中某處定義一個過濾器的引用。7.path 類型path 元素用來表示一個類路徑，不過它還可以用于表示其他的路徑。在用作揖個屬性時，路經(jīng)中的各項用分號或冒號隔開。在構(gòu)建的時候， 此分隔符將代替當前平臺中所有的路徑分隔符，其擁有的屬性如下。(1).location 表示一個文件或目錄。ant 在內(nèi)部將此擴展為一個絕對路徑。(2).refid 是對當前構(gòu)建文件中某處定義的一個path 的引用。(3).path 表示一個文件或路徑名列表。

17、8.mapper 類型mapper 類型定義了一組輸入文件和一組輸出文件間的關(guān)系，其屬性如下。(1).classname 表示實現(xiàn)mapper類的類名。當內(nèi)置mapper 不滿足要求時，用于創(chuàng)建定制mapper. (2).classpath 表示查找一個定制mapper 時所用的類型路徑。(3).classpathref 是對某處定義的一個類路徑的引用。(4).from 屬性的含義取決于所用的mapper. (5).to 屬性的含義取決于所用的mapper. (6).type 屬性的取值為identity ，flatten glob merge regexp 其中之一，它定義了要是用的內(nèi)置 m

18、apper 的類型。ant 的運行安裝好 ant 并且配置好路徑之后，在命令行中切換到構(gòu)建文件的目錄，輸入 ant 命令就可以運行 ant.若沒有指定任何參數(shù)，ant 會在當前目錄下查詢build.xml 文件。如果找到了就用該文件作為構(gòu)建文件。如果使用了 find 選項， ant 就會在上級目錄中找構(gòu)建文件，直至到達文件系統(tǒng)得跟目錄。如果構(gòu)建文件的名字不是build.xml ，則 ant 運行的時候就可以使用 buildfile file , 這里 file 指定了要使用的構(gòu)建文件的名稱，示例如下：ant 如 下 說 明 了 表 示 當 前 目 錄 的 構(gòu)建 文 件 為build.xml 運

19、 行ant 執(zhí) 行 默 認 的 目 標 。 ant buildfile test.xml 使用當前目錄下的test.xml 文件運行ant ,執(zhí)行默認的目標. xml 代碼1. 2. 13. !- 14. 文檔結(jié)構(gòu)為 : 15. 16. 全局變量的定義17. . 18.19. 任務(wù)組 (tasks) 20. 一項 javac任務(wù)21. . 22. 一項其它任務(wù)23. 24.25. 26. 27. . 28. 29. 30. 31.32. project 代表一個項目，33. default: 運行到名稱為dist 的 target(任務(wù)組 ) 34. basedir:基準路徑。35. - 36

20、. 37.38. !- 39. = 40. 定義屬性（ property tasks）41. 最好把用到的路徑呀，名稱呀都在這里定義成全局變量42. 例：定義43. 44. 以后就可以這樣用它：45. 46. 現(xiàn)在 :b=hello/b 47. = 48. - 49.50. 51. 52. 53. 54.55. 56. 57. 58. 59.60. 61. 62. 63. 64.65. 66. 67.68. 69. 70. 71. 72. 73. 74.75. 76. 77. 78. 79. 80.81. 82. 83.84. !- 85. 定義一組路徑以后可以通過id 重用這組路徑，例：86

21、. 87. 88. 89. - 90. 91. 92. 93. 94. 95.96. 102. 103. 104. 105. 106.107. 108. 109. 110. 111. 112. 113.114. 115. 116. 117.118. 119.120. 125. 126. 127. 128. 129. 130. 131.132. 138. 139. 140. 141.142. 147. creates the api documentation 150. 151. 152. 153. 154.155. 163. !cdatahello ant docs api 164. !cda

22、ta$app.copyright 165. 166. 167. 168.169. 175. 176. 177. 178. 179. 180. 181. 182. 183. 184. 185. 186. 187.188. 189. 195. 趁熱打鐵，接著上面的再發(fā)一個實例：xml 代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42

23、. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. clean output dirs/ 71. compile main java sources and copy libraries/ 72. build the web application archive/ 73. clean, build, warfile/ 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. 84. 85. 86.

24、 88. 89. 90. 91. 92. 93. 94. 95. 96. 97. 98. 99. 100. 101. 102. 103. 104. 105. 106. 107. 108.109. 110. 111. 112. 117. 118. 119. 120. 121. 122. 123. 124. 125. 126. 127. 128. 129. 130. 131. 132. 133. 134. 135. 在 eclipse中使用 ant ant 是 java 平臺下非常棒的批處理命令執(zhí)行程序，能非常方便地自動完成編譯，測試，打包，部署等等一系列任務(wù)，大大提高開發(fā)效率。如果你現(xiàn)在還沒有開

25、始使用 ant，那就要趕快開始學(xué)習(xí)使用，使自己的開發(fā)水平上一個新臺階。eclipse中已經(jīng)集成了ant，我們可以直接在eclipse 中運行 ant。以前面建立的hello 工程為例，創(chuàng)建以下目錄結(jié)構(gòu)：新建一個build.xml，放在工程根目錄下。build.xml 定義了ant 要執(zhí)行的批處理命令。雖然ant 也可以使用其它文件名，但是遵循標準能更使開發(fā)更規(guī)范，同時易于與別人交流。通常， src 存放 java源文件， classes存放編譯后的class文件， lib 存放編譯和運行用到的所有 jar 文件， web 存放 jsp等 web 文件， dist 存放打包后的jar 文件， d

26、oc 存放 api文檔。然后在根目錄下創(chuàng)建build.xml 文件，輸入以下內(nèi)容：xml 代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. * 42. * one or more tests failed! check the output . * 43. * 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 5

27、6. 57. 62. 63. 64. 65. !cdatahello, test 66. !cdataall rights reserved. 67. 68. 69. 70. 以上 xml 依次定義了init（初始化），compile（編譯）， test（測試），doc（生成文檔） ，pack（打包）任務(wù)，可以作為模板。選中 hello 工程，然后選擇“project ”，“properties ”，“builders ”，“new ”，選擇 “ant build ”：填入 name：ant_builder； buildfile：build.xml ；basedirectory： $works

28、pace_loc: /hello （按“ browseworkspace ”選擇工程根目錄），由于用到了junit.jar包，搜索eclipse 目錄，找到j(luò)unit.jar ，把它復(fù)制到hello/lib 目錄下，并添加到ant 的 classpath中：然后在 builder 面板中鉤上ant_build，去掉 java builder：再次編譯，即可在控制臺看到ant 的輸出：buildfile: f:eclipse-projectshellobuild.xml init: compile: mkdir created dir: f:eclipse-projectshelloclasses javac compiling 2 source files to f:eclipse-projectshelloclasses test: mkdir created dir: f:eclipse-projectshelloreport junit running example.hellotest junit tests run: 1, failures: 0, errors: 0, time elapsed: 0.02 secpack: mkdir created dir: f:eclipse-p