Ant开发及整合应用详解

在Ant工具中每一个任务封装了具体要执行的功能,是Ant工具的基本执行单位。Ant工具内提供很多有用的任务,项目开发时可利用Ant工具提供的内置任务方便地实现自动构建等功能。本章主要讲解Ant工具的核心任务及其作用,便于读者根据功能选择使用。

4.1  Ant Task:Ant任务(执行多个构件文件)

如果需要在一个构件文件中通过Ant命令去执行另一个Ant项目,或者说要执行本项目的子项目的构件文件。这时Ant这个核心任务就派上用场了。简单地说Ant任务的作用就相当于在命令行通过Ant命令执行构件文件。值得注意的是Ant任务依赖于target元素,需要在某个target元素中使用,不能在target元素外独立使用。

Ant任务还可以实现类似Java程序间的继承关系,不过对于这个核心任务来说只继承property元素和reference属性。举个例子说,项目A中包含通过Ant任务去执行的项目B,而项目B中需要用到项目A中的属性C,那么可以通过设置的Ant任务中的inheritAll属性,使得在B项目中可以使用项目A中的属性C。从另一方面看,这也符合XP(极限)编程中的细分功能的思想,可以把大的项目切分为几分小项目,然后通过Ant工具进行整合。

4.1.1  Ant Task的属性及功能

Ant任务包括antfile、dir、target、output、inheritAll、inheritRefs这些属性,具体说明如下:

 

(1)antfile属性:在Ant任务中antfile属性的作用是指定要执行的构件文件的名称,可包含路径信息。例如,在projectA中执行projectB的构件文件。projectA的构件文件内容如下:

<?xml version="1.0"?>

<!-- 在projectA中执行projectB的构件文件   -->

<project name="porjectA" default="callProjectB">

    <target name="callProjectB">

        <echo message="In projectA calling projectB"/>

        <ant antfile="subfile/projectB.xml" />

</target>

</project>

projectB存放于subfile目录下,具体内容如下:

hamg<?xml version="1.0"?>

<project name="porjectB" default="init">

    <target name="init">

        <echo message="In projectB"/>

    </target>

</project>

如果要通过projectA运行projectB的构件文件,那么可以在命令行执行:ant –buildfile projectA.xml

从执行结果得知,antfile属性的作用相当于在Ant命令中指定-buildfile subfile/projectB. xml选项,只不过Ant任务提供了更方便的功能。如果antfile属性没设定,那么Ant任务会查找名称为build.xml的构件文件。当然antfile属性也可与dir属性结合使用,antfile指定文件名称,dir属性指定文件所在的目录。

 

(2)dir属性:在Ant任务中dir属性的作用是用于指定构件文件所在的目录。相当于指定了要执行的构件文件的basedir属性。在默认情况下如果dir属性没设定,那么会以当前执行的构件文件的根目录作为Ant任务的根目录。这个属性设定后,被执行的构件文件的basedir属性将取dir属性的值。下面把targetA.xml构件文件改写为通过dir属性指定目录以实现同样的功能,具体的构件文件内容如下:

<?xml version="1.0"?>

<project name="porjectA" default="callProjectB">

    <!-- //调用projectB.xml构件文件  -->

    <target name="callProjectB">

        <echo message="In projectA calling projectB"/>

        <ant antfile="projectB.xml"  dir=” subfile” />

    </target>

</project>

 

(3)target属性:在Ant任务中target属性的作用是指定被执行的构件文件中所要执行的target,如果target属性没有设定,那么将会执行被调用的构件文件中的默认target(也就是project元素中指定default值)。这个属性相当于在命令行执行时指定要执行的target的选项。例如,在projectA1中调用projectB1,并执行projectB1中的target“target2”。编写projectA1.xml构件文件,内容如下:

<?xml version="1.0"?>

<project name="porjectA" default="callProjectB">

    <target name="callProjectB">

        <echo message="In projectA calling projectB"/>

         <!-- //通过ant 任务执行projectB.xml构件文件,指定执行target2这个target  -->

        <ant antfile="subfile/projectB.xml" target=" target2"/>

    </target>

</project>

被调用的projectB.xml构件文件的内容如下:

<?xml version="1.0"?>

<project name="porjectB" default="init">

    <target name="init">

        <echo message="In projectB"/>

    </target>

    <target name=”target2” >

        <echo message=”In projectB,execute target2” />

    </target>

</project>

 

 

 

(4)output属性:在Ant任务中output属性主要用于指定Ant工具执行时的信息输出,可定位到控制台或定位到文件中。当输出信息到文件中时,相当于在命令行指定-logfile<file>,-l<file>选项。如果指定了dir属性,那么被指定的输出文件的位置是相对于dir属性指定的目录的,当然也可以通过绝对路径指定。例如,把projectA中的输出信息定位到out.log文件,构件文件的内容如下:

<?xml version="1.0"?>

<project name="porjectA" default="callProjectB">

    <target name="callProjectB">

        <echo message="In projectA calling projectB"/>

         <!-- //输出信息到out.log中  -- >

        <ant antfile="subfile/projectB.xml"  output="out.log"/>

    </target>

</project>

 

(5)inheritAll属性:在Ant任务中inheritAll属性用于指定被调用的构件文件的project元素中可使用当前project元素中的属性。这个属性类似于Java程序中类的继承关系。默认时inheritAll属性取值为true。

 

(6)inheritRefs属性:在Ant任务中,如果设定了inheritRefs属性为true,那么被调用的构件文件中的project元素可引用当前project元素中的reference(参考)任务。

Reference任务的作用是把当前的属性复制到被调用的Ant project中使用。References任务包含两个属性,如下:

  ● refid属性:这个属性代表当前project中的属性id。

  ● torefid属性:用于指定在被调用的project中的引用id。

Reference的使用例子如下:

<reference refid="path1" torefid="path2"/>

<!-- // 把当前project中的path1属性传递给被调用的project中使用,

在被调用project中通过path2引用这个属性。  -- >

4.1.2  使用Ant Task整合子项目的实例

在实际的项目中,大的项目都会拆分成独立的几个子项目,开发完后再整合在一起。这样做有利于项目的独立测试和长期维护。如果用Ant工具来构建项目,那么Ant任务就派上用场了。这里以实例来学习Ant任务的作用。

1.指定子项目

<ant antfile="subproject/subbuild.xml" dir="subproject" target="compile"/>

<!-- //指定子项目构件文件及根目录,同时指定要执行的target  -->

2.指定属性并在子项目中调用

<ant antfile="subproject/property_based_subbuild.xml">

  <property name="param1" value="version 1.x"/>

  <property file="config/subproject/ default.properties "/>

</ant>

 <!-- //由于在默认时inheritAll="true",因此当前项目中定义的param1属性和属性文件default.properties都可以在子项目中引用。  -->

3.继承关系

假设在当前构件文件中定义了以下元素:

<path id="path1">    

    ...

</path>

<path id="path2">

    ...

</path>

<ant antfile="subbuild.xml" inheritrefs="true"/>

在被调用的subbuild.xml中定义了<path>类型的path1但没定义<path>类型的path2。那么刚执行构件文件时,被调用的Ant project中的path1不会被覆盖,但path2可以被调用。如果指定inheritrefs="false",那么在被调用的project中既不会覆盖path1也不能引用path2。

当需要覆盖path1时可把Ant任务改为:

<ant antfile="subbuild.xml" inheritrefs="false">

  <reference refid="path1"/>

</ant>

当需要引用当前project中的path1同时也要使用本身的path1,那可以通过reference做到,改写Ant任务为:

<ant antfile="subbuild.xml" inheritrefs="false">

  <reference refid="path1" torefid="path2"/>

</ant>

这个任务的作用是,在被调用的project中建立对当前project中的path1的引用,并命名为path2。在被调用的project中可通过path2来引用。

<!-- page -->

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值