テストタグを作成する

テストタグを作成する

テストタグでリンクを付けるテストクラスとテストメソッドの命名規則を次のように決めます。

テストクラス名は、テストする対象のクラス名の前に「Test」をつけた名前とします。テストメソッド名はテスト対象のメソッド名の1文字目を大文字にし、直前に「test」をつけた名前とします。

例えば、テストする対象のクラスが「Sample」クラスだとすると、テストクラスは「TestSample」クラスになります。また、テストする 対象のメソッドが「getSomething」メソッドだとすると、テストメソッドは「testGetSomething」メソッドになります。

さらにテストメソッドには、名称の後にさらに文字列を加えてもよいこととします。つまり「GetSomething」メソッドの場合、「testGetSomethingRed」メソッドもテストメソッドになります。

テストタグを使ってリファレンスドキュメントを作成したイメージは、次のようになります。

図1：リファレンスドキュメント
（画像をクリックすると別ウィンドウに拡大図を表示します）

開発環境

「第2回：『どんなシステムを作るのか』をJavadocで表現する」と同様、カスタムタグを作るための環境を以下のように想定して進めます。異なる場合は適宜読み替えてください。

なお、Java SE 6については下記のURLよりダウンロードできます。

JDKはCドライブ直下の"C:\java"にインストールしておきます。

今回のテストタグ作成プロジェクトのルートディレクトリは「C:\projects\LinkTestTagletProject」とします。また、今回のプロジェクトでは、前回作成した仕様書タグのjarパッケージをあわせて利用します。

カスタムタグに必要なメソッド

テストタグは「TestTaglet」クラスとして実装します。このクラスは、前回と同様に 「com.sun.tools.doclets.Taglet」インターフェースを実装します。実装のメインとなる「toString(Tag)」メソッ ドがテストタグの書かれた位置を判断し、テストクラスやテストメソッドへのリンク文字列を返します。

Antのビルドプロセスに組み込む

前回作ったAntのビルドファイルを使うことで、Antの削除タスクやコンパイルタスク、jarパッケージングタスク、javadocタスクを連続で実行できます。これを利用するには、ビルドファイルにあるjavadocタスクのTagletエレメントに、今回作成するテストタグの設定を追加しま す。

   さらにコンパイルタスクの対象に、テストコードを含めます。

テストタグの実装ではJavaのリフレクションを使用しています。リフレクションでテストクラスをロードし、テストクラスとテストメソッドの情報を取得しています。

プロパティファイルにはテストコードを置くディレクトリの設定を追加します。