Java JUnitの使い方

JUnit とはJavaで開発されたプログラムにおいてユニットテスト(単体テスト)の自動化を行うためのフレームワークである。

JUnitのインストール

1. WebブラウザでJUnitのWebサイトを開く。
   http://junit.org/
2. 「Download and Install guide」リンクをクリックする。
3. 「junit.jar」をクリックする。
4. 必要なバージョンのjarをクリックする。
5. ファイルのダウンロードが始まる。
6. 同様に「hamcrest-core.jar」もダウンロードする。

テストプログラムの作成

テストプログラムの作成は以下のように行う。

• org.junit.Assertクラスをインポートする。
  

  import org.junit.Assert;

• 使用するアノテーションをインポートする。
  

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

• テストメソッドには@Testアノテーションを付ける。
• テストメソッドはpublic voidにし、引数なしにする。
  

  @Test
  public void testCase1() { ... }

JUnitを用いたテストプログラムの例を示す。

import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.JUnitCore;

public class SampleTest {

  @Test
  public void testCase1() {
      String expected = "success";
      String actual   = "success";
      // 期待値と結果が等しい場合はテスト成功
      Assert.assertEquals(expedted, actual);
  }

  @Test
  public void testCase2() {
      String expected = "success";
      String actual   = "failure";
      // 期待値と結果が異なる場合はテスト失敗(例外がスローされる)
      Assert.assertEquals(expedted, actual);
  }
}

テストプログラムの実行

テストプログラムの実行方法は、テストクラスを引数に指定して org.junit.runner.JUnitCore を実行する。

java org.junit.runner.JUnitCore testClass1 [testClass2...]

もしくは、テストクラスにmainメソッドを作成し、 org.junit.runner.JUnitCore.main メソッドを呼び出す。

public static void main(String[] args) {
  JUnitCore.main(SampleTest.class.getName());
}

アノテーション

JUnitは次のアノテーションをサポートしている。

public class MyTest
{
  @org.junit.Test
  public void testCase1
  {
      // 処理
  }
}

import文を使えば、アノテーションを短縮形で記述することができる。

import org.junit.Test;

public class MyTest
{
  @Test
  public void testCase1
  {
      // 処理
  }
}

テストスイート

import org.junit.runner.RunWith;
import org.junit.runners.Suite;
import org.junit.runners.Suite.SuiteClass;

@RunWith(Suite.Class)
@SuiteClass({ クラス名.class [, クラス名.class...] })

org.junit.Assertクラス

テスト結果判定用メソッドは、テストに失敗するとjava.lang.AssertionErrorをスローする。

assertEquals

期待値（expected）と実行結果（actual）が等しい場合、テストが成功する。

static void assertEquals(double expected, double actual)

static void assertEquals(long expected, long actual)

static void assertEquals(java.lang.Object expected, java.lang.Object actual)

assertArrayEquals

期待値（expected）と実行結果（actual）が等しい場合、テストが成功する。

static void assertArrayEquals(byte[] expected, byte[] actual)

static void assertArrayEquals(char[] expected, char[] actual)

static void assertArrayEquals(int[] expected, int[] actual)

static void assertArrayEquals(long[] expected, long[] actual)

static void assertArrayEquals(java.lang.Object[] expected, java.lang.Object[] actual)

static void assertArrayEquals(short[] expected, short[] actual)

assertThat

実行結果（actual）が指定した条件（matcher）を満たせば、テストが成功する。

static void assertThat(T actual, org.hamcrest.Matcher<T> matcher)

assertNotNull

オブジェクトがnull以外の場合、テストが成功する。

static void assertNotNull(Object obj)

assertNull

オブジェクトがnullの場合、テストが成功する。

static void assertNull(Object obj)

assertSame

オブジェクトが同一の場合、テストが成功する。

static void assertSame(Object expected, Object actual)

assertNotSame

オブジェクトが不一致の場合、テストが成功する。

static void assertNotSame(Object expected, Object actual)

org.hamcrest.Matchersクラス

参考文献

JUnit (2016) Assert (JUnit API) JUnit 4.13.2 API