JUnit 予期される例外テスト: @Test(expected)

JUnit 機能を提供する trac例外を発生させ、コードが期待される例外をスローしているかどうかを確認する。

JUnit 4は、例外テストを簡単かつ読みやすく行う方法を提供します。以下を使用できます。

• オプションパラメータ（期待値） @Test アノテーション,
• に trac情報があれば、「fail()」を使用できます。

一方、 テスト 例外が発生した場合、そのオプション パラメーターで指定する例外クラスが @Test アノテーション これは、メソッドが実際にスローする例外と同じです。これは、メソッドから例外が発生することを期待しているためです。 単体テストそうでなければ、 JUnit テストは失敗するでしょう。

例: @Test(expected = IllegalArgumentException.class)

「expected」パラメータを使用すると、テストで発生する可能性のある例外名を指定できます。上記の例では、「不正な引数例外これは、開発者が許可されていない引数を使用した場合にテストによってスローされます。

@Test(expected) を使用した例

例外テストを理解するために、 Java 例外をスローするメソッドを持つクラス 例外テストクラスでそれを処理してテストします。 JUnitMessage.java には、数学演算を実行するメソッドがあります。14 行目の除算はゼロ除算になるため、このメソッドは常に「ArithmeticException」をスローします。以下を参照してください。

package guru99.junit;

public class JUnitMessage{

	private String message;

	public JUnitMessage(String message) {
		this.message = message;
	}

public void printMessage(){

	System.out.println(message); 
	int divide=1/0;

}

public String printHiMessage(){ 

	message="Hi!" + message;
	
	System.out.println(message);

	return message;
}

}

Code 説明：

• Code ライン7： フィールド初期化を使用してパラメーター化されたコンストラクターを作成します。
• Code 11〜14行目： 数学演算を行うための方法を作成する。
• Code ライン18： メッセージを出力する別のメソッドを作成します。
• Code ライン20： メッセージを出力するための新しい文字列を作成します。
• Code ライン22： 20行目で作成された新しいメッセージを印刷します。

上記のテストクラスを作成しましょう Java 例外を検証するためのクラス。

以下に、上記の例外（ここでは ArithmeticException）を単体テストするテストクラスを示します。 Java クラス：

AirthematicTest.java

以下のスクリーンショットは、エディタで同じテストを実行した様子を示しています。ファイルはAirthematicTest1として保存され、13行目で期待されるパラメータがハイライト表示されています。

package guru99.junit;

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class AirthematicTest {

	public String message = "Saurabh";
	
	JUnitMessage junitMessage = new JUnitMessage(message);
	
	@Test(expected = ArithmeticException.class)
	public void testJUnitMessage(){

		System.out.println("Junit Message is printing ");
		junitMessage.printMessage();

	}

	@Test
	public void testJUnitHiMessage(){ 
		message="Hi!" + message;
		System.out.println("Junit Message is printing ");
		assertEquals(message, junitMessage.printHiMessage());
	
	}
}

Code 説明：

• Code ライン13： @Test アノテーションを使用してテストを作成します。上記のクラスのメソッドを実行すると、数学演算が呼び出されます。ここでは ArithmeticException が想定されるため、@Test のパラメータとして指定します。
• Code ライン17： printMessage() を呼び出しています JUnitメッセージ.java。
• Code 21〜22行目： 「Hi」メッセージをチェックする別のテストメソッドを作成します。今回は、想定されるパラメータは含めません。

このクラスには2つのテストメソッドが含まれているため、1回の実行で両方が実行されます。1つはArithmeticExceptionを期待するメソッド、もう1つは返された文字列に対してアサートを行うメソッドです。

注意： この例は、元の資料では3つの名前で表記されています。リストではクラス名がAirthematicTest、エディタのスクリーンショットではAirthematicTest1、結果ビューではJunitTestExampleと表示されます。コードはすべて同じで、ファイル名だけが異なります。

実行して結果を確認しましょう。 JUnit 以下は、 JunitTestExample.java.

出力：

以下が出力結果です。テストは失敗なく成功しました。 traceは以下に示すとおりです。

どちらの方法も合格です。最初の方法は宣言した ArithmeticException が発生したため合格し、2 番目の方法は返された文字列が一致したため合格します。除算がスローされなかった場合は、 JUnit 最初のメソッドは「予期された例外: java.lang.ArithmeticException」というメッセージで失敗していたでしょう。

例外をテストする 3 つの方法 JUnit 4

期待されるパラメータは3つのうち最短である JUnit 4つの慣用句がありますが、必ずしも正しいとは限りません。この表では、選択を決定する2つの質問、つまりメッセージについて断言できるか、どの行が使われたかを知っているか、という点に基づいてそれらを比較しています。

導入部分で説明されている fail() のイディオムは次のようになります。呼び出しが例外をスローしない場合、fail() が実行され、テストはあなたが書いたメッセージを報告します。

@Test
public void testDivideByZero() {
    try {
        junitMessage.printMessage();
        fail("Expected an ArithmeticException");
    } catch (ArithmeticException e) {
        assertEquals("/ by zero", e.getMessage());
    }
}

ExpectedException ルールは、この 2 つの間に位置します。これは、 JUnit 4.13 次に説明する assertThrows メソッドを支持するため、新しい JUnit 4つのテストでは、それを採用すべきではない。

例外をテストする方法 JUnit assertThrows() を使用した 5

JUnit 5 は @Test から期待されるパラメータを完全に削除します。Jupiter が提供します assertThrows()これは、例外クラスとテスト対象コードを保持するラムダ式を受け取ります。捕捉した例外を返すため、メッセージ、原因、および任意のカスタムフィールドを後でアサートできます。

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import org.junit.jupiter.api.Test;

public class AirthematicJupiterTest {

    JUnitMessage junitMessage = new JUnitMessage("Saurabh");

    @Test
    public void testJUnitMessage() {
        ArithmeticException thrown = assertThrows(
                ArithmeticException.class,
                () -> junitMessage.printMessage());
        assertEquals("/ by zero", thrown.getMessage());
    }
}

3つの関連 アサーション 家族を充実させる：

• assertThrows 例外型、またはそのサブクラスを受け入れます。
• assertThrowsExactly サブクラスを拒否するため、指定された型のみが通過します。
• assertDosNotThrow これは、ブロックが正常に完了するという、正反対の期待を示しています。

その JUnit このページにある 4 つのコードはまだ実行されています JUnit プラットフォームはビンテージエンジンを使用しているため、プロジェクトの移行中に動作を継続させるために、上記のコードを書き直す必要はありません。

例外をテストする際のよくある間違い JUnit

例外テストは、いくつかの明確な方法で失敗します。各行には、症状、原因、および解決策が記載されています。

最後の行は、移行の途中で多くの人がつまずく箇所です。なぜなら、どちらの注釈も@Testという名前で、インポート部分でしか区別できないからです。ping XNUMXつ JUnit バージョン テストケース このクラスは、問題の種類全体を回避する。

よくあるご質問