Ant在Java项目中的使用(一眼就看会)
參考:http://www.cnblogs.com/zhengqiang/p/5557155.html
?
Ant是跨平臺(tái)的構(gòu)建工具,它可以實(shí)現(xiàn)項(xiàng)目的自動(dòng)構(gòu)建和部署等功能。在本文中,主要讓讀者熟悉怎樣將Ant應(yīng)用到Java項(xiàng)目中,讓它簡(jiǎn)化構(gòu)建和部署操作。
?
一、安裝與部署
?
1.1?下載
?
下載地址:https://archive.apache.org/dist/ant/binaries/
?
我下載的是1.7.1版本。解壓到某個(gè)目錄(例如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,在這里編寫一個(gè)簡(jiǎn)單的Ant程序,
用來(lái)展現(xiàn)Ant的功能,讓讀者對(duì)Ant有一個(gè)初步的了解。首先在D盤下建立一個(gè)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é)果,證明正確:
接下來(lái)開(kāi)始向讀者講解本節(jié)的重點(diǎn):Ant的關(guān)鍵元素project、target、property和task
?
2.1 project元素
?
project元素是Ant構(gòu)建文件的根元素,Ant構(gòu)件文件至少應(yīng)該包含一個(gè)project元素,否則會(huì)發(fā)生錯(cuò)誤。在每個(gè)project元素下,可包含多個(gè)target元素。接下來(lái)向讀者展示一下project元素的各屬性。
?
(1)name屬性
?
用于指定project元素的名稱。
?
(2)default屬性
?
用于指定project默認(rèn)執(zhí)行時(shí)所執(zhí)行的target的名稱。
?
(3)basedir屬性
?
用于指定基路徑的位置。該屬性沒(méi)有指定時(shí),使用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命令,此時(shí)沒(méi)有指定執(zhí)行的target名稱,成功出現(xiàn)以下結(jié)果:
?
從上面的內(nèi)容我們可以看出,在這里定義了default屬性的值為sayBaseDir,即 當(dāng)運(yùn)行ant命令時(shí),若未指明執(zhí)行的target時(shí),默認(rèn)執(zhí)行的target的sayBaseDir,同時(shí)還定義了basedir屬性的值為?D:\ant-1.7.1
2.2 target元素
?
它為Ant的基本執(zhí)行單元,它可以包含一個(gè)或多個(gè)具體的任務(wù)。多個(gè)target可以存在相互依賴關(guān)系。它有如下屬性:
?
(1)name屬性
?
指定target元素的名稱,這個(gè)屬性在一個(gè)project元素中是唯一的。我們可以通過(guò)指定target元素的名稱來(lái)指定某個(gè)target。
?
(2)depends屬性
?
用于描述target之間的依賴關(guān)系,若與多個(gè)target存在依賴關(guān)系時(shí),需要以“,”間隔。Ant會(huì)依照depends屬性中target出現(xiàn)的順序依次執(zhí)行每個(gè)target。被依賴的target會(huì)先執(zhí)行。
?
(3)if屬性
?
用于驗(yàn)證指定的屬性是否存在,若不存在,所在target將不會(huì)被執(zhí)行。
?
(4)unless屬性
?
該屬性的功能與if屬性的功能正好相反,它也用于驗(yàn)證指定的屬性是否存在,若不存在,所在target將會(huì)被執(zhí)行。
?
(5)description屬性
?
該屬性是關(guān)于target功能的簡(jiǎn)短描述和說(shuō)明。
?
例子:
修改上面的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í)行,同時(shí)因?yàn)橄到y(tǒng)安裝了java環(huán)境,所以ant.java.version屬性存在,執(zhí)行了?targetA這個(gè)target,輸出信息:[echo] Java Version: 1.6,targetA執(zhí)行完畢后,接著執(zhí)行targetB,因?yàn)閍migo不存在,而unless屬性是在不存在時(shí)進(jìn)入所在的target的,由此可知?targetB得以執(zhí)行,輸出信息:The base dir is: D:\
2.3 property元素
該元素可看作參量或者參數(shù)的定義,project的屬性可以通過(guò)property元素來(lái)設(shè)定,也可在Ant之外設(shè)定。若要在外部引入某文件,例如build.properties文件,可以通過(guò)如下內(nèi)容將其引入:<property file=”build.properties”/>
property元素可用作task的屬性值。在task中是通過(guò)將屬性名放在“${”和“}”之間,并放在task屬性值的位置來(lái)實(shí)現(xiàn)的。
Ant提供了一些內(nèi)置的屬性,它能得到的系統(tǒng)屬性的列表與Java文檔中System.getPropertis()方法得到的屬性一致,這些系統(tǒng)屬性可參考sun網(wǎng)站的說(shuō)明。
同時(shí),Ant還提供了一些它自己的內(nèi)置屬性,如下:
basedir:project基目錄的絕對(duì)路徑,該屬性在講解project元素時(shí)有詳細(xì)說(shuō)明;
ant.file:buildfile的絕對(duì)路徑,如上面的各例子中,ant.file的值為D:\build.xml;
ant.version:Ant的版本,在本文中,值為1.7.1;
ant.project.name:當(dāng)前指定的project的名字,即前文說(shuō)到的project的name屬性的值;
ant.java.version:Ant檢測(cè)到的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工具中每一個(gè)任務(wù)封裝了具體要執(zhí)行的功能,是Ant工具的基本執(zhí)行單位。在本小節(jié)中,主要引導(dǎo)讀者來(lái)看下Ant的常用任務(wù)及其使用舉例。
3.1 copy任務(wù)
該任務(wù)主要用來(lái)對(duì)文件和目錄的復(fù)制功能。舉例如下:
(1)復(fù)制單個(gè)文件:
<copy file="file.txt" tofile="copy.txt"/>
(2)對(duì)文件目錄進(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ù)
對(duì)文件或目錄進(jìn)行刪除,舉例如下:
(1)刪除某個(gè)文件:<delete file="photo/amigo.jpg"/>
(2)刪除某個(gè)目錄:<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ù)
移動(dòng)文件或目錄,舉例如下:
(1)移動(dòng)單個(gè)文件:
<move file="fromfile" tofile=”tofile”/>
(2)移動(dòng)單個(gè)文件到另一個(gè)目錄:
<move file="fromfile" todir=”movedir”/>
(3)移動(dòng)某個(gè)目錄到另一個(gè)目錄:
<move todir="newdir">
?<fileset dir="olddir"/>
</move>
(4)echo任務(wù)
該任務(wù)的作用是根據(jù)日志或監(jiān)控器的級(jí)別輸出信息。它包括message、file、append和level四個(gè)屬性,舉例如下:
<echo message="Hello,Amigo" file="logs/system.log" append="true">
四、利用Ant構(gòu)建和部署Java工程
Ant可以代替使用javac、java和jar等命令來(lái)執(zhí)行java操作,從而達(dá)到輕松的構(gòu)建和部署Java工程的目的。下面來(lái)看幾個(gè)知識(shí)點(diǎn)。
4.1?利用Ant的javac任務(wù)來(lái)編譯java程序
(1)建立名為antstudy的Java工程,?src目錄為源代碼目錄,在src目錄下建立HelloWorld.java這個(gè)類文件
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)一步,來(lái)生成jar包,可在run這個(gè)target下再加上如下target:
此時(shí)將ant的project的default屬性設(shè)置為jar,同時(shí)運(yùn)行該build.xml文件,運(yùn)行完畢后,可看到在工程目錄下生成了一個(gè)jar包HelloWorld.jar,如下圖所示:
?
4.4?使用Ant的war任務(wù)打包J2EE Web項(xiàng)目
?
建立一個(gè)J2EE Web工程,其目錄結(jié)構(gòu)如下圖所示:
把上面的HelloWorld.java復(fù)制過(guò)來(lái)即可;
直接在工程下建立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项目中的使用(一眼就看会)的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: 关于Ant与Maven(一)
- 下一篇: Windows下Maven的安装与配置