403-frameworks-quarkus-validation

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

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

このスキルで扱う内容

• DTO とコマンドモデルでの Bean Validation アノテーション
• Jakarta REST リソースでの @Valid と境界バリデーション
• バリデーショングループとカスタム制約
• クライアントに安全なレスポンスのためのバリデーションエラーのマッピング
• エンドポイント間で一貫した無効な入力の処理

範囲： リファレンスのルールと適切な例・不適切な例に基づいて推奨事項を適用します。

制約事項

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

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

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

• Quarkus でバリデーションのサポートを追加する
• Quarkus のバリデーションルールをレビューする
• Quarkus REST API のリクエストバリデーションを改善する
• Quarkus でカスタムバリデーション制約を追加する
• Quarkus の @ConfigMapping プロパティを検証する
• Quarkus の ExceptionMapper でバリデーションエラーのマッピングを改善する

ワークフロー

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

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

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

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

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

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

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

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

リファレンス

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