EclipseでJUnitを動かす方法

JUnitとは

• Javaプログラムにおいてユニットテストができるツール（フレームワーク）を行う
• テスト自動化ができる
  • 手作業が減るため、テスト工数削減やヒューマンエラー防止に効果あり。

前提条件

• Eclipseがインストールされていること
• 以下のような構成のプロジェクト、パッケージ、プログラムファイルを作成していること

ProjectA  ----  src
                 |
                 ------ xx.yy.zzz(パッケージ)
                            |
                            ------- Door.java (テスト対象クラス)

設定

パッケージxx.yy.zzz配下に、Door.java (テスト対象クラス)をテストするためのクラス「DoorTest.java」を作成します。

• Eclipseでプロジェクトを右クリック [新規] - [その他]をクリック

• 「Java」 - 「JUnit」 - 「Junitテストケース」を選択して 次へ をクリック

• 下図を参考に、必要な値を設定する

• 「DoorTest.java」の雛形ができました。

DoorTest.java

package xx.yy.zzz;  // テスト対象クラスと同じパッケージにする

import static org.junit.Assert.*;

import org.junit.Test;

public class DoorTest {

	@Test
	public void test() {
		fail("まだ実装されていません");
	}

}

• 試しに実行してみましょう。 DoorTest.javaを右クリックして、 [実行] - [実行の構成]

• 下図を参考に、必要な値を設定する。テスト・ランナーは「JUnit 4」にするのを忘れずに！
  

• 実行結果です。failメソッドが呼び出されるので、結果は必ず「失敗」になります。

テストプログラムを書く

テスト対象クラス

Door.java

package xx.yy.zzz;  // テストクラスと同じパッケージにする

public class Door {
	private boolean isOpen = false;

	public void open(String str) {
		if (str.equals("開けゴマ！")) {
			isOpen = true;
		} else {
                        isOpen = false;
			System.out.println("違います。");
		}
	}

	public void close() {
		isOpen = false;
	}

	// getter
	public boolean isOpen() {
		return isOpen;
	}

}

テスト内容

• test1. openメソッドで"開けゴマ！"以外を指定すると、ドアが開らない（isOpenメソッドの戻り値がfalse）こと。また、「違います。」と標準出力されていること。
• test2. openメソッドで"開けゴマ！"を指定すると、ドアが開く（isOpenメソッドの戻り値がtrue）こと。
• test3. closeメソッドでドアが閉じる（isOpenメソッドの戻り値がfalse）こと。

テストクラス

Door.java

package xx.yy.zzz;  // テスト対象クラスと同じパッケージにする

import static org.junit.Assert.*;

import java.io.BufferedOutputStream;
import java.io.ByteArrayOutputStream;
import java.io.PrintStream;

import org.junit.After;
import org.junit.Before;
import org.junit.Test;

public class DoorTest {

	Door door;
    private ByteArrayOutputStream baos;

	// 前処理
	@Before
	public void setUp() {
		door = new Door();

        baos = new ByteArrayOutputStream();
        System.setOut(
            new PrintStream(
                new BufferedOutputStream(baos)
            )
        );
	}


	// 「@Test」は、JUnitがテストメソッドと認識するためのアノテーション
	// public voidで作成すること
	@Test
	public void test1() {
		door.open("ドア、開いてください");

		// 標準出力
		System.out.flush();
		String expected = "違います。\r\n";
        String actual = baos.toString();

        // 期待値との確認
		assertEquals(false, door.isOpen());
        assertEquals(expected, actual);
	}

	@Test
	public void test2() {
		door.open("開けゴマ！");
		assertEquals(true, door.isOpen());
	}

	@Test
	public void test3() {
		door.close();
		assertEquals(false, door.isOpen());
	}

	// 後処理
	@After
	public void fin() {
		// DO Nothing
	}

}

[補足]

• System.setOutメソッド：「標準」出力ストリームを割り当てし直します。引数はPrintStreamクラスです。
• PrintStreamクラス：新しい出力ストリームを作成するために使います。
• BufferedOutputStreamクラス：バッファのデータを出力ストリーム化します。
• ByteArrayOutputStreamクラス：データがバイト配列に書き込まれる出力ストリームを実装します。