Java クラスライブラリプロジェクトの作成

1. メインメニューから「ファイル」>「新規プロジェクト」を選択します。
2. 「Java」カテゴリから「Java クラスライブラリ」を選択し、「次へ」をクリックします。
3. プロジェクトとして「JUnit-Sample」と入力し、プロジェクトの場所を設定します。
4. 専用フォルダを使用するオプションが選択されている場合は選択を解除します。

   このチュートリアルでは、ライブラリをほかのユーザーまたはプロジェクトと共有する必要がないので、プロジェクトライブラリを専用のフォルダにコピーする理由はほとんどありません。

   「完了」をクリックします。

JUnit テストをはじめて作成すると、IDE からバージョンを選択するよう求められ、そのあとに「テストライブラリ」ノードと JUnit ライブラリが追加されます。

ソリューションプロジェクトのダウンロード

このチュートリアルで使用するプロジェクト JUnitSampleSol は、次の方法でダウンロードできます。

• 完了したプロジェクトの ZIP アーカイブをダウンロードします。
• 次の手順を実行して、プロジェクトソースを NetBeans のサンプルからチェックアウトします。
  1. メインメニューから「チーム」>「Subversion」>「チェックアウト」を選択します。
  2. 「チェックアウト」ダイアログで次のリポジトリ URL を入力します。
     https://svn.netbeans.org/svn/samples~samples-source-code
     「次へ」をクリックします。
  3. 「チェックアウトするフォルダ」パネルで、「参照」をクリックして「リポジトリフォルダを参照」ダイアログボックスを開きます。
  4. ルートノードを展開し、samples/java/JUnitSampleSol を選択します。「了解」をクリックします。
  5. ソースのローカルフォルダを指定します。「完了」をクリックします。

     「完了」をクリックすると、IDE はローカルフォルダを Subversion リポジトリとして初期化し、プロジェクトソースをチェックアウトします。

  6. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。

  Subversion のインストールの詳細については、「NetBeans IDE での Subversion ガイド」の「Subversion の設定」を参照してください。

注 (NetBeans IDE 7.0 および 7.1)。 IDE のインストール時に JUnit プラグインをインストールしなかった場合は、NetBeans プロジェクトを開いたときに、JUnit ライブラリへの参照を解決するために JUnit プラグインをインストールするよう求められます。

Java クラスの作成

この課題では、JUnitSampleSol サンプルプロジェクトから Utils.java ファイルおよび Vectors.java ファイルを、作成したクラスライブラリプロジェクトにコピーします。

1. 「プロジェクト」ウィンドウで、JUnit-Sample プロジェクトの「ソースパッケージ」ノードを右クリックし、ポップアップメニューから「新規」>「Java パッケージ」を選択します。
2. パッケージ名として「sample」と入力します。「完了」をクリックします。
3. JUnitSampleSol プロジェクトを開き (まだ開いていない場合)、「プロジェクト」ウィンドウで「ソースパッケージ」ノードを展開します。
   
4. JUnitSampleSol プロジェクト内のクラス Utils.java と Vectors.java をコピーし、それらを JUnit-Sample 内の sample ソースパッケージにペーストします。

クラスのソースコードを見ると、Utils.java に 3 つのメソッド (computeFactorial、concatWords、および normalizeWord) があり、Vectors.java に 2 つのメソッド (equal および scalarMultiplication) があることがわかります。次の手順では、各クラス用のテストクラスを作成し、メソッド用にいくつかのテストクラスを記述します。

注: JUnitSampleSol プロジェクトは、もう必要がなくなったため閉じてかまいません。JUnitSampleSol プロジェクトには、このドキュメントで説明されているすべてのテストが含まれています。

Vectors.java 用のテストクラスの作成

この課題では、Vectors.java 用の JUnit テストスケルトンを作成します。

1. Vectors.java を右クリックし、「ツール」>「JUnit テストを作成」を選択します。
2. 「JUnit のバージョンを選択」ダイアログで「JUnit 3.x」を選択します。
   

   JUnit 3.x を選択すると、プロジェクトから JUnit 4 ライブラリが削除されます。

3. 「テストを作成」ダイアログで、テストクラスの名前を VectorsJUnit3Test に変更します。

   テストクラスの名前を変更するときは、名前が変更されることを警告するメッセージが表示されます。デフォルト名は、テスト対象のクラス名をベースに、末尾に「Test」を追加したものです。たとえば、MyClass.java クラスの場合、テストクラスのデフォルト名は「MyClassTest.java」です。通常はデフォルト名のままにするのが最適ですが、このチュートリアルでは JUnit 4 テストも同じパッケージ内に作成するため、また、テストクラスの名前は一意にする必要があるため、名前を変更します。

4. 「テスト初期化」および「テスト終了」を選択解除します。「了解」をクリックします。
   

   「了解」をクリックすると、IDE によって、「プロジェクト」ウィンドウ内の「テストパッケージ」ノードの下にある sample パッケージ内に VectorsJUnit3Test.java テストクラスが作成されます。

   

   プロジェクトには、テストを作成するためのテストパッケージ用ディレクトリが必要です。テストパッケージディレクトリのデフォルトの場所はプロジェクトのルートレベルですが、プロジェクトの種類によって、プロジェクトの「プロパティー」ダイアログでディレクトリに別の場所を指定できます。

   生成したテストクラス VectorsJUnit3Test.java をエディタで表示すると、次のテストクラスが equal メソッドと scalarMultiplication メソッドに対するテストメソッドとともに生成されたことがわかります。

   public class VectorsJUnit3Test extends TestCase {
       /**
        * Test of equal method, of class Vectors.
        */
       public void testEqual() {
           System.out.println("equal");
           int[] a = null;
           int[] b = null;
           boolean expResult = false;
           boolean result = Vectors.equal(a, b);
           assertEquals(expResult, result);
           // TODO review the generated test code and remove the default call to fail.
           fail("The test case is a prototype.");
       }
   
       /**
        * Test of scalarMultiplication method, of class Vectors.
        */
       public void testScalarMultiplication() {
           System.out.println("scalarMultiplication");
           int[] a = null;
           int[] b = null;
           int expResult = 0;
           int result = Vectors.scalarMultiplication(a, b);
           assertEquals(expResult, result);
           // TODO review the generated test code and remove the default call to fail.
           fail("The test case is a prototype.");
       }
   }

生成された各テストのメソッド本体は、ガイドとしてのみ用意されており、実際のテストケースにするには変更する必要があります。コードを生成しない場合は、「テストを作成」ダイアログの「デフォルトのメソッド本体」を選択解除します。

IDE がテストメソッドの名前を生成する場合、各メソッド名の先頭に「test」が付加されます。これは、JUnit 3 ではテストを識別するために命名規則とリフレクションが使用されるためです。テストメソッドを識別するために、各テストメソッドは「test<名前>」という構文に従う必要があります。

JUnit 4 では注釈を使用してテストメソッドを識別できるため、このテストメソッドの命名構文を使用する必要がなくなり、テストクラスは TestCase を拡張する必要がなくなりました。

Vectors.java 用のテストメソッドの記述

この課題では、生成したテストメソッドを変更してテストが機能するようにし、デフォルトの出力メッセージを変更します。テストを実行するために出力メッセージを変更する必要はありませんが、「JUnit テスト結果」出力ウィンドウに表示される結果を識別するのに役立つよう、出力を変更します。

1. エディタで VectorsJUnit3Test.java を開きます。
2. println の値を変更し、生成された変数を削除することによって、testScalarMultiplication のテストスケルトンを変更します。テストメソッドは次のようになるはずです (ボールド部分が変更箇所)。

   public void testScalarMultiplication() {
       System.out.println("* VectorsJUnit3Test: testScalarMultiplication()");
       assertEquals(expResult, result);
   }

3. ここで、メソッドをテストするためのアサーションを追加します。

   public void testScalarMultiplication() {
       System.out.println("* VectorsJUnit3Test: testScalarMultiplication()");
       assertEquals(  0, Vectors.scalarMultiplication(new int[] { 0, 0}, new int[] { 0, 0}));
       assertEquals( 39, Vectors.scalarMultiplication(new int[] { 3, 4}, new int[] { 5, 6}));
       assertEquals(-39, Vectors.scalarMultiplication(new int[] {-3, 4}, new int[] { 5,-6}));
       assertEquals(  0, Vectors.scalarMultiplication(new int[] { 5, 9}, new int[] {-9, 5}));
       assertEquals(100, Vectors.scalarMultiplication(new int[] { 6, 8}, new int[] { 6, 8}));
   }

   このテストメソッドでは、JUnit の assertEquals メソッドが使用されます。アサーションを使用するには、入力変数と、期待する結果を指定します。テストに合格するには、テスト済みメソッドを実行したときに、テストメソッドが供給した変数に基づいて、期待されるすべての結果を正常に返す必要があります。さまざまな考えられる並べ替えを実行するため、十分な数のアサーションを追加するようにしてください。

4. 生成されたメソッド本体を削除し、次の println を追加することによって、testEqual のテストスケルトンを変更します。

       System.out.println("* VectorsJUnit3Test: testEqual()");

   テストメソッドは次のようになるはずです。

   public void testEqual() {
       System.out.println("* VectorsJUnit3Test: testEqual()");
   }

5. 次のアサーションを追加することによって testEqual メソッドを変更します (ボールド部分が変更箇所)。

   public void testEqual() {
       System.out.println("* VectorsJUnit3Test: testEqual()");
       assertTrue(Vectors.equal(new int[] {}, new int[] {}));
       assertTrue(Vectors.equal(new int[] {0}, new int[] {0}));
       assertTrue(Vectors.equal(new int[] {0, 0}, new int[] {0, 0}));
       assertTrue(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0, 0}));
       assertTrue(Vectors.equal(new int[] {5, 6, 7}, new int[] {5, 6, 7}));
   
       assertFalse(Vectors.equal(new int[] {}, new int[] {0}));
       assertFalse(Vectors.equal(new int[] {0}, new int[] {0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0}, new int[] {0, 0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0}, new int[] {0}));
       assertFalse(Vectors.equal(new int[] {0}, new int[] {}));
   
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0, 1}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 1, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {1, 0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 1}, new int[] {0, 0, 3}));
   }

   このテストは JUnit の assertTrue メソッドと assertFalse メソッドを使用して、考えられるさまざまな結果をテストします。このメソッドのテストに合格するには、assertTrue がすべて true 、assertFalse がすべて false である必要があります。

6. 変更を保存します。

比較: Vectors.java 用のテストメソッドの記述 (JUnit 4)

Utils.java 用のテストクラスの作成

ここで、Utils.java のテストスケルトンを作成します。前の課題でテストを作成したとき、JUnit のバージョンを確認するメッセージが表示されました。今回はバージョンの選択を求めるメッセージは表示されません。

1. Utils.java を右クリックし、「ツール」>「JUnit テストを作成」を選択します。
2. ダイアログで「テスト初期化」および「テスト終了」が選択されていない場合は選択します。
3. 「テストを作成」ダイアログで、テストクラスの名前を UtilsJUnit3Test に変更します。「了解」をクリックします。

「了解」をクリックすると、「テストパッケージ」の samples ディレクトリに、テストファイル UtilsJUnit3Test.java が作成されます。Utils.java 内にあるメソッド用に testComputeFactorial、testConcatWords、および testNormalizeWord のテストスケルトンを作成するほか、テスト初期化メソッド setUp およびテスト終了メソッド tearDown も作成されます。

Utils.java 用のテストメソッドの記述

この課題では、共通の JUnit テスト要素の一部を示す、いくつかのテストケースを追加します。一部のメソッドはデフォルトで出力をプリントしないため、println もメソッドに追加します。println をメソッドに追加することで、メソッドが実行されたかどうか、どの順番でメソッドが実行されたかを、あとで JUnit テスト結果ウィンドウで確認できます。

これでテストが記述されたので、テストを実行し、テスト出力を「JUnit テスト結果」ウィンドウで確認できます。

テストの実行

JUnit テストを実行すると、結果が IDE の「JUnit テスト結果」ウィンドウに表示されます。個々の JUnit テストクラスを実行するか、またはメインメニューから「実行」>「<プロジェクト名> のテスト」を選択して、プロジェクトのすべてのテストを実行できます。「実行」>「テスト」を選択すると、「テストパッケージ」フォルダにあるすべてのテストクラスが実行されます。個々のテストクラスを実行するには、「テストパッケージ」ノードのテストクラスを右クリックし、「ファイルを実行」を選択します。

1. 「プロジェクト」ウィンドウで「JUnit-Sample」プロジェクトノードを右クリックし、「主プロジェクトとして設定」を選択します。
2. メインメニューから「実行」>「プロジェクト (JUnit-Sample) をテスト」を選択します。

テストの実行時、「JUnit テスト結果」ウィンドウに次の結果のいずれかが表示されます。

この画像 (クリックして大きい画像を表示) では、プロジェクトがすべてのテストに合格したことがわかります。左区画には個々のテストメソッドの結果が表示され、右区画にはテスト出力が表示されます。出力を確認すると、テストが実行された順序がわかります。各テストメソッドに追加した println により、テストの名前が出力ウィンドウに出力されます。UtilJUnit3Test では、各テストメソッドの前に setUp メソッドが実行されたこと、および各メソッドのあとに tearDown メソッドに実行されたことも確認できます。

この画像 (クリックして大きい画像を表示) では、プロジェクトがテストの 1 つに失敗したことがわかります。testTimeout メソッドの完了に時間がかかりすぎ、テストスレッドが中断されたため、テストが失敗しました。ランダムに生成された数字 (22991) の階乗の計算に 1000 ミリ秒以上かかりました。

Vectors.java 用のテストクラスの作成

この課題では、Vectors.java 用の JUnit テストスケルトンを作成します。

1. Vectors.java を右クリックし、「ツール」>「JUnit テストを作成」を選択します。
2. 「JUnit のバージョンを選択」ダイアログで JUnit 4.x を選択します。
   
3. 「テストを作成」ダイアログで、テストクラスの名前を VectorsJUnit4Test に変更します。

   テストクラスの名前を変更するときは、名前が変更されることを警告するメッセージが表示されます。デフォルト名は、テスト対象のクラス名をベースに、末尾に「Test」を追加したものです。たとえば、MyClass.java クラスの場合、テストクラスのデフォルト名は「MyClassTest.java」です。JUnit 3 とは異なり、JUnit 4 ではテスト名の末尾に「Test」を付ける必要はありません。通常はデフォルト名をそのまま使用するのが最適ですが、このチュートリアルではすべての JUnit テストを同じパッケージ内に作成するため、テストクラスの名前は一意にします。

4. 「テスト初期化」および「テスト終了」を選択解除します。「了解」をクリックします。
   

「了解」をクリックすると、IDE によって、「プロジェクト」ウィンドウ内の「テストパッケージ」ノードの下にある sample パッケージ内に VectorsJUnit4Test.java テストクラスが作成されます。

注: プロジェクトには、テストを作成するためのテストパッケージ用ディレクトリが必要です。テストパッケージディレクトリのデフォルトの場所は、プロジェクトのルートレベルですが、プロジェクトの「プロパティー」ダイアログでディレクトリ用の別の場所を指定することもできます。

エディタで VectorsJUnit3Test.java を表示すると、テストメソッドの testEqual と testScalarMultiplication が生成されていることがわかります。VectorsJUnit4Test.java では、各テストメソッドに @Test という注釈が付きます。Vectors.java 内のメソッド名に基づいてテストメソッドの名前が生成されますが、テストメソッドの名前の先頭に test を付加する必要はありません。生成された各テストメソッドのデフォルトの本体はガイドとしてのみ用意され、実際のテストケースになるように変更する必要があります。

メソッドの本体を生成しないようにするには、「テストを作成」ダイアログの「デフォルトのメソッド本体」を選択解除します。

また、次のテストクラスの初期化メソッドと終了メソッドが生成されました。

@BeforeClass
public static void setUpClass() throws Exception {
}

@AfterClass
public static void tearDownClass() throws Exception {
}

JUnit 4 のテストクラスを作成するときに、クラスの初期化メソッドと終了メソッドがデフォルトで生成されます。注釈 @BeforeClass および @AfterClass は、テストクラスの実行前後に実行するべきメソッドをマークするために使用されます。メソッドを使用して Vectors.java をテストする必要はないため、これらのメソッドは削除してかまいません。

「オプション」ウィンドウで JUnit オプションを構成することにより、デフォルトで生成されるメソッドを構成できます。

注: JUnit 4 テストでは、org.junit.Assert.* のための静的なインポート宣言が IDE によってデフォルトで追加されることに注意してください。

Vectors.java 用のテストメソッドの記述

この課題では、JUnit assert メソッドを使用してメソッドをテストし、テストメソッドの名前を変更するため、生成された各テストメソッドを変更します。JUnit 4 では、テストメソッドが @Test という注釈で示され、テストメソッド名の先頭に test を付けなくてもよいため、テストメソッドの名前の付け方により柔軟性があります。

1. エディタで VectorsJUnit4Test.java を開きます。
2. メソッド名を変更し、println の値を変更して生成された変数を削除することによって、testScalarMultiplication のテストメソッドを変更します。テストメソッドは次のようになるはずです (ボールド部分が変更箇所)。

   @Test
   public void ScalarMultiplicationCheck() {
       System.out.println("* VectorsJUnit4Test: ScalarMultiplicationCheck()");
       assertEquals(expResult, result);
   }

   注: テストを記述する場合、表示される出力を変更することは必須ではありません。これはこの課題で行うため、テスト結果を出力ウィンドウで確認しやすくなります。

3. ここで、メソッドをテストするためのアサーションを追加します。

   @Test
   public void ScalarMultiplicationCheck() {
       System.out.println("* VectorsJUnit4Test: ScalarMultiplicationCheck()");
       assertEquals(  0, Vectors.scalarMultiplication(new int[] { 0, 0}, new int[] { 0, 0}));
       assertEquals( 39, Vectors.scalarMultiplication(new int[] { 3, 4}, new int[] { 5, 6}));
       assertEquals(-39, Vectors.scalarMultiplication(new int[] {-3, 4}, new int[] { 5,-6}));
       assertEquals(  0, Vectors.scalarMultiplication(new int[] { 5, 9}, new int[] {-9, 5}));
       assertEquals(100, Vectors.scalarMultiplication(new int[] { 6, 8}, new int[] { 6, 8}));
   }

   このテストメソッドでは、JUnit assertEquals メソッドを使用します。アサーションを使用するには、入力変数と、期待する結果を指定します。テストに合格するには、テスト済みメソッドを実行したときに、テストメソッドが供給した変数に基づいて、期待されるすべての結果を正常に返す必要があります。さまざまな考えられる並べ替えを実行するため、十分な数のアサーションを追加するようにしてください。

4. testEqual テストメソッドの名前を equalsCheck に変更します。
5. equalsCheck テストメソッドの生成されたメソッドの本文を削除します。
6. 次の println を equalsCheck テストメソッドに追加します。

   System.out.println("* VectorsJUnit4Test: equalsCheck()");

   テストメソッドは次のようになるはずです。

   @Test
   public void equalsCheck() {
       System.out.println("* VectorsJUnit4Test: equalsCheck()");
   }

7. 次のアサーション (ボールドで表示) を追加することによって、equalsCheck メソッドを変更します。

   @Test
   public void equalsCheck() {
       System.out.println("* VectorsJUnit4Test: equalsCheck()");
       assertTrue(Vectors.equal(new int[] {}, new int[] {}));
       assertTrue(Vectors.equal(new int[] {0}, new int[] {0}));
       assertTrue(Vectors.equal(new int[] {0, 0}, new int[] {0, 0}));
       assertTrue(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0, 0}));
       assertTrue(Vectors.equal(new int[] {5, 6, 7}, new int[] {5, 6, 7}));
   
       assertFalse(Vectors.equal(new int[] {}, new int[] {0}));
       assertFalse(Vectors.equal(new int[] {0}, new int[] {0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0}, new int[] {0, 0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0}, new int[] {0}));
       assertFalse(Vectors.equal(new int[] {0}, new int[] {}));
   
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 0, 1}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {0, 1, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 0}, new int[] {1, 0, 0}));
       assertFalse(Vectors.equal(new int[] {0, 0, 1}, new int[] {0, 0, 3}));
   }

   このテストは JUnit の assertTrue メソッドと assertFalse メソッドを使用して、考えられるさまざまな結果をテストします。このメソッドのテストに合格するには、assertTrue がすべて true 、assertFalse がすべて false である必要があります。

比較: Vectors.java 用のテストメソッドの記述 (JUnit 3)

Utils.java 用のテストクラスの作成

ここで、Utils.java の JUnit テストメソッドを作成します。前の課題でテストクラスを作成したとき、JUnit のバージョンを確認するメッセージが表示されましたが、すでに JUnit バージョンを選択したため、以降に作成されたすべての JUnit テストはそのバージョンなので、ここではバージョンの選択を求められません。

注: バージョンとして JUnit 4 を選択しても、引き続き JUnit 3 テストを記述して実行することはできますが、IDE はテストスケルトンの生成に JUnit 4 テンプレートを使用します。

1. Utils.java を右クリックし、「ツール」>「JUnit テストを作成」を選択します。
2. ダイアログで「テスト初期化」および「テスト終了」が選択されていない場合は選択します。
3. 「テストを作成」ダイアログで、テストクラスの名前を UtilsJUnit4Test に変更します。「了解」をクリックします。

「了解」をクリックすると、IDE によって、「テストパッケージ」の sample ディレクトリ内にテストファイル UtilsJUnit4Test.java が作成されます。Utils.java 内にあるメソッド用に、testComputeFactorial、testConcatWords、testNormalizeWord の各テストメソッドが生成されたことがわかります。テストおよびテストクラスに対して初期化メソッドと終了メソッドも生成されます。

Utils.java 用のテストメソッドの記述

この課題では、JUnit で共通のテスト要素の一部を示すテストケースを追加します。一部のメソッドは、メソッドが実行されたことやメソッドがテストに合格したことを示す出力を「JUnit テスト結果」ウィンドウにプリントしないため、メソッドに println も追加します。println をメソッドに追加することで、メソッドが実行されたかどうか、およびどの順番でメソッドが実行されたかを確認できます。

@BeforeClass
public static void setUpClass() throws Exception {
    System.out.println("* UtilsJUnit4Test: @BeforeClass method");
}

@AfterClass
public static void tearDownClass() throws Exception {
    System.out.println("* UtilsJUnit4Test: @AfterClass method");
}

@Before
public void setUp() {
    System.out.println("* UtilsJUnit4Test: @Before method");
}

@After
public void tearDown() {
    System.out.println("* UtilsJUnit4Test: @After method");
}

これでテストが記述されたので、テストを実行し、テスト出力を「JUnit テスト結果」ウィンドウで確認できます。

テストの実行

アプリケーション全体または個々のファイルで JUnit テストを実行し、結果を IDE で確認できます。プロジェクトのすべての単体テストをもっとも簡単な方法で実行するには、メインメニューから「実行」>「<プロジェクト名> のテスト」を選択します。この方法を選択すると、「テストパッケージ」内のすべてのテストが実行されます。個々のテストクラスを実行するには、「テストパッケージ」ノードのテストクラスを右クリックし、「ファイルを実行」を選択します。

1. 「プロジェクト」ウィンドウで UtilsJUnit4Test.java を右クリックします。
2. 「ファイルをテスト」を選択します。

UtilsJUnit4Test.java を実行するときは、テストクラス内のテストのみが実行されます。クラスがすべてのテストに合格すると、次の画像に似た内容が「JUnit テスト結果」ウィンドウに表示されます。

この画像 (クリックして大きい画像を表示) では、Utils.java で JUnit テストが実行されたこと、およびクラスがすべてのテストに合格したことがわかります。左区画には個々のテストメソッドの結果が表示され、右区画にはテスト出力が表示されます。出力を確認すると、テストが実行された順序がわかります。各テストメソッドに追加した println により、テストの名前が「テスト結果」ウィンドウおよび「出力」ウィンドウに出力されます。

UtilsJUnit4Test で、@BeforeClass という注釈が付いたテストクラス初期化メソッドが、ほかのメソッドより先に一回だけ実行されたことがわかります。@AfterClass という注釈が付いたテストクラス終了メソッドが、クラス内のほかのすべてのメソッドが実行されたあとで最後に実行されました。@Before という注釈が付いたテスト初期化メソッドが各テストメソッドより先に実行されました。

「テスト結果」ウィンドウの左側にあるコントロールを使用すると、テストを簡単に再実行できます。フィルタを使用すると、すべてのテスト結果と失敗したテストのみの表示を切り替えできます。矢印を使用して、次の失敗または前の失敗にスキップできます。

「テスト結果」ウィンドウでテスト結果を右クリックすると、ポップアップメニューを使用してテストのソースに移動したり、テストを再度実行したり、テストをデバックしたりできます。

JUnit 3 テストスイートの作成

テストのバージョンとして JUnit 3 を選択した場合、IDE ではテストパッケージのテストクラスに基づいて JUnit 3 テストスイートが生成されます。JUnit 3 では、TestSuite のインスタンスを作成し、各テストに対して addTest メソッドを使用することによって、テストスイートに含めるテストクラスを指定します。

1. 「プロジェクト」ウィンドウで「JUnit-Sample」プロジェクトノードを右クリックし、「新規」>「その他」を選択して「新規ファイル」ウィザードを開きます。
2. 「JUnit」カテゴリと「テストスイート」を選択します。「次へ」をクリックします。
3. 「クラス名」に「JUnit3TestSuite」と入力します。
4. テストスイートを作成するため、テストパッケージフォルダのサンプルフォルダにある sample パッケージを選択します。
5. 「テスト初期化」および「テスト終了」を選択解除します。「完了」をクリックします。
   

   「完了」をクリックすると、sample パッケージにテストスイートクラスが作成され、クラスがエディタに表示されます。このテストスイートには次のコードが含まれます。

   public class JUnit3TestSuite extends TestCase {
       public JUnit3TestSuite(String testName) {
           super(testName);
       }
   
       public static Test suite() {
           TestSuite suite = new TestSuite("JUnit3TestSuite");
           return suite;
       }
   }

6. suite() メソッドを変更して、このスイートの一部として実行されるテストクラスを追加します。

   public JUnit3TestSuite(String testName) {
       super(testName);
   }
   
   public static Test suite() {
       TestSuite suite = new TestSuite("JUnit3TestSuite");
       suite.addTest(new TestSuite(sample.VectorsJUnit3Test.class));
       suite.addTest(new TestSuite(sample.UtilsJUnit3Test.class));
       return suite;
   }

7. 変更を保存します。

JUnit 4 テストスイートの作成

テストのバージョンとして JUnit 4 を選択した場合、IDE では JUnit 4 テストスイートを生成できます。JUnit 4 は下位互換性があるので、JUnit 4 と JUnit 3 のどちらのテストを含む JUnit 4 テストスイートも実行できます。JUnit 4 のテストスイートでは、テストスイートに含めるテストクラスを @Suite 注釈の値として指定します。

注: JUnit 3 テストスイートを JUnit 4 テストスイートの一部として実行するには、JUnit 4.4 以降が必要です。

1. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「新規」>「その他」を選択して「新規ファイル」ウィザードを開きます。
2. 「JUnit」カテゴリと「テストスイート」を選択します。「次へ」をクリックします。
3. ファイル名に「JUnit4TestSuite」と入力します。
4. テストスイートを作成するため、テストパッケージフォルダのサンプルフォルダにある sample パッケージを選択します。
5. 「テスト初期化」および「テスト終了」を選択解除します。「完了」をクリックします。

「完了」をクリックすると、sample パッケージにテストスイートクラスが作成され、クラスがエディタに表示されます。このテストスイートには次のようなコードが含まれます。

@RunWith(Suite.class)
@Suite.SuiteClasses(value={UtilsJUnit4Test.class, VectorsJUnit4Test.class})
public class JUnit4TestSuite {
}

このテストスイートを実行すると、IDE によって各テストクラスが、リストされている順序で実行されます。

テストスイートの実行

テストスイートは、個々のテストクラスを実行する場合と同じ方法で実行します。

1. 「プロジェクト」ウィンドウで「テストパッケージ」ノードを展開します。
2. テストスイートクラスを右クリックし、「ファイルをテスト」を選択します。

テストスイートを実行すると、スイートに含まれるテストが一覧表示された順に実行されます。結果は「JUnit テスト結果」ウィンドウに表示されます。

この画像 (クリックして大きい画像を表示) では、JUnit 3 テストスイートのテスト結果がわかります。テストスイートにより UtilsJUnit3Test テストクラスと VectorsJUnit3Test テストクラスが単一のテストとして実行され、単一テストの結果として、テスト結果が左区画に表示されました。右区画の出力は、テストを個別に実行した場合と同じ内容です。

この画像 (クリックして大きい画像を表示) では、JUnit 4 テストスイートのテスト結果がわかります。テストスイートにより UtilsJUnit4Test テストクラスと VectorsJUnit4Test テストクラスが単一のテストとして実行され、単一のテストの結果としてテスト結果が左区画に表示されました。右区画の出力は、テストを個別に実行した場合と同じ内容です。

この画像 (クリックして大きい画像を表示) では、混合型のテストスイートのテスト結果がわかります。このテストスイートには JUnit 4 テストスイートと JUnit 3 のテストクラスのうち 1 つが含まれています。テストスイートにより UtilsJUnit3Test.java テストクラスと JUnit4TestSuite.java テストクラスが単一のテストとして実行され、単一のテストの結果としてテスト結果が左区画に表示されました。右区画の出力は、テストを個別に実行した場合と同じ内容です。