Tutorial: Writing Tasks

チュートリアル: タスクを実装する

This document provides a step by step tutorial for writing tasks.

この文書では、タスクの実装方法を段階を追って説明します。

Content

もくじ

Set up the build environment

ビルド環境をセットアップする

Ant builds itself, we are using Ant too (why we would write a task if not? :-) therefore we should use Ant for our build.

Antは自分自身をビルドしているので、ここでもAntを使います (そうじゃないなら、なんでタスクを書くの? (^o^) このビルドでもAntを使うべきでしょう)。

We choose a directory as root directory. All things will be done here if I say nothing different. I will reference this directory as root-directory of our project. In this root-directory we create a text file names build.xml. What should Ant do for us?

まず、ルートとなるディレクトリを一つ選びます。 別に言及する場合を除いては、すべての作業はここで行われます。 このディレクトリを、プロジェクトのルートディレクトリと呼ぶことにします。 このルートディレクトリに、まず build.xml というテキストファイルを作成します。 Antは何をすべきでしょうか……?

So the buildfile contains three targets.

つまり、ビルドファイルは三つのターゲットを持ちます。

<?xml version="1.0" encoding="ISO-8859-1UTF-8"?>
<project name="MyTask" basedir="." default="jar">

    <target name="clean" description="Delete all generated files生成したファイルを全て削除する">
        <delete dir="classes"/>
        <delete file="MyTasks.jar"/>
    </target>

    <target name="compile" description="Compiles the Taskタスクをコンパイルする">
        <javac srcdir="src" destdir="classes"/>
    </target>

    <target name="jar" description="JARs the TaskタスクをJAR化する">
        <jar destfile="MyTask.jar" basedir="classes"/>
    </target>

</project>

This buildfile uses often the same value (src, classes, MyTask.jar), so we should rewrite that using <property>s. On second there are some handicaps: <javac> requires that the destination directory exists; a call of "clean" with a non existing classes directory will fail; "jar" requires the execution of some steps bofore. So the refactored code is:

このビルドファイルはよく同じ値を使う(src,classes,MyTask.jar)ので、<property>を使って書き換えるべきです。 また、このビルドファイルには、<javac> は宛先ディレクトリが必要、クラスディレクトリが存在しないときに"clean"を呼び出すと失敗する、"jar" はいくつかの前処理が必要、といった修正すべき点があります。これらを修正すると、以下のようになります:

<?xml version="1.0" encoding="ISO-8859-1UTF-8"?>
<project name="MyTask" basedir="." default="jar">

    <property name="src.dir" value="src"/>
    <property name="classes.dir" value="classes"/>

    <target name="clean" description="Delete all generated files生成したファイルを全て削除する">
        <delete dir="${classes.dir}" failonerror="false"/>
        <delete file="${ant.project.name}.jar"/>
    </target>

    <target name="compile" description="Compiles the Taskタスクをコンパイルする">
        <mkdir dir="${classes.dir}"/>
        <javac srcdir="${src.dir}" destdir="${classes.dir}"/>
    </target>

    <target name="jar" description="JARs the TaskタスクをJAR化する" depends="compile">
        <jar destfile="${ant.project.name}.jar" basedir="${classes.dir}"/>
    </target>

</project>

ant.project.name is one of the build-in properties [1] of Ant.

ant.project.nameは、Antの 組み込みプロパティ [1]の一つです。

Write the Task

タスクを実装する

Now we write the simplest Task - a HelloWorld-Task (what else?). Create a text file HelloWorld.java in the src-directory with:

では、最も簡単なタスク ―― HelloWorldタスク(ほかに何が?) ―― を実装していきましょう。 ソースディレクトリに、以下のような内容の HelloWorld.javaというテキストファイルを作成します:

public class HelloWorld {
    public void execute() {
        System.out.println("Hello World");
    }
}

and we can compile and jar it with ant (default target is "jar" and via its depends-clause the "compile" is executed before).

antと入力して、コンパイルし、jar化できます (デフォルトターゲットが "jar" で、 その depends要素に指定された "compile" が先に実行されています)。

Use the Task

タスクを使う

But after creating the jar we want to use our new Task. Therefore we need a new target "use". Before we can use our new task we have to declare it with <taskdef> [2]. And for easier process we change the default clause:

jarを作ったら、新しいタスクを使いたくなりますね。新しいターゲット、"use" が必要です。 我らが新しいタスクを使う前には、 <taskdef> [2] を使って宣言しておく必要があります。 簡単に実行するために、ついでにdefault属性も変更しておきましょう:

<?xml version="1.0" encoding="ISO-8859-1UTF-8"?>
<project name="MyTask" basedir="." default="use">

    ...

    <target name="use" description="Use the Taskタスクを使う" depends="jar">
        <taskdef name="helloworld" classname="HelloWorld" classpath="${ant.project.name}.jar"/>
        <helloworld/>
    </target>

</project>

Important is the classpath-attribute. Ant searches in its /lib directory for tasks and our task isn't there. So we have to provide the right location.

classpath属性がポイントです。Antはタスクを探すのに /lib ディレクトリを見に行きますが、我らが新しいタスクはそこにはありません。正しい場所を指定してやる必要があります。

Now we can type in ant and all should work ...

antとタイプすれば、全部が動作します ……

Buildfile: build.xml

compile:
    [mkdir] Created dir: C:\tmp\anttests\MyFirstTask\classes
    [javac] Compiling 1 source file to C:\tmp\anttests\MyFirstTask\classes

jar:
      [jar] Building jar: C:\tmp\anttests\MyFirstTask\MyTask.jar

use:
[helloworld] Hello World

BUILD SUCCESSFUL
Total time: 3 seconds

Integration with TaskAdapter

TaskAdapter と統合する

Our class has nothing to do with Ant. It extends no superclass and implements no interface. How does Ant know to integrate? Via name convention: our class provides a method with signature public void execute(). This class is wrapped by Ant's org.apache.tools.ant.TaskAdapter which is a task and uses reflection for setting a reference to the project and calling the execute() method.

我らがクラスはAntとなにも連携していません。どのクラスも継承していないし、どのインタフェースも実装していません。Antはどうやって連携しているのでしょう? 命名規約を通して: 我らがクラスは public void execute()というメソッドを提供しています。 Antのorg.apache.tools.ant.TaskAdapterというタスクが、このクラスをラップし、リフレクションを使ってプロジェクトの参照を設定し、execute()メソッドを呼び出しています。

Setting a reference to the project? Could be interesting. The Project class gives us some nice abilities: access to Ant's logging facilities getting and setting properties and much more. So we try to use that class:

プロジェクトの参照を設定 とは? 興味深い話です。プロジェクトクラスが、 Antのロギング機能、プロパティの設定と取得、そのほかいろいろな、すてきな機能を提供してくれています。 早速、これらの機能を使ってみましょう:

import org.apache.tools.ant.Project;

public class HelloWorld {

    private Project project;

    public void setProject(Project proj) {
        project = proj;
    }

    public void execute() {
        String message = project.getProperty("ant.project.name");
        project.log("Here is project '" + message + "'.", Project.MSG_INFO);
    }
}

and the execution with ant will show us the expected

antと実行すると、以下のような結果になります:

use:
Here is project 'MyTask'.

Deriving from Ant's Task

Antの Task クラスを継承する

Ok, that works ... But usually you will extend org.apache.tools.ant.Task. That class is integrated in Ant, get's the project-reference, provides documentation fiels, provides easier access to the logging facility and (very useful) gives you the exact location where in the buildfile this task instance is used.

オーケー、ちゃんと動作しています……でも普通は org.apache.tools.ant.Taskを継承します。 このクラスはAntに統合されていて、プロジェクトの参照を取得したり、ドキュメントファイルを提供したり、 ログ機能を簡単に利用したり、さらに(これが便利なのですが)このタスクが ビルドファイル中の確たる位置を手に入れることができます。

Oki-doki - let's us use some of these:

オーケーオッケー、いくつか使ってみましょう:

import org.apache.tools.ant.Task;

public class HelloWorld extends Task {
    public void execute() {
        // use of the reference to Project-instanceプロジェクトの参照を使う
        String message = getProject().getProperty("ant.project.name");

        // Task's log methodTaskのログメソッドを使う
        log("Here is project '" + message + "'.");

        // where this task is used?このタスクはどこで使われている?
        log("I am used in: " +  getLocation() );
    }
}

which gives us when running

実行すると、こうなります

use:
[helloworld] Here is project 'MyTask'.
[helloworld] I am used in: C:\tmp\anttests\MyFirstTask\build.xml:23:

Attributes

属性

Now we want to specify the text of our message (it seems that we are rewriting the <echo/> task :-). First we well do that with an attribute. It is very easy - for each attribute provide a public void set<attributename>(<type> newValue) method and Ant will do the rest via reflection.

さて、メッセージを指定してみましょう (<echo/>タスクを再実装しているみたいね (^o^)。まず、属性をつかってやってみましょう。これはとても簡単です ―― 各属性の public void set<属性名>(<型> 値) というメソッドを用意すると、Antがリフレクションを使って適切に処理してくれます。

import org.apache.tools.ant.Task;
import org.apache.tools.ant.BuildException;

public class HelloWorld extends Task {

    String message;
    public void setMessage(String msg) {
        message = msg;
    }

    public void execute() {
        if (message==null) {
            throw new BuildException("No message set.");
        }
        log(message);
    }

}

Oh, what's that in execute()? Throw a BuildException? Yes, that's the usual way to show Ant that something important is missed and complete build should fail. The string provided there is written as build-failes-message. Here it's necessary because the log() method can't handle a null value as parameter and throws a NullPointerException. (Of course you can initialize the message with a default string.)

おっと、execute() の中は何でしょう? throw new BuildException? ……そうです。これが、なにか重要なものが不足していてビルドが失敗すべきことを Antへ通知する、普通のやり方です。このときのメッセージは、ビルド失敗メッセージとして表示されます。 ここでは、log()メソッドが引数のnullを処理できず、NullPointerExceptionを発生するので、この処理が必要になっています (messageをデフォルト文字列で初期化しておく、という対処ももちろんアリです)。

After that we have to modify our buildfile:

このあと、ビルドファイルの修正が必要です:

    <target name="use" description="Use the Task" depends="jar">
        <taskdef name="helloworld"
                 classname="HelloWorld"
                 classpath="${ant.project.name}.jar"/>
        <helloworld message="Hello World"/>
    </target>

That's all.

これで、できあがりです。

Some background for working with attributes: Ant supports any of these datatypes as arguments of the set-method:

属性を使うにあたっていくつか: Antは、セッタメソッドの引数として、以下のデータ型をサポートしています:

Before calling the set-method all properties are resolved. So a <helloworld message="${msg}"/> would not set the message string to "${msg}" if there is a property "msg" with a set value.

プロパティは展開されてからセッタメソッドに渡されます。 つまり、msgというプロパティが設定されているときは、 <helloworld message="${msg}"/> で "${msg}"という文字列が渡されることはありません。

Nested Text

内部テキスト

Maybe you have used the <echo> task in a way like <echo>Hello World</echo>. For that you have to provide a public void addText(String text) method.

<echo>タスクを、<echo>Hello, World</echo>のように使ったことがありますよね。 これを実現するには、public void addText(String text) メソッドを実装します。

...
public class HelloWorld extends Task {
    ...
    public void addText(String text) {
        message = text;
    }
    ...
}

But here properties are not resolved! For resolving properties we have to use Project's replaceProperties(String propname) : String method which takes the property name as argument and returns its value (or ${propname} if not set).

このときは、プロパティは展開されません! プロパティを展開したい場合は、 replaceProperties(String propname) : String メソッドの引数にプロパティ名を指定して呼び出します (プロパティが設定されていなければ ${propname} が帰ってきます)。

Nested Elements

内部要素

There are several ways for inserting the ability of handling nested elements. See the Manual [4] for other. We use the first way of the three described ways. There are several steps for that:

内部要素を扱うにはいくつかの方法があります。詳しくは マニュアル [4]を見てください。 ここでは、三つのうち最初の方法を使います。手順は以下:

  1. We create a class for collecting all the infos the nested element should contain. This class is created by the same rules for attributes and nested elements as for the task (set<attributename>() methods).
  2. The task holds multiple instances of this class in a list.
  3. A factory method instantiates an object, saves the reference in the list and returns it to Ant Core.
  4. The execute() method iterates over the list and evaluates its values.
  1. 内部要素の情報をすべて保持するためのクラスを作る。 このクラスは属性と同じルールで作成しておく ―― (set<attributename>()メソッド)。
  2. リスト型を使ってこのクラスのインスタンスを複数保持する。
  3. このオブジェクトのファクトリメソッドを作り、リストに格納しておいて、それを返す。
  4. execute()メソッドでは、リストをたどって値を取得する。

import java.util.Vector;
import java.util.Iterator;
...
    public void execute() {
        if (message!=null) log(message);
        for (Iterator it=messages.iterator(); it.hasNext(); ) {      // 4
            Message msg = (Message)it.next();
            log(msg.getMsg());
        }
    }

    Vector messages = new Vector();                                  // 2

    public Message createMessage() {                                 // 3
        Message msg = new Message();
        messages.add(msg);
        return msg;
    }

    public class Message {                                           // 1
        public Message() {}

        String msg;
        public void setMsg(String msg) { this.msg = msg; }
        public String getMsg() { return msg; }
    }
...

Then we can use the new nested element. But where is xml-name for that defined? The mapping XML-name : classname is defined in the factory method: public classname createXML-name(). Therefore we write in the buildfile

これで内部要素を使うことができます。でも XML名はどこで定義すればよいのでしょう? XML名とクラス名のマッピングはファクトリメソッドで行います: public classname createXML-name()。ビルドファイルはこうなります

        <helloworld>
            <message msg="Nested Element 1"/>
            <message msg="Nested Element 2"/>
        </helloworld>

Our task in a little more complex version

もうちょっと複雑なタスク

For recapitulation now a little refactored buildfile:

振り返りとして、再構成したビルドファイルを見てみましょう:

<?xml version="1.0" encoding="ISO-8859-1UTF-8"?>
<project name="MyTask" basedir="." default="use">

    <property name="src.dir" value="src"/>
    <property name="classes.dir" value="classes"/>

    <target name="clean" description="Delete all generated files生成したファイルを全て削除する">
        <delete dir="${classes.dir}" failonerror="false"/>
        <delete file="${ant.project.name}.jar"/>
    </target>

    <target name="compile" description="Compiles the Taskタスクをコンパイルする">
        <mkdir dir="${classes.dir}"/>
        <javac srcdir="${src.dir}" destdir="${classes.dir}"/>
    </target>

    <target name="jar" description="JARs the TaskタスクをJAR化する" depends="compile">
        <jar destfile="${ant.project.name}.jar" basedir="${classes.dir}"/>
    </target>


    <target name="use.init"
            description="Taskdef the HelloWorld-TaskHelloWorldタスクをtaskdefする"
            depends="jar">
        <taskdef name="helloworld"
                 classname="HelloWorld"
                 classpath="${ant.project.name}.jar"/>
    </target>


    <target name="use.without"
            description="Use without any単体で使う"
            depends="use.init">
        <helloworld/>
    </target>

    <target name="use.message"
            description="Use with attribute 'message''message'属性を指定して使う"
            depends="use.init">
        <helloworld message="attribute-text"/>
    </target>

    <target name="use.fail"
            description="Use with attribute 'fail''fail'属性を指定して使う"
            depends="use.init">
        <helloworld fail="true"/>
    </target>

    <target name="use.nestedText"
            description="Use with nested text内部テキストを指定して使う"
            depends="use.init">
        <helloworld>nested-text</helloworld>
    </target>

    <target name="use.nestedElement"
            description="Use with nested 'message'内部要素 'message' を指定して使う"
            depends="use.init">
        <helloworld>
            <message msg="Nested Element 1"/>
            <message msg="Nested Element 2"/>
        </helloworld>
    </target>


    <target name="use"
            description="Try all (w/out use.fail)use.fail以外を全部試す"
            depends="use.without,use.message,use.nestedText,use.nestedElement"
    />

</project>

And the code of the task:

タスクの実装は:

import org.apache.tools.ant.Task;
import org.apache.tools.ant.BuildException;
import java.util.Vector;
import java.util.Iterator;

/**
 * The task of the tutorial.チュートリアル用のタスク
 * Print a message or let the build fail.メッセージを表示するか、ビルドを失敗させる。
 * @author Jan Matérne, matobaa(コメント翻訳)
 * @since 2003-08-19
 */
public class HelloWorld extends Task {


    /** The message to print. As attribute.属性 : 表示したいメッセージ */
    String message;
    public void setMessage(String msg) {
        message = msg;
    }

    /** Should the build fail? Defaults to false. As attribute.属性 : ビルドを失敗させるかどうか。デフォルトは false */
    boolean fail = false;
    public void setFail(boolean b) {
        fail = b;
    }

    /** Support for nested text.内部テキストをサポート */
    public void addText(String text) {
        message = text;
    }


    /** Do the work.仕事をする */
    public void execute() {
        // handle attribute 'fail''fail'属性を処理する
        if (fail) throw new BuildException("Fail requested.");

        // handle attribute 'message' and nested text'message'属性と内部テキストを処理する
        if (message!=null) log(message);

        // handle nested elements内部要素を処理する
        for (Iterator it=messages.iterator(); it.hasNext(); ) {
            Message msg = (Message)it.next();
            log(msg.getMsg());
        }
    }


    /** Store nested 'message's.内部要素 'message' を格納する */
    Vector messages = new Vector();

    /** Factory method for creating nested 'message's.内部要素 'message' のファクトリメソッド */
    public Message createMessage() {
        Message msg = new Message();
        messages.add(msg);
        return msg;
    }

    /** A nested 'message'.'message'内部要素 */
    public class Message {
        // Bean constructorコンストラクタ
        public Message() {}

        /** Message to print.表示するメッセージ */
        String msg;
        public void setMsg(String msg) { this.msg = msg; }
        public String getMsg() { return msg; }
    }

}

And it works:

動作は以下のようになります:

C:\tmp\anttests\MyFirstTask>ant
Buildfile: build.xml

compile:
    [mkdir] Created dir: C:\tmp\anttests\MyFirstTask\classes
    [javac] Compiling 1 source file to C:\tmp\anttests\MyFirstTask\classes

jar:
      [jar] Building jar: C:\tmp\anttests\MyFirstTask\MyTask.jar

use.init:

use.without:

use.message:
[helloworld] attribute-text

use.nestedText:
[helloworld] nested-text

use.nestedElement:
[helloworld]
[helloworld]
[helloworld]
[helloworld]
[helloworld] Nested Element 1
[helloworld] Nested Element 2

use:

BUILD SUCCESSFUL
Total time: 3 seconds
C:\tmp\anttests\MyFirstTask>ant use.fail
Buildfile: build.xml

compile:

jar:

use.init:

use.fail:

BUILD FAILED
C:\tmp\anttests\MyFirstTask\build.xml:36: Fail requested.

Total time: 1 second
C:\tmp\anttests\MyFirstTask>

Next step: test ...

次のステップはテストです……

Test the Task

タスクをテストする

We have written a test already: the use.* tasks in the buildfile. But its difficult to test that automatically. Common (and in Ant) used is JUnit for that. For testing tasks Ant provides a baseclass org.apache.tools.ant.BuildFileTest. This class extends junit.framework.TestCase and can therefore be integrated into the unit tests. But this class provides some for testing tasks useful methods: initialize Ant, load a buildfile, execute targets, expecting BuildExceptions with a specified text, expect a special text in the output log ...

テストはもう書いてあります: ビルドファイル中のuse.* というタスクがそれです。 しかし、これでは自動的なテストはできません。 一般的に(Antでも)、自動テストにはJUnitを使います。 Antでは、タスクをテストするための org.apache.tools.ant.BuildFileTest というクラスが用意されています。 このクラスは junit.framework.TestCaseクラスを拡張しているので、単体テストと統合することができます。また、このクラスには、 Antの初期化、ビルドファイルの読み込み、ターゲットの実行、指定したメッセージを含むBuildExceptionの確認、出力ログへの出力文字列の確認といった、タスクをテストするための便利なメソッドが用意されています。

In Ant it is usual that the testcase has the same name as the task with a prepending Test, therefore we will create a file HelloWorldTest.java. Because we have a very small project we can put this file into src directory (Ant's own testclasses are in /src/testcases/...). Because we have already written our tests for "hand-test" we can use that for automatic tests, too. But there is one little problem we have to solve: all test supporting classes are not part of the binary distribution of Ant. So you can build the special jar file from source distro with target "test-jar" or you can download a nightly build from http://gump.covalent.net/jars/latest/ant/ant-testutil.jar [5].

Antでは一般的に、テストケースの名前として、タスクの前にTestをくっつけたものを命名します。したがって、これから作成するファイルの名前はHelloWorldTest.javaとなります。 現在のプロジェクトはとても小さいので、このファイルはsrcにおきましょう (Ant自身のテストクラスは /src/testcases/... にあります)。 手動のテストはもう作ってあるので、これを自動テストにも使います。 ここでちょっと問題があります: Antの配布物には、クラスを対象としたテストの全ては含まれていないので、 ソースディストリビューションの test-jarターゲットでjarファイルをビルドしておくか、 http://gump.covalent.net/jars/latest/ant/ant-testutil.jar [5] のナイトリービルドをダウンロードしてください。

For executing the test and creating a report we need the optional tasks <junit> and <junitreport>. So we add to the buildfile:

テストを実行してレポートを作成するには、 <junit> と <junitreport> というタスクが必要です。ビルドファイルに追加しましょう:

...
<project name="MyTask" basedir="." default="test">
...
    <property name="ant.test.lib" value="ant-testutil.jar"/>
    <property name="report.dir"   value="report"/>
    <property name="junit.out.dir.xml"  value="${report.dir}/junit/xml"/>
    <property name="junit.out.dir.html" value="${report.dir}/junit/html"/>

    <path id="classpath.run">
        <path path="${java.class.path}"/>
        <path location="${ant.project.name}.jar"/>
    </path>

    <path id="classpath.test">
        <path refid="classpath.run"/>
        <path location="${ant.test.lib}"/>
    </path>

    <target name="clean" description="Delete all generated files生成したファイルを全て削除する">
        <delete failonerror="false" includeEmptyDirs="true">
            <fileset dir="." includes="${ant.project.name}.jar"/>
            <fileset dir="${classes.dir}"/>
            <fileset dir="${report.dir}"/>
        </delete>
    </target>

    <target name="compile" description="Compiles the Taskタスクをコンパイルする">
        <mkdir dir="${classes.dir}"/>
        <javac srcdir="${src.dir}" destdir="${classes.dir}" classpath="${ant.test.lib}"/>
    </target>
...
    <target name="junit" description="Runs the unit tests単体テストを実行する" depends="jar">
        <delete dir="${junit.out.dir.xml}" />
        <mkdir  dir="${junit.out.dir.xml}" />
        <junit printsummary="yes" haltonfailure="no">
            <classpath refid="classpath.test"/>
            <formatter type="xml"/>
            <batchtest fork="yes" todir="${junit.out.dir.xml}">
                <fileset dir="${src.dir}" includes="**/*Test.java"/>
            </batchtest>
        </junit>
    </target>

    <target name="junitreport" description="Create a report for the rest resultテスト結果のレポートを作成する">
        <mkdir dir="${junit.out.dir.html}" />
        <junitreport todir="${junit.out.dir.html}">
            <fileset dir="${junit.out.dir.xml}">
                <include name="*.xml"/>
            </fileset>
            <report format="frames" todir="${junit.out.dir.html}"/>
        </junitreport>
    </target>

    <target name="test"
            depends="junit,junitreport"
            description="Runs unit tests and creates a report単体テストを実行してレポートを作成する"
    />
...

Back to the src/HelloWorldTest.java. We create a class extending BuildFileTest with String-constructor (JUnit-standard), a setUp() method initializing Ant and for each testcase (targets use.*) a testXX() method invoking that target.

src/HelloWorldTest.javaを作っていきます。このクラスは、 BuildFileTestを拡張し、文字列をとるコンストラクタ、 Antを初期化するためのsetUp()メソッド、各テストケース( use.* ターゲット ) を実行するための textXX()メソッドを実装します。

import org.apache.tools.ant.BuildFileTest;

public class HelloWorldTest extends BuildFileTest {

    public HelloWorldTest(String s) {
        super(s);
    }

    public void setUp() {
        // initialize AntAntを初期化する
        configureProject("build.xml");
    }

    public void testWithout() {
        executeTarget("use.without");
        assertEquals("Message was logged but should not.出力されるべきでないメッセージが出力された", getLog(), "");
    }

    public void testMessage() {
        // execute target 'use.nestedText' and expect a message'use.nestedText' ターゲットを実行して、
        // 'attribute-text' in the logログに'attribute-text'があることを確認する
        expectLog("use.message", "attribute-text");
    }

    public void testFail() {
        // execute target 'use.fail' and expect a BuildException'use.fail'ターゲットを実行して、
        // with text 'Fail requested.''Fail requested.'というBuildExceptionが出ることを確認する
        expectBuildException("use.fail", "Fail requested.");
    }

    public void testNestedText() {
        expectLog("use.nestedText", "nested-text");
    }

    public void testNestedElement() {
        executeTarget("use.nestedElement");
        assertLogContaining("Nested Element 1");
        assertLogContaining("Nested Element 2");
    }
}

When starting ant we'll get a short message to STDOUT and a nice HTML-report.

antを実行すると、標準出力に短いメッセージと、HTMLのレポートが得られます。

C:\tmp\anttests\MyFirstTask>ant
Buildfile: build.xml

compile:
    [mkdir] Created dir: C:\tmp\anttests\MyFirstTask\classes
    [javac] Compiling 2 source files to C:\tmp\anttests\MyFirstTask\classes

jar:
      [jar] Building jar: C:\tmp\anttests\MyFirstTask\MyTask.jar

junit:
    [mkdir] Created dir: C:\tmp\anttests\MyFirstTask\report\junit\xml
    [junit] Running HelloWorldTest
    [junit] Tests run: 5, Failures: 0, Errors: 0, Time elapsed: 2,334 sec



junitreport:
    [mkdir] Created dir: C:\tmp\anttests\MyFirstTask\report\junit\html
[junitreport] Using Xalan version: Xalan Java 2.4.1
[junitreport] Transform time: 661ms

test:

BUILD SUCCESSFUL
Total time: 7 seconds
C:\tmp\anttests\MyFirstTask>

Resources

リソース

This tutorial and its resources are available via BugZilla [6]. The ZIP provided there contains

このチュートリアルとリソースは、 BugZilla [6] で手に入ります。 Zipファイルには以下が含まれています

The last sources and the buildfile are also available here [7] inside the manual.

最終版のソースとビルドファイルは、 ここ [7]にも置いてあります。

Used Links:

使用したリンク:

  [1] http://ant.apache.org/manual/using.html#built-in-props
  [2] http://ant.apache.org/manual/CoreTasks/taskdef.html
  [3] http://ant.apache.org/manual/develop.html#set-magic
  [4] http://ant.apache.org/manual/develop.html#nested-elements
  [5] http://gump.covalent.net/jars/latest/ant/ant-testutil.jar
  [6] http://nagoya.apache.org/bugzilla/show_bug.cgi?id=22570
  [7] tutorial-writing-tasks-src.zip

Copyright © 2003-2004 The Apache Software Foundation. All rights Reserved.
[訳注:これは的場聡弘が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]