これまで3回にわたってTestNGのアノテーションについて紹介した。今回は、これまで紹介したTestNGのアノテーションをまとめ、TestNGアノテーションの効果についてまとめる。

@Test

@Testは、試験用メソッドであることを指定するアノテーション。@Testが指定されたメソッドは、TestNGからみて試験用のメソッドであると判定され、試験の実行に使われる。TestNGで用意しているアノテーションのうち、もっとも中心的な役割を担う。

リスト1 指定したメソッドはTestNGによって試験用メソッドとして扱われる

リスト2 指定したメソッドはTestNGによって試験用メソッドとして扱われ、かつグループaに所属する

リスト3 指定したメソッドはTestNGによって試験用メソッドとして扱われ、かつグループbに所属する

リスト4 指定したメソッドはTestNGによって試験用メソッドとして扱われ、かつ実行が100msで終わらなかった場合にはタイムアウトする

@Testでは、引数を指定することで、メソッドのグループ化、メソッドのタイムアウトの指定を行うことができる。メソッドの依存関係をdependsOnMethodsを使って設定することもできる。すべてのアノテーションの指定で済み、プログラミング用のソースコードを追加する必要はない。

@Configuration

@Configurationは、実行時のタイミングを指定するアノテーション。試験用のメソッドを実行する場合、試験用メソッドを実行するまえに実行するべき処理や、実行後に実行するべき処理がある。@Configurationアノテーションを使って、前後に必要になる処理を指定し、実行させる。

リスト5 試験メソッドを実行するまえに実行するメソッド

リスト6 常に実行するメソッド

@Configurationにおいて指定できるタイミングはalwaysRun、beforeSuite、afterSuite、beforeTest、afterTest、beforeTestClass、afterTestClass、beforeTestMethod、afterTestMethodなど。

@Parameters

@Parametersは、メソッドの引数を指定するためのアノテーション。@Parametersによって指定された引数は、設定ファイルやコマンドラインから引数を指定して実行することができる。

リスト7 引数が1つの場合

リスト8 引数が2つの場合

@Parametersを使うことで、試験コードから引数に指定する値を抜き出すことができ、耐久試験を別の枠組みとして実行することができる。

効果

TestNGで提供されている代表的なアノテーションは次の3つ。特によく使うアノテーションは@Testだ。

• @Test
• @Configuration
• @Parameters

前述した例をみればわかるように、TestNGとして指定しているソースコードはすべてアノテーションであり、アノテーションの域を出ていない。つまり、本来のソースコードには何ら影響を与えることなく、試験用フレームワークの導入を実現している。

これがアノテーションのもたらす、もっとも重要なポイントだ。本来必要となる処理を記述したソースコードには手を加えることなく、目的とする機能の挿入に成功している。

Java技術者に求められる技量

Java EE 5以降で本格的に導入されるアノテーションによって、EJB 3を使ったJava EE 5は大きな変貌を遂げる。ここで紹介したように、多くのアノテーションが使われるようになる。EJB 2までの複雑さに対するアンチテーゼであるように、EJB 3で実現される各種機能は、アノテーションを使って簡単に実現という点を強調してくる。

これからのJava技術者は、アノテーションを使う必要がでてくる。Javaで提供されるCore APIにおけるアノテーションの採用は増えるだろうし、サードパーティが提供するフレームワークやライブラリはさらにアノテーションを使うことになる。

さらに、一歩踏み込んでフレームワークを開発するJava技術者は、設計の段階で意味ごとに領域を分割し、アノテーションを活用する技術が求められる。良かれ悪かれ、Java技術者はアノテーションを理解する必要があるという状況だ。