303-frameworks-spring-boot-validation

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

API の境界で Spring Boot のバリデーションに関するベストプラクティスを適用します。

このスキルで扱う内容

• DTO とコマンドモデルへの Bean Validation アノテーションの付与
• コントローラーとメソッドパラメーターへの @Valid / @Validated の付与
• 作成／更新ワークフロー向けのバリデーショングループ
• カスタム制約アノテーションとバリデーター
• バリデーション失敗時の一貫した 400 エラーレスポンス

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

制約事項

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

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

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

• Spring Boot でバリデーションのサポートを追加する
• Spring Boot のバリデーションルールをレビューする
• Spring Boot REST API のリクエストバリデーションを改善する
• Spring Boot でカスタム Bean Validation 制約を追加する
• Spring Boot で設定プロパティを検証する
• Spring Boot でネストされた DTO のバリデーションを改善する

ワークフロー

1. 参照資料を読み、プロジェクトの状況を確認する

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

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

要求される成果、制約事項、適用する変更のうち安全性を確保できる最小限の範囲を特定します。

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

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

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

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

参照資料

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