503-frameworks-micronaut-validation

Micronaut のバリデーションガイドライン

HTTP API の境界で、Micronaut のバリデーションのベストプラクティスを適用します。

このスキルの対象範囲

• DTO とコマンドモデルに対する Bean Validation アノテーション
• Micronaut コントローラーでの @Valid / @Validated の使用
• バリデーショングループとカスタムバリデーター
• バリデーション失敗を一貫して 400 レスポンスにマッピングする方法
• 安全で予測可能なバリデーションエラーペイロード

範囲： 参照ルールと良い例・悪い例に基づいて推奨事項を適用します。

制約事項

バリデーションの変更を適用する前に、プロジェクトがコンパイルできることを確認してください。改善後は、全検証を実行してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
• 安全性：コンパイルに失敗した場合は、直ちに中止します
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行します
• 適用前：詳細なルールと例について、参照ドキュメントを読みます

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

• Micronaut にバリデーションサポートを追加する
• Micronaut のバリデーションルールをレビューする
• Micronaut REST API のリクエストバリデーションを改善する
• Micronaut にカスタムバリデーション制約を追加する
• Micronaut の設定プロパティをバリデートする
• Micronaut の制約違反処理を改善する

ワークフロー

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

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

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

要望、制約、および適用する変更のうち、安全性を保てる最小限の範囲を特定します。

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

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

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

適切なビルドやテストを実行し、変更内容、検証内容、および必要なフォローアップ作業を要約します。

参照

詳細なガイダンス、例、および制約事項については、references/503-frameworks-micronaut-validation.md を参照してください。