401-frameworks-quarkus-core

Quarkus コアガイドライン

CDI Bean、設定、プロファイル、ライフサイクルに関する Quarkus コアガイドラインを適用します。

このスキルで扱う内容

• @QuarkusMain とアプリケーションのエントリーポイント（カスタム main が必要な場合）
• CDI スコープ：@ApplicationScoped、@Singleton、@Dependent；Bean の曖昧さの解消（@Default、@Alternative、@Named）
• @Inject によるコンストラクターインジェクション
• 横断的関心事に対する CDI インターセプター（@Interceptor、@InterceptorBinding）
• CDI イベント：非同期ディスパッチ用の @Observes StartupEvent / ShutdownEvent、@ObservesAsync
• 動的な Bean 選択のための Instance によるプログラムによるインジェクション
• Bean Validation（@Valid）を使用した @ConfigMapping と構造化設定
• プロファイル固有のプロパティ（%dev、%test、%prod）と @IfBuildProfile
• 起動およびシャットダウン時のオブザーバー（@Startup、@PreDestroy）
• @RunOnVirtualThread による仮想スレッド（Java 21+）
• ネイティブイメージの安全性：@RegisterForReflection、@DisabledOnNativeImage

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

制約

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

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
• 前提条件：Quarkus コアの改善を適用する前に、プロジェクトが正常にコンパイルできる必要があります
• 安全性：コンパイルに失敗した場合は、直ちに作業を中止してください。コンパイル失敗は作業を妨げる条件です
• 作業を妨げる条件：コンパイルエラーは、作業を進める前にユーザーが解決する必要があります
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行します
• 適用前：詳細なルール、適切な／不適切なパターン、制約についてリファレンスを読みます

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

• Quarkus アプリケーションの構成と CDI について Java コードをレビューする
• Quarkus の設定と Bean に関するベストプラクティスを適用する
• Quarkus の CDI インターセプター、イベント、プログラムによるインジェクションを改善する
• 仮想スレッドの設定を追加する、または CDI のライフサイクルを調整する
• Quarkus の CDI Bean のライフサイクルと設定をレビューする

ワークフロー

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

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

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

求められる成果、制約、適用する変更のうち安全上必要な最小限の範囲を特定します。

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

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

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

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

リファレンス

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