Ant 學(xué)習(xí)筆記（1）
介紹、下載、說明、安裝
Ant 全名： Another Neat Tool ,意思是另一個(gè)清潔工具。
Ant 介紹:
ant 是構(gòu)建工具,是Apache 的一個(gè)項(xiàng)目，是一個(gè)基于JAVA的build工具，用來編譯、運(yùn)行、測試JAVA
程序，構(gòu)建、包裝和發(fā)布任務(wù)。
Ant 優(yōu)勢：
* 操作方便，只需在命令行輸入 ant ,它就會自動(dòng)尋找 build.xml文件。
* 良好的跨平臺，可以在各種平臺上運(yùn)行。
* 結(jié)構(gòu)清晰，能讓開發(fā)人員運(yùn)行各種各樣的任務(wù)。
Ant 下載：
http://ant.apache.org/
Ant 配置：
1.環(huán)境變量中，查找 Path 變量并選中，然后編輯，如果沒有新建，，在彈出的“系統(tǒng)變量”對象話中設(shè)定
系統(tǒng)變量 Path,Path = D:\*\Apache-ant- 1.7.0\bin
2.單擊“系統(tǒng)變量”選項(xiàng)卡中的新建按鈕，創(chuàng)建 ANT_HOME=D:\*\apache-ant-1.7.0
3.在cmd命令框中輸入ant 命令，即可查看 Ant 是否安裝成功
注意：
ant 啟動(dòng)時(shí)，自動(dòng)加載 build.xml 項(xiàng)目配置文件，如果取別的名字，使用 buildfile標(biāo)記
運(yùn)行 Ant ,比如： ant -buildfile gd.xml
Ant 的使用方法：
Ant 的配置運(yùn)行文件是 build.xml，一般放在項(xiàng)目根目錄下，通過運(yùn)行它即可完成相應(yīng)工作。
Ant 能完成的工作：
init ,初始化工作，即在進(jìn)行打包、部置之前對環(huán)境進(jìn)行一些初始化工作。
compile,編譯工作，即將java代碼編譯成class;
javadoc，生成文檔，即用來生成API的相關(guān)文檔;
jar,打包工作，即用來將編譯后的class文件打成jar;
deploy,部署工作，即用來對打好的jar或war進(jìn)行部署；
clean,清除工作，即用來清空初始化的環(huán)境；
all,執(zhí)行全部任務(wù)。
元素屬性說明
一般來講,一個(gè)XML文件要包含 project 和target 兩個(gè)元素
1.project 元素的屬性:
name:表示一個(gè)工程的名字.
default:每個(gè)project都包含一個(gè)或多個(gè)target,一個(gè)target又包含一系列想要執(zhí)行的task,
當(dāng)Ant 開始運(yùn)行時(shí),開發(fā)人員可以選擇target執(zhí)行.如果沒有 target 被指定執(zhí)行時(shí),默認(rèn)的任務(wù)
將執(zhí)行.
basedir:當(dāng)前工程的基本路徑,"."表示當(dāng)前工程的根目錄.
2.一個(gè)project有一系列的property,property類似于全局變量,包含name和value兩個(gè)屬性.
name:變量名稱.
value:變量值.
屬性該問的方法:${property-name};
3.Ant 內(nèi)置的屬性
basedir:工程的路徑.
ant.file:build文件的路徑.
ant.version:版本.
ant.project.name:工程名.
ant.java.version:jvm版本.
4.target 元素的屬性
name:指定目錄名稱.
depends:指定所依賴的target.
if:條件,如果不滿足條件則不執(zhí)行.
unless:條件,如果不滿足條件則不執(zhí)行.
description:對target 的描述.
task:一小段的任務(wù).
reference:引用,通過refid屬性來引用在其他節(jié)中定義的ID.
ant 的基本語法介紹：
1.ant 命令行，最常用的命令分析如下：
//應(yīng)用 build.xml 作為默認(rèn)的腳本文件，目錄路徑默認(rèn)。
ant
//應(yīng)用 test.xml 作為默認(rèn)的腳本文件，目錄路徑默認(rèn)。
ant -builefile test.xml
// 應(yīng)用 test.xml 作為默認(rèn)的腳本文件，目錄路徑設(shè)置為 dist
ant -builefile test.xml dist
//應(yīng)用test.xml 作為默認(rèn)的腳本文件，目標(biāo)路徑設(shè)置為 dist ，并且把構(gòu)建的屬性文件放在
buile/classes 下
ant -buildfile test.xml -Dbuile=buile/classes dist
//執(zhí)行從/home/ant/extras 添加的任務(wù)和jar 包
ant -lib /home/ant/extras
想了解更多的命令，可以運(yùn)行 ant -H獲取命令列表。
2.添加屬性文件
<property file="${basedir}/build.properties" />
3.CLASSPATH設(shè)置，示例如下：
<path id="classpath">
<pathelement path="${hibernate_jar}"/> //從什么地方加載
<fileset dir="${lib.dir}"> //設(shè)置文件夾
<include name="**/*.jar" /> //將.jar 放在dir中
</filest>
</path>
以上代碼與設(shè)置 CLASSPATH=/***/*.jar;/***/*.jar;是等效的
4.文件COPY命令，示例代碼如下：
<!-- 拷貝源文件 -->
<copy todir="${build.src}">
<fileset dir="${src.dir}"/>
</copy>
5.打包任務(wù)jar 命令，示例代碼如下
<!-- 打包文件 -->
<jar jarfil="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}" />
6.生成JAVADOC的命令，示例代碼如下：
<javadoc pachagename="${[aclages}" //包名
sourcepath="${build.src}" // 源文件路徑
destdir="${build.javadosc}" // 目標(biāo)路徑
author="true"
version="true" //是否帶有版本信息
use="true" //
splitindex="true"
windowtitle="${NAME}API"
doctitle="${NAME}">
<javadoc>
7.刪除命令，示例代碼如下所示：
<delete dir="${dir.build}" />
ant 在線文檔，地址是：http://ant.apache.org/manual/index.html
8.后臺打印命令
<echo message="jdk version: 1.5.0" />
一些常用的 ant 文件：
<?xml version="1.0" encoding="UTF-8"?>
<!-- ======================================================================
2007-10-24 上午09:01:29
project
description
yihang
====================================================================== -->
<project name="project" default="default">
<description>
轉(zhuǎn)換字符
</description>
<target name="help">
<echo message=" this is help"></echo>
</target>
<!-- =================================
target: default
================================= -->
<target name="default" description="--> description">
<native2ascii dest="." includes="src/com/news/struts/*.txt" encoding="GBK" ext=".properties"></native2ascii>
</target>
</project>
元素說明：
<?xml version="1.0"?>
<!--配置myApp的Ant文件，將gd包中的內(nèi)容打成jar -->
<project name="myApp" default="init" basedir=".">
<property name="myApp.home" value="." />
<property name="myApp.lib" value="${myApp.home}/WEB-INF/lib" />
<property name="myApp.jar" value="${myApp.home}/WEB-INF/lib" />
<property name="myApp.classes" value="${myApp.home}/WEB-INF/classes" />
<!--配置使用Tomcat所在的目錄 -->
<property name="tomcat.home" value="D\:/apache-tomcat-6.0.2" />
<!--<property file="build.properties" />以上內(nèi)容還可以定義在build.properties中-->
<target name="init">
<path id="all">
<!--初始化時(shí)需要使用的jar -->
<fileset dir="${myApp.lib}">
<include name="**/*.jar" />
</fileset>
<!--初始化時(shí)需要使用的jar -->
<fileset dir="${tomcat.home}/common/lib">
<include name="*.jar" />
</fileset>
</path>
<!--創(chuàng)建目錄 -->
<mkdir dir="${myApp.classes}" />
</target>
<!--定義 target -->
<!--清空生成的calss -->
<target name="clean">
<!-- 刪除目錄 -->
<delete dir="${myApp.classes}">
</delete>
</target>
<!--定義target,該target依賴于init,編譯時(shí)需要依賴與初始化的結(jié)果 -->
<target name="compile" depends="init">
<!--編譯時(shí)使用的版本是1.5 -->
<javac srcdir="${myApp.home}/WEB-INF/src"encoding="utf-8" destdir="${myApp.classes}" target="1.5">
<classpath refid="all" />
</javac>
</target>
<!--定義target,該target 依賴于 compile,com.gd包下的代碼打成加，命名為nancy2.0.0.jar -->
<target name="jar" depends="compile">
<jar jarfile="${myApp.jar}/nancy2.0.0.jar" basedir="${myApp.classes}" includes="com/gd/**">
</jar>
</target>
<!--將myApp項(xiàng)目打成war文件-->
<target name="war" depends="jar">
<war destfile="${myApp.home}/myApp.war" webxml="${myApp.home}/WEB-INF/web.xml">
<!-- 包含該文件夾下所有內(nèi)容 -->
<fileset dir="${myApp.home}" casesensitive="yes">
<include name="WEB-INF/**" />
<exclude name="*.war" />
</fileset>
<!--所依賴的jar-->
<lib dir="${myApp.home}/WEB-INF/lib">
<include name="*.jar" />
</lib>
</war>
</target>
</project>