521-frameworks-micronaut-testing-unit-tests

Micronaut のユニットテスト

Micronaut の高速なテスト戦略を適用します。Mockito を優先し、HTTP または DI の置き換えが必要な場合に限り、範囲を絞って @MicronautTest を使用します。

このスキルで扱う内容

• コンテナーを起動しない、純粋な JUnit 5 + Mockito
• コラボレーター用の @MockBean ファクトリーメソッドを使った @MicronautTest
• 埋め込みサーバーに対する HttpClient の同期的なリクエストとレスポンスのやり取り
• テストで決定的な設定を行う @Property
• @CsvSource / @MethodSource を使った @ParameterizedTest
• 命名規則：設定されている場合、*Test は Surefire、*IT は Failsafe
• @522 に切り替えるタイミング

対象範囲： 参照ルールと適切なコード例・不適切なコード例に基づいて、推奨事項を適用します。

制約

テストをリファクタリングする前にコンパイルし、完了後にテストスイート全体を検証してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
• 安全性：コンパイルに失敗した場合は、直ちに停止します
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行します
• 適用前：詳細なルールと例について、参照ドキュメントを読んでください
• エッジケース：依頼の範囲が曖昧な場合は、変更を適用する前に停止し、確認の質問をしてください
• エッジケース：必要な入力、ファイル、またはツールが不足している場合は、不足しているものを報告し、セットアップの案内を進めてよいか確認してください

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

• Micronaut プロジェクトでユニットテストを追加または改善する
• Mockito を優先したテストにより、不要な @MicronautTest の使用を減らす
• Micronaut サービス向けの Mockito 優先のユニットテストを作成する
• ユニットテストで Micronaut Bean のコラボレーターをモックする
• アプリケーションコンテキストを使用しない高速な Micronaut テストをレビューする

ワークフロー

1. 参照ドキュメントを読み、プロジェクトのコンテキストを評価する

変更を提案する前に、references/521-frameworks-micronaut-testing-unit-tests.md を読み、現在のプロジェクト設定を確認してください。

2. 範囲を確認し、改善対象を決定する

依頼された成果、制約、適用する変更のうち安全に実施できる最小限の範囲を特定します。

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

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

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

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

参照ドキュメント

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