Ant在Java项目中的使用（一眼就看会）
參考：http://www.cnblogs.com/zhengqiang/p/5557155.html
?
Ant是跨平臺的構(gòu)建工具，它可以實現(xiàn)項目的自動構(gòu)建和部署等功能。在本文中，主要讓讀者熟悉怎樣將Ant應(yīng)用到Java項目中，讓它簡化構(gòu)建和部署操作。
?
一、安裝與部署
?
1.1?下載
?
下載地址：https://archive.apache.org/dist/ant/binaries/
?
我下載的是1.7.1版本。解壓到某個目錄（例如D:\ant-1.7.1），即可使用。
?
1.1?配置環(huán)境變量
?
1、添加系統(tǒng)環(huán)境變量：ANT_HOME，該變量指向Ant解壓后的根目錄，在此為D:\ant-1.7.1
?
2、在系統(tǒng)環(huán)境變量path中添加Ant的bin目錄：D:\ant-1.7.1\bin
?
驗證：在DOS窗口輸入 ?ant ?-version ?，出現(xiàn)下面結(jié)果
二、Ant關(guān)鍵元素
?
Ant的構(gòu)建文件是基于XML編寫的，默認名稱為build.xml.為了更清楚的了解Ant,在這里編寫一個簡單的Ant程序，
用來展現(xiàn)Ant的功能，讓讀者對Ant有一個初步的了解。首先在D盤下建立一個build.xml文件，內(nèi)容如下：
?
例子：
<?xml version="1.0"?> <project name="helloWorld"><target name="sayHelloWorld"><echo message="Hello,Amigo"/></target> </project>然后在命令行模式切換到D盤，運行ant sayHelloWorld命令，其中sayHelloWorld為需要執(zhí)行的任務(wù)的名稱。ant命令默認尋找build.xml文件。出現(xiàn)如下結(jié)果，證明正確:
接下來開始向讀者講解本節(jié)的重點：Ant的關(guān)鍵元素project、target、property和task
?
2.1 project元素
?
project元素是Ant構(gòu)建文件的根元素，Ant構(gòu)件文件至少應(yīng)該包含一個project元素，否則會發(fā)生錯誤。在每個project元素下，可包含多個target元素。接下來向讀者展示一下project元素的各屬性。
?
（1）name屬性
?
用于指定project元素的名稱。
?
（2）default屬性
?
用于指定project默認執(zhí)行時所執(zhí)行的target的名稱。
?
（3）basedir屬性
?
用于指定基路徑的位置。該屬性沒有指定時，使用Ant的構(gòu)件文件的附目錄作為基準(zhǔn)目錄。
?
例子：
?
修改上面的build.xml內(nèi)容如下：
<?xml version="1.0"?> <project name="projectStudy" default="sayBaseDir" basedir="D:\ant-1.7.1"><target name="sayBaseDir"><echo message = "The base dir is: ${basedir}" /></target> </project>在命令行模式輸入ant命令，此時沒有指定執(zhí)行的target名稱，成功出現(xiàn)以下結(jié)果：
?
從上面的內(nèi)容我們可以看出，在這里定義了default屬性的值為sayBaseDir，即 當(dāng)運行ant命令時，若未指明執(zhí)行的target時，默認執(zhí)行的target的sayBaseDir，同時還定義了basedir屬性的值為?D:\ant-1.7.1
2.2 target元素
?
它為Ant的基本執(zhí)行單元，它可以包含一個或多個具體的任務(wù)。多個target可以存在相互依賴關(guān)系。它有如下屬性：
?
（1）name屬性
?
指定target元素的名稱，這個屬性在一個project元素中是唯一的。我們可以通過指定target元素的名稱來指定某個target。
?
（2）depends屬性
?
用于描述target之間的依賴關(guān)系，若與多個target存在依賴關(guān)系時，需要以“,”間隔。Ant會依照depends屬性中target出現(xiàn)的順序依次執(zhí)行每個target。被依賴的target會先執(zhí)行。
?
（3）if屬性
?
用于驗證指定的屬性是否存在，若不存在，所在target將不會被執(zhí)行。
?
（4）unless屬性
?
該屬性的功能與if屬性的功能正好相反，它也用于驗證指定的屬性是否存在，若不存在，所在target將會被執(zhí)行。
?
（5）description屬性
?
該屬性是關(guān)于target功能的簡短描述和說明。
?
例子：
修改上面的build.xml如下：
<?xml version="1.0" ?><project name="targetStudy"><target name="targetA" if="ant.java.version"><echo message="Java Version" ${ant.java.version}"/></target><target name="targetB" depends="targetA" unless="amigo"><description>a depend example! </description><echo message="The base dir is: ${basedir}"/></target></project>命令行模式，進入D盤后運行ant targetB，結(jié)果如下：
?
分析結(jié)果后可以看到，我們運行的是名為targetB的target，因該target?依賴于targetA，所以targetA將首先被執(zhí)行，同時因為系統(tǒng)安裝了java環(huán)境，所以ant.java.version屬性存在，執(zhí)行了?targetA這個target，輸出信息：[echo] Java Version: 1.6，targetA執(zhí)行完畢后，接著執(zhí)行targetB，因為amigo不存在，而unless屬性是在不存在時進入所在的target的，由此可知?targetB得以執(zhí)行，輸出信息：The base dir is: D:\
2.3 property元素
該元素可看作參量或者參數(shù)的定義，project的屬性可以通過property元素來設(shè)定，也可在Ant之外設(shè)定。若要在外部引入某文件，例如build.properties文件，可以通過如下內(nèi)容將其引入：<property file=”build.properties”/>
property元素可用作task的屬性值。在task中是通過將屬性名放在“${”和“}”之間，并放在task屬性值的位置來實現(xiàn)的。
Ant提供了一些內(nèi)置的屬性，它能得到的系統(tǒng)屬性的列表與Java文檔中System.getPropertis()方法得到的屬性一致，這些系統(tǒng)屬性可參考sun網(wǎng)站的說明。
同時，Ant還提供了一些它自己的內(nèi)置屬性，如下：
basedir：project基目錄的絕對路徑，該屬性在講解project元素時有詳細說明;
ant.file：buildfile的絕對路徑，如上面的各例子中，ant.file的值為D:\build.xml;
ant.version：Ant的版本，在本文中，值為1.7.1;
ant.project.name：當(dāng)前指定的project的名字，即前文說到的project的name屬性的值;
ant.java.version：Ant檢測到的JDK的版本，在上例運行結(jié)果中可看到為1.6
例子：
修改D:\build.xml文件
<?xml version="1.0"?><project name="propertyStudy" default="example"><property name="name" value="amigo"/><property name="age" value="25"/><target name="example"><echo message="name: ${name}, age: ${age}"/></target></project>命令行模式，進入D盤后運行ant example，結(jié)果如下：
?
?
三、Ant的常用任務(wù)
在Ant工具中每一個任務(wù)封裝了具體要執(zhí)行的功能，是Ant工具的基本執(zhí)行單位。在本小節(jié)中，主要引導(dǎo)讀者來看下Ant的常用任務(wù)及其使用舉例。
3.1 copy任務(wù)
該任務(wù)主要用來對文件和目錄的復(fù)制功能。舉例如下：
（1）復(fù)制單個文件：
<copy file="file.txt" tofile="copy.txt"/>
（2）對文件目錄進行復(fù)制：
<copy todir="../newdir/dest_dir">
????<fileset dir="src_dir"/>
</copy>
（3）將文件復(fù)制到另外的目錄：
<copy file="file.txt" todir="../other/dir"/>
3.2 delete任務(wù)
對文件或目錄進行刪除，舉例如下：
（1）刪除某個文件：<delete file="photo/amigo.jpg"/>
（2）刪除某個目錄：<delete dir="photo"/>
（3）刪除所有的備份目錄或空目錄：
<delete includeEmptyDirs="true">
??????<fileset dir="." includes="**/*.bak"/>
</delete>
?
3.3 mkdir任務(wù)
創(chuàng)建目錄：<mkdir dir="build"/>
3.4 move任務(wù)
移動文件或目錄，舉例如下:
（1）移動單個文件：
<move file="fromfile" tofile=”tofile”/>
（2）移動單個文件到另一個目錄：
<move file="fromfile" todir=”movedir”/>
（3）移動某個目錄到另一個目錄：
<move todir="newdir">
?<fileset dir="olddir"/>
</move>
（4）echo任務(wù)
該任務(wù)的作用是根據(jù)日志或監(jiān)控器的級別輸出信息。它包括message、file、append和level四個屬性，舉例如下：
<echo message="Hello,Amigo" file="logs/system.log" append="true">
四、利用Ant構(gòu)建和部署Java工程
Ant可以代替使用javac、java和jar等命令來執(zhí)行java操作，從而達到輕松的構(gòu)建和部署Java工程的目的。下面來看幾個知識點。
4.1?利用Ant的javac任務(wù)來編譯java程序
（1）建立名為antstudy的Java工程，?src目錄為源代碼目錄，在src目錄下建立HelloWorld.java這個類文件
public class HelloWorld {public static void main(String[] args) {System.out.println("Hello, Amigo");} }(2) 在工程下新建build.xml文件
在該文件中編譯src目錄下的java文件，并將編譯后的class文件放入build/classes目錄中
build.xml中的內(nèi)容如下：
<?xml version="1.0"?> <project name="javaTest" default="compile" basedir="."><target name="clean"><delete dir="build"/></target><target name="compile" depends="clean"><mkdir dir="build/classes"/><javac srcdir="src" destdir="build/classes"/></target> </project>（3）在build.xml文檔上點右鍵，Run As --- Ant Build ;
運行該build.xml文件，可在工程中看到新增了build/classes目錄，并在該目錄中生成了編譯后的HelloWorld.class文件。
工程全部目錄如下圖所示：
?
4.2?使用Ant的java任務(wù)運行Java程序
?
Ant中可以使用java任務(wù)實現(xiàn)運行Java程序的功能。下面在上面的例子中進行如下的修改，修改后的build.xml文件的內(nèi)容如下
<?xml version="1.0"?> <project name="javaTest" default="run" basedir="."><target name="clean"><delete dir="build"/></target><target name="compile" depends="clean"><mkdir dir="build/classes"/><javac srcdir="src" destdir="build/classes"/></target><target name="run" depends="compile"><java classname="HelloWorld"><classpath><pathelement path="build/classes"/></classpath></java></target> </project>4.3?使用Ant的jar任務(wù)生成jar文件
讀者可以在上例的基礎(chǔ)上更進一步，來生成jar包，可在run這個target下再加上如下target：
此時將ant的project的default屬性設(shè)置為jar，同時運行該build.xml文件，運行完畢后，可看到在工程目錄下生成了一個jar包HelloWorld.jar，如下圖所示：
?
4.4?使用Ant的war任務(wù)打包J2EE Web項目
?
建立一個J2EE Web工程，其目錄結(jié)構(gòu)如下圖所示：
把上面的HelloWorld.java復(fù)制過來即可；
直接在工程下建立build.xml文件（工程名上點右鍵，新建xml文件），內(nèi)容如下：
?
?
WebContent下新建index.jsp，如下：
?
?
?
在build.xml上點擊右鍵Run As?——?Ant Build，即可生成War包；
運行該build文件，更新目錄后，可看到在build目錄下生成了antwebproject.war文件；
可以將該war包拷貝到Tomcat的目錄下看一下運行結(jié)果。
總結(jié)
以上是生活随笔為你收集整理的Ant在Java项目中的使用（一眼就看会）的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 关于Ant与Maven(一)
- 下一篇： Javaassist简介