日期:2014-05-16  浏览次数:20603 次

Apache Ant常用标签介绍

? 在上一篇博文中简单介绍了一下Ant是如何编译和发布Java项目,对使用用的一些标签命令也没有做说明,现在该是做说明的时候了。

? 我们都看到了,Ant的构件文件是基于XML的,默认加载执行build.xml,project元素构成了Ant文件的根元素,Ant构件文件至少应该包含一个project元素。在每个project元素下,可以包含多个target元素,target就是Ant构件所要做的事情,现在列个简单的build.xml来加深一下对文件结构的印象:

?

<?xml version="1.0" encoding="UTF-8"?>
<project name="helloProj">
	<target name="sayHello">
		<echo message="Hello,Ant!"></echo><!-- 该标签用于输出指定的文本信息-->
	</target>
</project>

? 进入到指定目录antDemo,在控制台输入ant ,回车:

?

? 相信你一定看出问题了,sayHello没有输出,事实是这样的,一个project元素下有多个target,如果你不在build.xml文件中或者在命令行指定target,那么Ant怎么知道你要去执行哪一个target,所以可通过以下方法解决,project元素有一属性default,就是指定默认执行的target名;另一个方法就是命令行输入ant (指定target);我们采用第一种方式:

?

<?xml version="1.0" encoding="UTF-8"?>
<project name="helloProj" default="sayHello">
	<target name="sayHello">
		<echo message="Hello,Ant!"></echo>
	</target>
</project>

? 所以,在控制台输入ant,并出现了Hello,Ant!的打印信息了。

? 前面我们聊到了,Ant是默认加载执行build.xml,如果我们依个人喜好,没有指定这样的一个默认的build.xml文件,而是指定了build_helloProj.xml,在控制台输入肯定会出错,毫无疑问,那么怎么加载这样一个另指定的文件呢,命令行参数就需要做些少许改变了,可通过如下命令参数

?

ant -f build_helloProj.xml
ant -file build_helloProj.xml
ant -buildfile build_helloProj.xml

? 命令控制台输出如下信息:

?

? 更具体的命令行参数使用方法,可在控制台输入ant -help/ant -h查看,在此就不列出了。

? Ant的关键元素和常用元素语义说明:

? 1)project:

??? ant构件文件的根元素,这个是必须的元素噢!它的三个属性我们都已经见到过了,分别为name、default、basedir。name属性就是指定project的名称了;default属性用于指定project默认执行的target名称;basedir属性用于指定基路径的位置,没有指定或者指定为".",则为Ant构件文件的附目标作为基准目录。看应用build_showbasedir.xml示例:

?

<?xml version="1.0" encoding="UTF-8"?>
<project name="antElementLearnProj" default="printBaseDir" basedir=".">
	<target name="printBaseDir">
		<echo message="The base dir is: ${basedir}"></echo>
	</target>
</project>
?

? 结果显示如下:

??

?

? 2)target:

??? Ant的基本执行单元,它可以包含一个或多个具体的执行任务。多个target可以存在相互依赖关系(depends属性),所以,看看它的一些属性:

?? name属性指定target的名称,这是属性是project元素中唯一的;depends属性用于描述多个target之间的依赖关系,被依赖的先执行。比如,我们运行一个java程序之前必须先编译它,所以,我们在运行的target中指定depends依赖于编译的target。如果与多个target存在依赖关系,则要用","间隔。Ant会依照depends属性中的target出现的顺序依次执行每个target;if属性验证执行此target的成立条件;unless属性与if属性相反,验证指定属性为假时所在的target执行;description属性是对此target功能的简短描述和说明,看build_targetElement.xml示例:

?

<?xml version="1.0" encoding="UTF-8"?>
<project name="antTargetElementLearnProj" default="target_b" basedir=".">
  <target name="target_a"  if="ant.java.version">
     <echo message="Java Version: ${ant.java.version}"/>
  </target>
  <target name="target_b" depends="target_a" 
  		unless="targetdemo" description="a depend example!">
      <echo message="The base dir is: ${basedir}"/>
  </target>
</project>

? 在控制台输入ant -f build_targetElement.xml,显示信息如下图所示:

??

?? 我们运行的是名为target_b的target,因为它依赖于名为target_a的target,所以先执行target_a,运行Ant,java环境肯定存在,所以打印信息:Java Version:1.6。target_a执行完毕之后,接着执行名为target_b的target,targetdemo属性不存在,所以打印出当前的根目录。

? 3)property :

??? 该元素说得直白些,就是一变量,project里的属性可通过property元素来设定,也可在外部引入一文件,例如build.properties(一定程度上可增加系统的维护性,一些开源项目常这么干),可通过如下方式引入:<property file="build.properties"/>。

?? 在引用property元素时,可通过将属性名放在"${"和"}"之间,当然了,Ant本身也提供一些内置属性,另外它也能得到的系统属性列表与Java文档中的System.getProperties()方法得到的属性一致,Ant的内置属性包括basedir()、ant.file、ant.version、ant.project.name、ant.java.version,下面我们来看一个简单的property示例build_proper