401-frameworks-quarkus-core

Quarkus 核心指南

应用 Quarkus 核心指南，涵盖 CDI Bean、配置、配置文件和生命周期。

此技能涵盖哪些内容？

• @QuarkusMain 和应用程序入口（何时需要自定义 main）
• CDI 作用域：@ApplicationScoped、@Singleton、@Dependent；Bean 消歧（@Default、@Alternative、@Named）
• 使用 @Inject 进行构造函数注入
• 使用 CDI 拦截器（@Interceptor、@InterceptorBinding）处理横切关注点
• CDI 事件：@Observes StartupEvent / ShutdownEvent、使用 @ObservesAsync 进行异步分发
• 使用 Instance 进行程序化注入，以动态选择 Bean
• 使用 @ConfigMapping 和 Bean Validation（@Valid）进行结构化配置
• 特定配置文件的属性（%dev、%test、%prod）和 @IfBuildProfile
• 启动和关闭观察器（@Startup、@PreDestroy）
• 使用 @RunOnVirtualThread 的虚拟线程（Java 21+）
• Native Image 安全性：@RegisterForReflection、@DisabledOnNativeImage

范围： 根据参考规则和良好／不良代码示例应用建议。

约束

应用任何 Quarkus 变更之前，确保项目可以编译。如果编译失败，请立即停止。应用改进后，运行完整验证。

• 必须： 应用任何变更之前，运行 ./mvnw compile 或 mvn compile
• 前提条件： 应用 Quarkus 核心改进之前，项目必须成功编译
• 安全要求： 如果编译失败，请立即停止——编译失败属于阻塞条件
• 阻塞条件： 用户必须先解决编译错误，才能继续
• 验证： 应用改进后，运行 ./mvnw clean verify 或 mvn clean verify
• 应用前： 阅读参考文档，了解详细规则、良好／不良模式和约束

何时使用此技能

• 审查 Java 代码中的 Quarkus 应用程序结构和 CDI
• 应用 Quarkus 配置和 Bean 的最佳实践
• 改进 Quarkus 中的 CDI 拦截器、事件或程序化注入
• 添加虚拟线程配置或调整 CDI 生命周期
• 审查 Quarkus CDI Bean 生命周期和配置

工作流

1. 阅读参考文档并评估项目上下文

阅读 references/401-frameworks-quarkus-core.md，并在提出变更前检查当前项目设置。

2. 明确范围并确定目标改进

确定所需结果、约束，以及要应用的最小安全变更集。

3. 应用符合框架规范的变更

按照参考模式和项目约定实现或重构配置／代码。

4. 运行验证并报告结果

执行适当的构建／测试，并总结变更内容、验证情况以及后续操作。

参考

详细指南、示例和约束，请参阅 references/401-frameworks-quarkus-core.md。