JUnit 5+ ベストプラクティス

JUnit 5 で効果的なユニットテストを書くことをサポートします。標準的なテスト方法とデータ駆動テスト方法の両方に対応します。

プロジェクトセットアップ

• 標準的な Maven または Gradle プロジェクト構造を使用します。
• テストソースコードは src/test/java に配置します。
• junit-jupiter-api、junit-jupiter-engine、およびパラメータ化テスト用の junit-jupiter-params の依存関係を含めます。
• ビルドツールコマンドでテストを実行します: mvn test または gradle test。

テスト構造

• テストクラスには Test サフィックスを付けます。例えば Calculator クラスに対して CalculatorTest。
• テストメソッドには @Test を使用します。
• Arrange-Act-Assert（AAA）パターンに従います。
• テストに説明的な命名規則を使用します。例えば methodName_should_expectedBehavior_when_scenario。
• テストごとのセットアップとクリーンアップには @BeforeEach と @AfterEach を使用します。
• クラスごとのセットアップとクリーンアップには @BeforeAll と @AfterAll を使用します（静的メソッドである必要があります）。
• テストクラスとメソッドに人間が読める名前を付けるには @DisplayName を使用します。

標準テスト

• テストを単一の動作に焦点を当てます。
• 1 つのテストメソッド内で複数の条件をテストするのは避けます。
• テストは独立しており、べき等性があります（任意の順序で実行可能）。
• テスト間の相互依存性を避けます。

データ駆動（パラメータ化）テスト

• パラメータ化テストをマークするには @ParameterizedTest を使用します。
• シンプルなリテラル値（文字列、整数など）には @ValueSource を使用します。
• Stream、Collection などとしてテスト引数を提供するファクトリメソッドを参照するには @MethodSource を使用します。
• インラインのカンマ区切り値には @CsvSource を使用します。
• クラスパスから CSV ファイルを使用するには @CsvFileSource を使用します。
• 列挙型定数を使用するには @EnumSource を使用します。

アサーション

• org.junit.jupiter.api.Assertions の静的メソッドを使用します（例：assertEquals、assertTrue、assertNotNull）。
• より流暢で読みやすいアサーションには AssertJ などのライブラリの使用を検討します（assertThat(...).is...）。
• 例外をテストするには assertThrows または assertDoesNotThrow を使用します。
• 関連するアサーションを assertAll でグループ化して、すべてのアサーションがテスト失敗前にチェックされるようにします。
• アサーション内で説明的なメッセージを使用して、失敗時に明確性を提供します。

モッキングと分離

• Mockito のようなモッキングフレームワークを使用して、依存関係のモックオブジェクトを作成します。
• Mockito の @Mock および @InjectMocks アノテーションを使用して、モック作成とインジェクションを簡素化します。
• インターフェースを使用してモッキングを容易にします。

テスト組織

• パッケージを使用してテストを機能またはコンポーネント別にグループ化します。
• @Tag を使用してテストを分類します（例：@Tag("fast")、@Tag("integration")）。
• 厳密に必要な場合、@TestMethodOrder(MethodOrderer.OrderAnnotation.class) と @Order を使用してテスト実行順序を制御します。
• テストメソッドまたはクラスを一時的にスキップするには @Disabled を使用し、理由を提供します。
• より良い組織と構造のために、ネストされた内部クラスでテストをグループ化するには @Nested を使用します。