Ant在Java项目中的使用(一眼就看会)
參考:http://www.cnblogs.com/zhengqiang/p/5557155.html
?
Ant是跨平臺的構(gòu)建工具,它可以實(shí)現(xiàn)項(xiàng)目的自動構(gòu)建和部署等功能。在本文中,主要讓讀者熟悉怎樣將Ant應(yīng)用到Java項(xiàng)目中,讓它簡化構(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
?
驗(yàn)證:在DOS窗口輸入 ?ant ?-version ?,出現(xiàn)下面結(jié)果
二、Ant關(guān)鍵元素
?
Ant的構(gòu)建文件是基于XML編寫的,默認(rèn)名稱為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盤,運(yùn)行ant sayHelloWorld命令,其中sayHelloWorld為需要執(zhí)行的任務(wù)的名稱。ant命令默認(rèn)尋找build.xml文件。出現(xiàn)如下結(jié)果,證明正確:
接下來開始向讀者講解本節(jié)的重點(diǎn):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默認(rèn)執(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)運(yùn)行ant命令時,若未指明執(zhí)行的target時,默認(rèn)執(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屬性
?
用于驗(yàn)證指定的屬性是否存在,若不存在,所在target將不會被執(zhí)行。
?
(4)unless屬性
?
該屬性的功能與if屬性的功能正好相反,它也用于驗(yàn)證指定的屬性是否存在,若不存在,所在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>命令行模式,進(jìn)入D盤后運(yùn)行ant targetB,結(jié)果如下:
?
分析結(jié)果后可以看到,我們運(yùn)行的是名為targetB的target,因該target?依賴于targetA,所以targetA將首先被執(zhí)行,同時因?yàn)橄到y(tǒng)安裝了java環(huán)境,所以ant.java.version屬性存在,執(zhí)行了?targetA這個target,輸出信息:[echo] Java Version: 1.6,targetA執(zhí)行完畢后,接著執(zhí)行targetB,因?yàn)閍migo不存在,而unless屬性是在不存在時進(jìn)入所在的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屬性值的位置來實(shí)現(xiàn)的。
Ant提供了一些內(nèi)置的屬性,它能得到的系統(tǒng)屬性的列表與Java文檔中System.getPropertis()方法得到的屬性一致,這些系統(tǒng)屬性可參考sun網(wǎng)站的說明。
同時,Ant還提供了一些它自己的內(nèi)置屬性,如下:
basedir:project基目錄的絕對路徑,該屬性在講解project元素時有詳細(xì)說明;
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的版本,在上例運(yùn)行結(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>命令行模式,進(jìn)入D盤后運(yùn)行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)對文件目錄進(jìn)行復(fù)制:
<copy todir="../newdir/dest_dir">
????<fileset dir="src_dir"/>
</copy>
(3)將文件復(fù)制到另外的目錄:
<copy file="file.txt" todir="../other/dir"/>
3.2 delete任務(wù)
對文件或目錄進(jìn)行刪除,舉例如下:
(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操作,從而達(dá)到輕松的構(gòu)建和部署Java工程的目的。下面來看幾個知識點(diǎn)。
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文檔上點(diǎn)右鍵,Run As --- Ant Build ;
運(yùn)行該build.xml文件,可在工程中看到新增了build/classes目錄,并在該目錄中生成了編譯后的HelloWorld.class文件。
工程全部目錄如下圖所示:
?
4.2?使用Ant的java任務(wù)運(yùn)行Java程序
?
Ant中可以使用java任務(wù)實(shí)現(xiàn)運(yùn)行Java程序的功能。下面在上面的例子中進(jìn)行如下的修改,修改后的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ǔ)上更進(jìn)一步,來生成jar包,可在run這個target下再加上如下target:
此時將ant的project的default屬性設(shè)置為jar,同時運(yùn)行該build.xml文件,運(yùn)行完畢后,可看到在工程目錄下生成了一個jar包HelloWorld.jar,如下圖所示:
?
4.4?使用Ant的war任務(wù)打包J2EE Web項(xiàng)目
?
建立一個J2EE Web工程,其目錄結(jié)構(gòu)如下圖所示:
把上面的HelloWorld.java復(fù)制過來即可;
直接在工程下建立build.xml文件(工程名上點(diǎn)右鍵,新建xml文件),內(nèi)容如下:
?
?
WebContent下新建index.jsp,如下:
?
?
?
在build.xml上點(diǎn)擊右鍵Run As?——?Ant Build,即可生成War包;
運(yùn)行該build文件,更新目錄后,可看到在build目錄下生成了antwebproject.war文件;
可以將該war包拷貝到Tomcat的目錄下看一下運(yùn)行結(jié)果。
總結(jié)
以上是生活随笔為你收集整理的Ant在Java项目中的使用(一眼就看会)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 关于Ant与Maven(一)
- 下一篇: Javaassist简介