522-frameworks-micronaut-testing-integration-tests

Micronaut 統合テスト

コンテナーと HTTP を使用して、Micronaut の実際の配線を検証します。

このスキルで扱う内容

• 対象範囲：重複するユニットテストのロジックではなく、コントラクトと境界
• JDBC／Kafka のプロパティに対する TestPropertyProvider + static @Container
• HttpClient によるフルスタックの HTTP アサーション
• サポートされている場合のロールバックに @MicronautTest(transactional = true) を使用
• クラスごとにコンテナーを共有し、イメージタグを固定
• Maven Surefire／Failsafe：*Test / *Tests と *IT / *AT、明示的なプラグインの includes と excludes

対象範囲： リファレンスのルールと良い／悪いコード例に基づいて推奨事項を適用します。

制約事項

統合テストに変更を適用する前に、プロジェクトがコンパイルできることを確認してください。コンパイルに失敗した場合は、直ちに中止してください。改善を適用した後は、全体の検証を実行してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行してください
• 前提条件：テストをリファクタリングする前に、プロジェクトが正常にコンパイルされ、基本的な検証チェックに合格している必要があります
• 重要な安全上の注意：コンパイルに失敗した場合は、直ちに中止し、推奨事項の適用を続けないでください
• ブロッキング条件：統合テストの変更に進む前に、ユーザーがコンパイルエラーを解決する必要があります
• 例外なし：コンパイルに失敗するプロジェクトには、いかなる状況でもテストに関する推奨事項を適用しないでください
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行してください
• 適用前：詳細なルールと例について、リファレンスを読んでください

このスキルを使用する場面

• Testcontainers を使った Micronaut 統合テストを追加する
• @MicronautTest 用にデータソースまたはブローカーの URL を動的に設定する
• Testcontainers を使って @MicronautTest 統合テストを作成する
• Micronaut 統合テスト用の置換 Bean を設定する
• Micronaut 統合テストのライフサイクルとリソースをレビューする

ワークフロー

1. リファレンスを読み、プロジェクトの状況を評価する

変更を提案する前に、references/522-frameworks-micronaut-testing-integration-tests.md を読み、現在のプロジェクト設定を確認します。

2. 対象範囲を把握し、改善対象を決める

求められている結果と制約を特定し、安全に適用できる最小限の変更を決定します。

3. フレームワークに沿った変更を適用する

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

4. 検証を実行し、結果を報告する

適切なビルドやテストを実行し、変更内容、検証した内容、今後必要な対応をまとめます。

リファレンス

詳しいガイダンス、例、制約事項については、references/522-frameworks-micronaut-testing-integration-tests.md を参照してください。