JUnit5.7, 5.8の新機能紹介 kyon_mm

No content

JUnitはJava言語で自動テストをするための フレームワークとしてデファクトスタンダー ドの位置にある • JUnit5のリリース以降は継続的にリリースされている • 2022/05 最新版は5.8.2 • 5.8と5.7の新機能を一部紹介 • JUnitのスポンサーはこちらから • https://steadyhq.com/en/junit/about

Jupiterを中⼼に紹介 引⽤ : https://junit.org/junit5/docs/current/user-guide

引⽤ : https://junit.org/junit5/docs/current/user-guide

JUnit 5.7の新機能 1. DisplayName という MethodOrderer で、表示名に基づいてテストメソッドを英数字でソートす る 2. MethodOrderer.MethodName が MethodOrderer.Alphanumeric の代わりになった。 3. @TestMethodOrder が存在しない場合のデフォルトの MethodOrderer を junit.jupiter.testmethod.order.default で設定する 4. @CsvFileSource は、リソースパスの代わりにファイルパスを指定できる 5. 他は https://junit.org/junit5/docs/5.7.0/release-notes/index.html#new-features-and- improvements-2 を参照

DisplayName という MethodOrderer で、表 示名に基づいてテストメソッドを英数字で ソートする @TestMethodOrder(MethodOrderer.DisplayName.class) public class DisplayNameTestA { @Test @DisplayName("test03") void testX1(){} @Test @DisplayName("test01") void testX2(){} @Test @DisplayName("test02") void testX3(){} }

MethodOrderer.MethodName が MethodOrderer.Alphanumeric の代わりに なった。 @TestMethodOrder(MethodOrderer.MethodName.class) public class MethodNameTestA { @Test void testB(){} @Test void testA(){} @Test void test0(){} @Nested @TestMethodOrder(MethodOrderer.Alphanumeric.class) public class AlphanumericTestA { @Test void testB(){} @Test void testA(){} @Test void test0(){} } }

@TestMethodOrder が存在しない場合のデフォルトの MethodOrderer を junit.jupiter.testmethod.order.default で設定する test { useJUnitPlatform() systemProperty("junit.jupiter.testmethod.order.default", 'org.junit.jupiter.api.MethodOrderer$Random’) }

@CsvFileSource は、リソースパスの代 わりにファイルパスを指定できる @ParameterizedTest @CsvFileSource(files = "src/test/java/org/example/csv/test-data.csv") void test(String name, String number, boolean isJVM){ System.out.println("%s : version %s, is JVMLang : %s".formatted(name, number, isJVM)); }

JUnit 5.8の新機能 1/2 1. テストクラスの実行順序をグローバルで指定する 2. ネストしたテストクラスの実行順序をローカルで指定する 3. assertThrowsExactly() メソッドが追加されました。これは assertThrows() をより厳密 にしたもの。 4. assertInstanceOf() メソッドは、assertTrue(obj instanceof X)の代わりとして機能しま す。 5. 実際のオブジェクトに対する toString() が null または "null" を返した場合、 assertNull() の失敗メッセージに実際のオブジェクトの型が含まれるようになりました。

テストクラスの実行順序をグローバルで 指定する test { useJUnitPlatform() systemProperty("junit.jupiter.testclass.order.default", 'org.junit.jupiter.api.ClassOrderer$ClassName') // systemProperty("junit.jupiter.testclass.order.default", 'org.junit.jupiter.api.ClassOrderer$DisplayName') // systemProperty("junit.jupiter.testclass.order.default", 'org.junit.jupiter.api.ClassOrderer$OrderAnnotation') // systemProperty("junit.jupiter.testclass.order.default", 'org.junit.jupiter.api.ClassOrderer$Random') testLogging { events "passed", "skipped", "failed" } }

ネストしたテストクラスの実行順序を ローカルで指定する @TestClassOrder(ClassOrderer.OrderAnnotation.class) public class NestedTestA { @Nested @Order(3) class WhenLoginAOrder3 { @Test public void test(){ Assertions.assertEquals("NestedTestA-WhenLoginA", "NestedTestA-WhenLoginA"); } } @Nested @Order(1) class WhenLoginBOrder1 { @Test public void test(){ Assertions.assertEquals("NestedTestA-WhenLoginB", "NestedTestA-WhenLoginB"); } } @Nested @Order(2) class WhenLoginCOrder2 { @Test public void test(){ Assertions.assertEquals("NestedTestA-WhenLoginC", "NestedTestA-WhenLoginC"); } } }

assertThrowsExactly() メソッドが追加され ました。これは assertThrows() をより厳密 にしたもの。 @Test public void test(){ Assertions.assertThrows(RuntimeException.class, () -> {throw new SomeException();}); Assertions.assertThrowsExactly(SomeException.class, () -> {throw new SomeException();}); } public class SomeException extends RuntimeException { }

assertInstanceOf() メソッドは、 assertTrue(obj instanceof X)の代わりとし て機能します。 @Test public void test(){ Assertions.assertTrue(BigDecimal.valueOf(10.5) instanceof Object); Assertions.assertInstanceOf(Object.class, BigDecimal.valueOf(10.5)); }

実際のオブジェクトに対する toString() の実装が null または "null" を返した場合、assertNull() の失敗メッセージに実際のオブジェクトの型 が含まれるようになりました。 @Test public void test(){ Assertions.assertEquals("some", "null"); Assertions.assertNull("null"); }

JUnit 5.8の新機能 2/2 6. @TempDir を使って複数のテンポラリ・ディレクトリを作成できるようになりました。フィールドや メソッドのパラメータで @TempDir アノテーションを宣言するたびに、個別のテンポラリ・ディレク トリを作成するようになりました 7. @TempDir フィールドをプライベートにすることができるようになりました。 8. @CsvSource または @CsvFileSource で使用される数値リテラルは、700_000_000 のようなアンダー スコアを使用して表現することができるようになりました。 9. @CsvSource と @CsvFileSource に ignoreLeadingAndTrailingWhitespace 属性 (デフォルトでは true に設定) が追加され、ホワイトスペースをトリミングするかどうかが制御できるようになりま した。 10. 他は https://junit.org/junit5/docs/5.8.0/release-notes/index.html#new-features-and- improvements-3 を参照

@TempDir を使って複数のテンポラリ・ディレクトリを作成できるようにな りました。フィールドやメソッドのパラメータで @TempDir アノテーショ ンを宣言するたびに、個別のテンポラリ・ディレクトリを作成するように なりました @Test public void test1(@TempDir Path dir1, @TempDir Path dir2) { Assertions.assertNotEquals(dir1.toAbsolutePath(), dir2.toAbsolutePath()); }

@TempDir フィールドをプライベートにすることができるようになりました。 @TempDir private static Path dir3; @Test public void test2(@TempDir Path dir4){ Assertions.assertNotEquals(dir3.toAbsolutePath(), dir4.toAbsolutePath()); }

@CsvSource または @CsvFileSource で使用される数値リテラルは、 700_000_000 のようなアンダースコアを使用して表現することができるよ うになりました。 @ParameterizedTest @CsvSource(value = { "apple,150000", "orange,200000", "'beef, chicken',0xF2F3F", "sushi,1_500_000" }) void underscore(String food, int rank) { Assertions.assertTrue(100000 < rank , "%s is lower than 100000".formatted(food)); }

@CsvSource と @CsvFileSource に ignoreLeadingAndTrailingWhitespace 属性 (デフォルトでは true に設定) が追加され、ホワイトスペースをト リミングするかどうかが制御できるようになりました。 @ParameterizedTest @CsvSource(value = { "apple, 150000", "orange, 200000", "'beef, chicken', 0xF2F3F", "sushi, 1_500_000" }, ignoreLeadingAndTrailingWhitespace = true) void ignoreWhiteSpace(String food, int rank) { Assertions.assertTrue(100000 < rank , "%s is lower than 100000".formatted(food)); }