0

0

如何在 Quarkus 扩展中通过构建时属性动态禁用 Bean

霞舞

霞舞

发布时间:2025-12-29 18:18:09

|

100人浏览过

|

来源于php中文网

原创

如何在 Quarkus 扩展中通过构建时属性动态禁用 Bean

quarkus 自定义扩展中,可通过 `@ifbuildproperty` 注解配合正确的 cdi bean 发现机制实现构建时条件化注册 bean;若 bean 未被识别为可选 cdi 组件,注解将失效——关键在于确保运行时模块包含 `meta-inf/beans.xml`(即使为空)以启用 bean 发现。

Quarkus 的 @IfBuildProperty(如 @IfBuildProperty(name = "myProperty", stringValue = "true"))仅对被 Quarkus 自动发现的 CDI Bean 生效。当你在扩展的运行时模块(runtime)中定义了带该注解的类,但未启用 CDI Bean 发现机制时,Quarkus 构建流程会完全忽略这些类——导致注解不生效,且后续通过 AdditionalBeanBuildItem 手动注册的 Bean 也无法被条件过滤。

✅ 正确做法:在扩展的 runtime 模块的 src/main/resources/META-INF/ 目录下添加一个空的 beans.xml 文件




? bean-discovery-mode="all" 是推荐值(Quarkus 2.0+ 默认行为),确保所有带有 CDI 相关注解(包括 @IfBuildProperty)的类均被扫描。即使内容为空(仅声明 schema),也能激活 Bean 发现。

⚠️ 注意事项:

蛙蛙写作
蛙蛙写作

超级AI智能写作助手

下载
  • beans.xml 必须位于 runtime 模块(而非 deployment 模块),因为运行时类加载和 CDI 处理发生在 runtime 层;
  • 不要删除 beans.xml 后尝试用 @Alternative 或 @Specializes 替代——它们无法替代构建时条件逻辑;
  • 若你仍需在 Processor 中显式添加 AdditionalBeanBuildItem,请避免重复注册已被 @IfBuildProperty 控制的类;优先依赖自动发现 + 注解机制,更符合 Quarkus 哲学;
  • 验证方式:构建时添加 -Dquarkus.log.category."io.quarkus.arc".level=DEBUG,观察日志中是否出现 Skipping bean due to @IfBuildProperty 提示。

✅ 总结:@IfBuildProperty 不是“魔法开关”,它依赖于 Quarkus 的 CDI Bean 发现管道。添加 META-INF/beans.xml 是启用该管道的最小必要操作——轻量、标准、可靠。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1848

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2080

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

917

2024.11.28

Golang 命令行工具(CLI)开发实战
Golang 命令行工具(CLI)开发实战

本专题系统讲解 Golang 在命令行工具(CLI)开发中的实战应用,内容涵盖参数解析、子命令设计、配置文件读取、日志输出、错误处理、跨平台编译以及常用CLI库(如 Cobra、Viper)的使用方法。通过完整案例,帮助学习者掌握 使用 Go 构建专业级命令行工具与开发辅助程序的能力。

1

2025.12.29

ip地址修改教程大全
ip地址修改教程大全

本专题整合了ip地址修改教程大全,阅读下面的文章自行寻找合适的解决教程。

162

2025.12.26

压缩文件加密教程汇总
压缩文件加密教程汇总

本专题整合了压缩文件加密教程,阅读专题下面的文章了解更多详细教程。

52

2025.12.26

wifi无ip分配
wifi无ip分配

本专题整合了wifi无ip分配相关教程,阅读专题下面的文章了解更多详细教程。

108

2025.12.26

漫蛙漫画入口网址
漫蛙漫画入口网址

本专题整合了漫蛙入口网址大全,阅读下面的文章领取更多入口。

349

2025.12.26

b站看视频入口合集
b站看视频入口合集

本专题整合了b站哔哩哔哩相关入口合集,阅读下面的文章查看更多入口。

677

2025.12.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.1万人学习

C# 教程
C# 教程

共94课时 | 5.5万人学习

Java 教程
Java 教程

共578课时 | 39万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号