BuildExceptionクラス

Antの自作タスクで例外を扱うクラス。

BuildExceptionはRuntimeExceptionから派生しているので明示的にthrowsを宣言する必要は無いのだが、Task#execute()等では明示的に宣言されている。

• コンストラクター
• メッセージ

スローの仕方

単純にメッセージを書くには、Stringのみを引数に持つコンストラクターを使えばよい。
また、他の例外をラップすることも出来る。

import org.apache.tools.ant.BuildException;

		throw new BuildException("メッセージ");
		throw new BuildException(e);
		throw new BuildException("メッセージ", e);

すると、以下のようにメッセージが表示される。

BUILD FAILED
build.xml:218: メッセージ

build.xmlのファイル名の直後の数字は、行番号。例外が出たタスクのある行が示される。

DataTypeを継承したクラスの中で例外を発生させたい場合は、ロケーションも指定してやる方がいい。

public class HogeType extends DataType {

	public void 呼ばれるメソッド() throws BuildException {

		throw new BuildException("メッセージ", getLocation());
		throw new BuildException(e, getLocation());
		throw new BuildException("メッセージ", e, getLocation());
	}
}

Locationは、TaskやDataTypeがbuild.xmlファイル上のどの行で書かれたかを示すクラス。
BuildExceptionにロケーションを指定しないと、Antが自動的にbuild.xml上のタスクの開始行をセットしてくれる。
しかしDataTypeの場合はその位置とは離れた場所に書かれていることが多いので、ちょっと分かりにくくなってしまう。
（特に複数のDataTypeをタスク内に指定していた場合にどのDataTypeか分かりにくくなる）

DataType#getLocation()で位置を取得できるので、BuildExceptionに渡すことが出来る。

メッセージ内容

属性やボディー部に書かれた要素の精査エラー時のメッセージはどう書けばよいか。
は、タスク設計ガイドラインに書かれている“属性名の一貫性の無さ”と同様に、統一されていない(苦笑)