Ant的優點
跨平台性。Ant是用Java語言編寫的,所示具有很好的跨平台性。
操作簡單。Ant是由一個內置任務和可選任務組成的。
Ant運行時需要一個XML文件(構建文件)。
Ant通過調用target樹,就可以執行各種task。每個task實現了特定接口對象。
Ant開發
Ant的構建文件
Ant構建文件默認命名為build.xml,也可以取其他的名字。只不過在運行的時候把這個命名當作參數傳給Ant。構建文件可以放在任何的位置。一般做法是放在項目頂層目錄中,這樣可以保持項目的簡潔和清晰。
下面是一個典型的項目層次結構。
(1) src存放文件。
(2) class存放編譯后的文件。
(3) lib存放第三方JAR包。
(4) dist存放打包,發布以后的代碼。
每個構建文件定義一個唯一的項目(Project元素)。
每個項目下可以定義很多目標(target元素),這些目標之間可以有依賴關系。當執行這類目標時,需要執行他們所依賴的目標。
每個目標中可以定義多個任務,目標中還定義了所要執行的任務序列。
Ant在構建目標時必須調用所定義的任務。
任務定義了Ant實際執行的命令。
Ant中的任務可以為3類。
(1)核心任務。核心任務是Ant自帶的任務。
(2)可選任務。可選任務是來自第三方的任務,因此需要一個附加的JAR文件。
(3)用戶自定義的任務。用戶自定義的任務實用戶自己開發的任務。
Build.XML中的標簽
1.<project>標簽
每個構建文件對應一個項目。<project>標簽時構建文件的根標簽。它可以有多個內在屬性,
就如代碼中所示,其各個屬性的含義分別如下。
(1) default表示默認的運行目標,這個屬性是必須的。
(2) basedir表示項目的基准目錄。
(3) name表示項目名。
(4) description表示項目的描述。
每個構建文件都對應於一個項目,但是大型項目經常包含大量的子項目,每一個子項目都可以有自己的構建文件。
2.<target>標簽
一個項目標簽下可以有一個或多個target標簽。一個target標簽可以依賴其他的target標簽。例如,有一個target用於編譯程序,另一個target用於聲稱可執行文件。在生成可執行文件之前必須先編譯該文件,因此可執行文件的target依賴於編譯程序的target。
Target的所有屬性如下。
(1).name表示目標名,這個屬性是必須的。
(2).depends表示依賴的目標名。
(3)if表示僅當屬性設置時才執行。
(4)unless表示當屬性沒有設置時才執行。
(5)description表示項目的描述。
Ant的depends屬性指定了target的執行順序。Ant會依照depends屬性中target出現順序依次執行每個target。在執行之前,首先需要執行它所依賴的target。程序中的名為run的target的depends屬性compile,而名為compile的target的depends屬性是prepare,所以這幾個target執行的順序是prepare->compile->run。
一個target只能被執行一次,即使有多個target依賴於它。如果沒有if或unless屬性,target總會被執行。
3.<mkdir>標簽
該標簽用於創建一個目錄,它有一個屬性dir用來指定所創建的目錄名,其代碼如下:
<mkdir dir=”${class.root}”/>
通過以上代碼就創建了一個目錄,這個目錄已經被前面的property標簽所指定。
4<jar>標簽
該標簽用來生成一個JAR文件,其屬性如下。
(1) destfile表示JAR文件名。
(2) basedir表示被歸檔的文件名。
(3) includes表示被歸檔的文件模式。
(4) exchudes表示被排除的文件模式。
5.<javac標簽>
該標簽用於編譯一個或一組java文件,其屬性如下。
(1).srcdir表示源程序的目錄。
(2).destdir表示class文件的輸出目錄。
(3).include表示被編譯的文件的模式。
(4).excludes表示被排除的文件的模式。
(5).classpath表示所使用的類路徑。
(6).debug表示包含的調試信息。
(7).optimize表示是否使用優化。
(8).verbose表示提供詳細的輸出信息。
(9).fileonerror表示當碰到錯誤就自動停止。
6.<java>標簽
該標簽用來執行編譯生成的.class文件,其屬性如下。
(1).classname表示將執行的類名。
(2).jar表示包含該類的JAR文件名。
(3).classpath所用到的類路徑。
(4).fork表示在一個新的虛擬機中運行該類。
(5).failonerror表示當出現錯誤時自動停止。
(6).output表示輸出文件。
(7).append表示追加或者覆蓋默認文件。
7.<delete>標簽
該標簽用於刪除一個文件或一組文件,屬性如下。
(1)/file表示要刪除的文件。
(2).dir表示要刪除的目錄。
(3).includeEmptyDirs表示指定是否要刪除空目錄,默認值是刪除。
(4).failonerror表示指定當碰到錯誤是否停止,默認值是自動停止。
(5).verbose表示指定是否列出所刪除的文件,默認值為不列出。
8.<copy>標簽
該標簽用於文件或文件集的拷貝,其屬性如下。
(1).file表示源文件。
(2).tofile表示目標文件。
(3).todir表示目標目錄。
(4).overwrite表示指定是否覆蓋目標文件,默認值是不覆蓋。
(5).includeEmptyDirs表示制定是否拷貝空目錄,默認值為拷貝。
(6).failonerror表示指定如目標沒有發現是否自動停止,默認值是停止。
(7).verbose表示制定是否顯示詳細信息,默認值不顯示。
Ant的數據類型
數據類型包含在org.apache.tool.ant.types包中。
1. argument 類型
由Ant構建文件調用的程序,可以通過<arg>元素向其傳遞命令行參數,如apply,exec和java任務均可接受嵌套<arg>元素,可以為各自的過程調用指定參數。以下是<arg>的所有屬性。
(1).values是一個命令參數。如果參數種有空格,但又想將它作為單獨一個值,則使用此屬性。
(2).file表示一個參數的文件名。在構建文件中,此文件名相對於當前的工作目錄。
(3).line表示用空格分隔的多個參數列表。
(4).path表示路徑。
2.ervironment類型
由Ant構建文件調用的外部命令或程序,<env>元素制定了哪些環境變量要傳遞給正在執行的系統命令,<env>元素可以接受以下屬性。
(1).file表示環境變量值的文件名。此文件名要被轉換位一個絕對路徑。
(2).path表示環境變量的路徑。Ant會將它轉換為一個本地約定。
(3).value表示環境變量的值。
(4).key表示環境變量名。
注意: file、 path 或 value只能取一個。
3.filelist類型
Filelist是一個支持命名的文件列表的數據類型,包含在一個filelist類型中的文件不一定是存在的文件。以下是其所有的屬性。
(1).dir是文件絕對路徑所在目錄。
(2).files是用逗號分隔的文件名列表。
(3).refid是對某處定義的一個<filelist>的引用。
注意 dir 和 files 都是必要的,除非指定了refid(這種情況下,dir和files都不允許使用)。
4.fileset類型
Fileset數據類型定義了一組文件,並通常表示為<fileset>元素。不過,許多ant任務構建成了隱式的fileset,這說明他們支持所有的fileset屬性和嵌套元素。以下為fileset的屬性列表。
(1).dir表示fileset的基目錄。
(2).casesensitive的值如果為false,那么匹配文件名時,fileset不是區分大小寫的,其默認值為true.
(3).defaultexcludes用來確定是否使用默認的排除模式,默認為true。
(4).excludes是用逗號分隔的需要派出的文件模式列表。
(5).excludesfile表示每行包含一個排除模式的文件的文件名。
(6).includes是用逗號分隔的,需要包含的文件模式列表。
(7).includesfile表示每行包括一個包含模式的文件名。
5.patternset類型
Fileset是對文件的分組,而patternset是對模式的分組,他們是緊密相關的概念。
<patternset>支持4個屬性:includes excludex includexfile 和 excludesfile,與fileset相
同。Patternset還允許以下嵌套元素:include,exclude,includefile和 excludesfile.
6.filterset類型
Filterset定義了一組過濾器,這些過濾器將在文件移動或復制時完成文件的文本替換。
主要屬性如下:
(1).begintoken表示嵌套過濾器所搜索的記號,這是標識其開始的字符串。
(2).endtoken表示嵌套過濾器所搜索的記號這是標識其結束的字符串。
(3).id是過濾器的唯一標志符。
(4).refid是對構建文件中某處定義一個過濾器的引用。
7.Path類型
Path元素用來表示一個類路徑,或其他的路徑,路經中的各項用分號或冒號隔開。在構建的時候,此分隔符將代替當前平台中所有的路徑分隔符,其擁有的屬性如下。
(1).location表示一個文件或目錄。Ant在內部將此擴展為一個絕對路徑。
(2).refid是對當前構建文件中某處定義的一個path的引用。
(3).path表示一個文件或路徑名列表。
8.mapper類型
Mapper類型定義了一組輸入文件和一組輸出文件間的關系,其屬性如下。
(1).classname表示實現mapper類的類名。當內置mapper不滿足要求時,用於創建定制mapper.
(2).classpath表示查找一個定制mapper時所用的類型路徑。
(3).classpathref是對某處定義的一個類路徑的引用。
(4).from屬性的含義取決於所用的mapper.
(5).to屬性的含義取決於所用的mapper.
(6).type屬性的取值為identity,flatten glob merge regexp 其中之一,它定義了要是用的內置mapper的類型。
Ant的運行
安裝好Ant並且配置好路徑之后,在命令行中切換到構建文件的目錄,輸入Ant命令就可以運行Ant.若沒有指定任何參數,Ant會在當前目錄下查詢build.xml文件。如果找到了就用該文件作為構建文件。如果使用了 –find 選項,Ant就會在上級目錄中找構建文件,直至到達文件系統得跟目錄。如果構建文件的名字不是build.xml,則Ant運行的時候就可以使用 –buildfile file ,這里file指定了要使用的構建文件的名稱,示例如下:
Ant如下說明了表示當前目錄的構建文件為build.xml運行 ant 執行默認的目標。
Ant –buildfile test.xml
使用當前目錄下的test.xml文件運行Ant ,執行默認的目標
=====================================================================
=====================================================================
1.目標:滿足基本Java項目的全面構建和部署需求。
2.參照NetBeans的build.xml設計,結構如圖:
build.xml代碼:
<?xml version="1.0" encoding="UTF-8"?>
<project name="Project Name" default="default" basedir=".">
<description>Builds, tests, and runs the project.</description>
<!-- ********************************************************
引入資源和定義資源
******************************************************** -->
<!--
引入資源
-->
<property file="build.properties"/>
<property environment="env"/>
<!--
定義源程序文件夾
-->
<property name="src.dir" location="src/java"/>
<property name="test.dir" location="test"/>
<property name="web.dir" location="web"/>
<!--
定義目標程序文件夾
-->
<property name="build.dir" location="build"/>
<property name="build.classes.dir" location="${build.dir}/classes"/>
<property name="build.test.dir" location="${build.dir}/test"/>
<property name="dist.dir" location="dist"/>
<!--
定義其他文件夾
-->
<property name="lib.dir" location="lib"/>
<property name="doc.dir" location="doc"/>
<property name="index.dir" location="index"/>
<property name="deploy.dir" location="${env.CATALINA_HOME}"/>
<property name="deploy.lib.dir" location="${deploy.dir}/lib"/>
<!--
定義其他文件
-->
<property name="dist.jar" location="${dist.dir}/WEB-INF/lib/${project.name}-${project.version}.jar"/>
<property name="deploy.war" location="${deploy.dir}/webapps/${project.name}.war"/>
<!--
定義其他屬性
-->
<available file="${dist.dir}/enduser.agreement" property="final.version"/>
<!-- ********************************************************
設置path
******************************************************** -->
<path id="project.classpath">
<pathelement location="${java.home}/jre/lib/rt.jar"/>
<pathelement location="${build.classes.dir}"/>
<pathelement location="${build.test.dir}"/>
<fileset dir="${deploy.lib.dir}">
<include name="**/*.jar"/>
</fileset>
<fileset dir="${lib.dir}">
<include name="**/*.jar"/>
</fileset>
</path>
<target name="init" description=" 信息 : 顯示項目基本信息.">
<tstamp>
<format property="now" pattern="yyyy-MM-dd HH:mm"/>
</tstamp>
<echo> ==================================================
||
|| 顯示項目基本信息.
||
|| 項目名稱: ${project.name}
|| 項目版本: ${project.version}
|| 作者 : ${author}
|| 時戳 : ${DSTAMP}-${TSTAMP}
||
|| 用法:
|| ant -buildfile build.xml compile 或
|| ant compile 或
|| ant 甚至
|| ant clean dist
|| 幫助:
|| ant -projecthelp
||
==================================================</echo>
</target>
<target name="prepare" depends="init" description=" 准備 : 創建各種文件夾.">
<echo> ==================================================
||
|| 創建各種文件夾.
||
================================================== </echo>
<!-- 創建源程序文件夾 -->
<mkdir dir="${src.dir}"/>
<mkdir dir="${test.dir}"/>
<mkdir dir="${web.dir}"/>
<mkdir dir="${web.dir}/WEB-INF"/>
<!-- 創建目標程序文件夾 -->
<mkdir dir="${build.dir}"/>
<mkdir dir="${build.classes.dir}"/>
<mkdir dir="${build.test.dir}"/>
<mkdir dir="${dist.dir}"/>
<mkdir dir="${dist.dir}/WEB-INF"/>
<mkdir dir="${dist.dir}/WEB-INF/lib"/>
<!-- 創建其他文件夾 -->
<mkdir dir="${lib.dir}"/>
<mkdir dir="${doc.dir}"/>
<mkdir dir="${index.dir}"/>
</target>
<target name="javadoc" depends="prepare" description="生成文檔: 生成幫助文檔.">
<echo> ==================================================
||
|| 生成幫助文檔.
||
==================================================</echo>
<javadoc packagenames="*.*" sourcepath="${src.dir}" destdir="${doc.dir}" author="true" version="true" use="true" encoding="UTF-8">
<classpath refid="project.classpath"/>
</javadoc>
</target>
<target name="compile" depends="prepare" description=" 編譯 : 編譯所有源程序." unless="final.version">
<echo> ==================================================
||
|| 編譯所有源程序.
||
==================================================</echo>
<javac srcdir="${src.dir}" destdir="${build.classes.dir}" debug="on" deprecation="on" encoding="UTF-8">
<compilerarg value="-Xlint:unchecked"/>
<classpath refid="project.classpath"/>
</javac>
<javac srcdir="${test.dir}" destdir="${build.test.dir}" encoding="UTF-8">
<compilerarg value="-Xlint:unchecked"/>
<classpath refid="project.classpath"/>
</javac>
</target>
<target name="test" depends="compile" description=" 測試 : 運行所有測試程序.">
<echo> ==================================================
||
|| 運行所有測試程序.
||
==================================================</echo>
<junit haltonfailure="true">
<classpath refid="project.classpath"/>
<formatter type="brief" usefile="false"/>
<batchtest>
<fileset dir="${build.test.dir}" includes="**/*Test.class"/>
</batchtest>
<sysproperty key="doc.dir" value="${doc.dir}"/>
<sysproperty key="index.dir" value="${index.dir}"/>
</junit>
</target>
<target name="dist" depends="compile" description=" 分發 : 生成分發文件.">
<echo> ==================================================
||
|| 生成分發文件:
|| ${dist.jar}
||
==================================================</echo>
<!-- 從打包文件排除單元測試 -->
<jar destfile="${dist.jar}" basedir="${build.classes.dir}" includes="**/*.*" excludes="**/*Test.class">
<!-- manifest="MANIFEST.MF" > -->
<manifest>
<attribute name="Author" value="${author}"/>
</manifest>
</jar>
</target>
<!-- ********************************************************
用於調試
******************************************************** -->
<target name="debug" depends="dist" description=" 調試 "/>
<!-- ********************************************************
用於效驗
******************************************************** -->
<target name="verify" depends="dist" description=" 效驗 "/>
<target name="run-deploy" depends="dist" description=" 部署 : 把文件部署到指定位置.">
<echo> ==================================================
||
|| 把文件部署到指定位置:
|| ${deploy.war}
||
==================================================</echo>
<copy todir="${dist.dir}/WEB-INF/lib">
<fileset dir="${lib.dir}" includes="*.jar"/>
</copy>
<copy todir="${dist.dir}">
<fileset dir="${web.dir}" includes="**/*.*"/>
</copy>
<jar destfile="${deploy.war}" basedir="${dist.dir}" includes="**/*.*" excludes="**/*Test.class">
<!-- manifest="MANIFEST.MF" > -->
一個ant的build.xml文件實例
很簡單,很實用,寫完之后,發現,嘿嘿!我居然可以不翻doc寫build文件了。
<?xml version="1.0" encoding="utf-8" ?>
<project name="dian_bid" basedir="." default="deploy">
<property name="source" location="src" />
<property name="resource" location="res" />
<property name="test-srouce" location="test" />
<property name="release-resource" location="release" />
<property name="dest" location="dest" />
<property name="webroot" location="web"/>
<property name="tomcat-root" location="D:/Java/apache-tomcat-a"/>
<target name="clean">
<echo message="清理生成過程中的臨時文件" />
<delete dir="${tomcat-root}/webapps/bid" />
<delete dir="${webroot}/WEB-INF/classes" />
<delete dir="${dest}" />
</target>
<target name="prepare" depends="clean">
<mkdir dir="${webroot}/WEB-INF/classes"/>
<mkdir dir="${dest}" />
</target>
<target name="build" depends="prepare">
<echo message="編譯Java源代碼" />
<javac destdir="${webroot}/WEB-INF/classes" srcdir="${source}">
<sourcepath path="${test-srouce}" />
<classpath>
<fileset dir="${tomcat-root}/lib">
<include name="**/*.jar"/>
</fileset>
<fileset dir="${webroot}/WEB-INF/lib">
<include name="**/*.jar"/>
</fileset>
</classpath>
</javac>
</target>
<target name="package" depends="build">
<echo message="將Web工程打包成war可部署文件格式" />
<copydir dest="${webroot}/WEB-INF/classes" src="${resource}" />
<copydir dest="${webroot}/WEB-INF/classes" src="${release-resource}" />
<war destfile="${dest}/bid.war" basedir="${webroot}" webxml="${webroot}/WEB-INF/web.xml"/>
</target>
<target name="deploy" depends="package">
<echo message="開始部署BID系統到服務器上" />
<copy file="${dest}/bid.war" todir="${tomcat-root}/webapps" />
<echo message="停止tomcat服務器" />
<exec executable="${tomcat-root}/bin/shutdown.bat" />
<echo message="啟動tomcat服務器" />
<exec executable="${tomcat-root}/bin/startup.bat" />
<echo message="部署BID系統完成" />
</target>
</project>
