 |
||||||||||||||||
|
||||||||||||||||
| 前のページ 1 2 3 次のページ | ||||||||||||||||
|
||||||||||||||||
| テストタグを作成する | ||||||||||||||||
|
テストタグでリンクを付けるテストクラスとテストメソッドの命名規則を次のように決めます。 テストクラス名は、テストする対象のクラス名の前に「Test」をつけた名前とします。テストメソッド名はテスト対象のメソッド名の1文字目を大文字にし、直前に「test」をつけた名前とします。 例えば、テストする対象のクラスが「Sample」クラスだとすると、テストクラスは「TestSample」クラスになります。また、テストする対象のメソッドが「getSomething」メソッドだとすると、テストメソッドは「testGetSomething」メソッドになります。 さらにテストメソッドには、名称の後にさらに文字列を加えてもよいこととします。つまり「GetSomething」メソッドの場合、「testGetSomethingRed」メソッドもテストメソッドになります。 テストタグを使ってリファレンスドキュメントを作成したイメージは、次のようになります。
⁄**
 図1：リファレンスドキュメント （画像をクリックすると別ウィンドウに拡大図を表示します） |
||||||||||||||||
| 開発環境 | ||||||||||||||||
|
「第2回：『どんなシステムを作るのか』をJavadocで表現する」と同様、カスタムタグを作るための環境を以下のように想定して進めます。異なる場合は適宜読み替えてください。
表2：開発環境 なお、Java SE 6については下記のURLよりダウンロードできます。 JDKはCドライブ直下の"C:\java"にインストールしておきます。 今回のテストタグ作成プロジェクトのルートディレクトリは「C:\projects\LinkTestTagletProject」とします。また、今回のプロジェクトでは、前回作成した仕様書タグのjarパッケージをあわせて利用します。
表3：ディレクトリ構成 |
||||||||||||||||
| カスタムタグに必要なメソッド | ||||||||||||||||
|
テストタグは「TestTaglet」クラスとして実装します。このクラスは、前回と同様に「com.sun.tools.doclets.Taglet」インターフェースを実装します。実装のメインとなる「toString(Tag)」メソッドがテストタグの書かれた位置を判断し、テストクラスやテストメソッドへのリンク文字列を返します。 |
||||||||||||||||
| Antのビルドプロセスに組み込む | ||||||||||||||||
|
前回作ったAntのビルドファイルを使うことで、Antの削除タスクやコンパイルタスク、jarパッケージングタスク、javadocタスクを連続で実行できます。これを利用するには、ビルドファイルにあるjavadocタスクのTagletエレメントに、今回作成するテストタグの設定を追加します。
<taglet name="jp.co.ulsystems.tools.taglets.TestTaglet">
さらにコンパイルタスクの対象に、テストコードを含めます。
<src path="${test}" />
テストタグの実装ではJavaのリフレクションを使用しています。リフレクションでテストクラスをロードし、テストクラスとテストメソッドの情報を取得しています。 プロパティファイルにはテストコードを置くディレクトリの設定を追加します。 |
||||||||||||||||
|
前のページ 1 2 3 次のページ |
||||||||||||||||
|
|
||||||||||||||||
|
|
||||||||||||||||
|
||||||||||||||||
|
|
||||||||||||||||
|
||||||||||||||||
|
|
||||||||||||||||
|
||||||||||||||||
-
-
連載
