ant 标签名 自定义Task

 ANT  

在 build.xml  文件中：

Task名 ：  为何有的Task名是有意思的，有的Task名是没有意义的？

Task 属性  ：   同上

例如：  javac 和 jar 都是有效的Task  名， destdir 和 jarfile 也是有效的 Task 属性名 ，为何我们现在不能 将javac 修改为 WF destdir 修改为 wfdir        

    <target name="modules" depends="prepare,bot">
                   <!-- compile just module classes -->
                   <javac destdir="${build.classes}/modules"
                          debug="$debug.flag"
                          deprecation="on"
                          >
                          <!-- also we need more info -->
                          <src path="${src.dir}"/>
                          <include name="irssibot/modules/**"/>
                          <classpath refid="classpath"/>
                   </javac>
                  
                   <!-- build the modules as a jar -->
                   <jar jarfile="${build.lib}/irssimodules.jar"
                        basedir="${build.classes}/modules">
                        <include name="irssibot/modules/**"/>
                   </jar>
           </target>

 

简单总结下就是：

XML 能用的Task 名是 package org.apache.tools.ant.Task 的子类。 （我们自己也可以扩展这个类创建自己的Task）

XML 能用的Task 属性 是Task及子类中自己定义的 field 的名字，并且设置了public voidsetXXX(){}

ANT Task 赋值：      XML 中我们定义了属性  ant engine 生成了 Task实例， 通过java 的Reflectiong 机制 ant engine 给Task 实例赋值（XML中的属性） 

 

自己的TASK打包存放位置： 

编译任务设计到使用当前的Ant库（ant.jar），还要用到你的任务的基本包结构。 许多人将定制任务放在org.apache.tools.ant.taskdefs.optional 包中，不过ant并不要求这样做。可以选择一个适合你的包和工程组织

 

简单的参考地址：

http://blog.csdn.net/liuwei_blog/article/details/3565599

 

//=============================================参考原文==================================================================

Ant自带了大量的任务(Task)，在网上也有大量的任务可用，可是如果你面对的是别人根本不会想到的问题，怎么办呢？其实，只要花一点点功夫就可以编写出自己的任务出来。我开始也没想到会这样简单（做嵌套任务碰到一点问题），由此可见Ant的结构设计是相当优秀的。

 

假设我们需要显示任务执行各花了多少时间，写一个TimerTask

 

起步：覆盖org.apache.tools.ant.Task的execute方法

 

import org.apache.tools.ant.Task;

import org.apache.tools.ant.BuildException;

 

 

public class TimerTask extends Task {

public void execute() throws BuildException {

    System.out.println("I am a timer");

}

}

注意，编译时ant.jar必须在Classpath上。

简单起见，假设Java源文件,类文件在同一目录下，在此目录再写一个build.XML文件：

<?xml version="1.0" ?>

<project name="testTimer" default="test" basedir=".">

<taskdef name="timer" classname="TimerTask" classpath="."/>

 

<target name="test">

    <timer />

</target>

</project>

 

打开Dos窗口，到此目录，运行ant

够简单吧！如果类路径比这复杂或者在jar文件中，设置<taskdef>的classpath属性就行了。

 

继续：设置属性

假设我们想添加一个action属性，在Java文件中：

private String action;

….

public void execute() throws BuildException {

if (action.equals(“init”)) {

        …

}

…

}

 

public String getAction() {

return action;

}

 

public void setAction(String string) {

action = string;

}

 

在xml文件中：

<timer action=”init” />

 

使用Project保存中间结果

对于这个任务来讲，必须把时间值保存起来，比较合适的就是org.apache.tools.ant.Project了，Project对象生命期是整个Build，并且可以通过setProperty, getProperty等方法保存/获取值。

 

public void execute() throws BuildException {

    if (getOwningTarget() == null)

        return;

    Project proj = getOwningTarget().getProject();

    …

    // can do smt with proj now

}

 

晋级：嵌套任务

如果我们想要在Timer下面再嵌套子任务（好像没有这个必要 :-）：

<timer action=”init” >

<foo />

</timer>

 

那我们首先只需要写一个简单的FooTask，然后在build.xml加上<foo>的定义:

<taskdef name="timer" classname="TimerTask" classpath="."/>

<taskdef name="foo" classname="FooTask" classpath="."/> 

 

然后给TimerTask添加一个方法：

public void addFoo(FooTask foo) {

}

注意：addXXX的XXX由<taskdef>中的name决定，Ant会利用Java Reflection去找；类型必须是具体的类型FooTask，不能是Task。

 

 

TimerTask.Java:

 

import java.util.*;

 

import org.apache.tools.ant.Task;

import org.apache.tools.ant.Project;

import org.apache.tools.ant.BuildException;

 

/**

 * TimerTask.java

 * <p>Copyright: Copyright (c) 2003 你可以对本程序随意修改，复制，使用，但请保留这里注释声明！！！</p>

  * @author 李尚强 blundblade@sina.com

 */

 

public class TimerTask extends Task {

private List fooList = new ArrayList();

private String action = ""; //init, print

private static final String TIME_PROPERTY_INTERNAL = "timer.msecs";

private static final String TIME_PROPERTY_NAME = "timer.passed";

public void execute() throws BuildException {

    System.out.println("I am a timer");

    System.out.println("but there are so many foos: " + fooList);

          

    if (this.getOwningTarget() == null)

        return;

    Project proj = this.getOwningTarget().getProject();

    String strTime = proj.getProperty(TIME_PROPERTY_INTERNAL);

   

    try {

        long currMSecs = System.currentTimeMillis();

        if (action.equals("print")){

           if (strTime == null)

               proj.setProperty(TIME_PROPERTY_NAME, "Timer not initilized");

           else {

               long startMSecs = Long.parseLong(strTime);

               long passedSecs = currMSecs - startMSecs;

               int minutes = (int) ( passedSecs * 1.0 / (1000 * 60 * 60) );

               int hours = minutes / 60;

               minutes = minutes % 60;

               strTime = hours + " hours " + minutes + " minutes";

               proj.setProperty(TIME_PROPERTY_NAME, strTime);

           }

        }

        else if (action.equals("init")) {

           proj.setProperty(TIME_PROPERTY_INTERNAL, Long.toString(currMSecs));  

        }

       

    }

    catch (NumberFormatException nfe) {

        throw new BuildException(nfe.getMessage());

    }

   

 

}

public void addFoo(FooTask foo){

    fooList.add(foo);

}

/**

 * @return

 */

public String getAction() {

    return action;

}

 

/**

 * @param string

 */

public void setAction(String string) {

    action = string;

}

 

}

FooTask.Java:

 

/*

 * Created on 2004-4-17

 *

 */

 

import org.apache.tools.ant.Task;

 

 

/**

 * FooTask.java

 * <p>Copyright: Copyright (c) 2003 你可以对本程序随意修改，复制，使用，但请保留这里注释声明！！！</p>

  * @author 李尚强 blundblade@sina.com

 */

 

public class FooTask extends Task {

private String name = "";

/**

 * @return

 */

public String getName() {

    return name;

}

 

/**

 * @param string

 */

public void setName(String string) {

    name = string;

}

public String toString() {

    return name;

}

 

}

 

build.XML:

<?xml version="1.0" ?>

<project name="testTimer" default="test" basedir=".">

<taskdef name="timer" classname="TimerTask" classpath="."/>

<taskdef name="foo" classname="FooTask" classpath="."/>

 

<target name="test">

    <timer action="init">

        <foo name="F1" />

        <foo name="F2" />

        <foo name="F3" />

        <foo name="F4" />                            

    </timer>

   

    <!-- You can do some long-time work here -->

   

    <timer action="print" />

    <echo message="You have use time :${timer.passed}" />

</target>

</project>