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 发现。

⚠️ 注意事项:

TextIn Tools
TextIn Tools

是一款免费在线OCR工具,包含文字识别、表格识别,PDF转文件,文件转PDF、其他格式转换,识别率高,体验好,免费。

下载
  • 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)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1851

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指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

919

2024.11.28

excel制作动态图表教程
excel制作动态图表教程

本专题整合了excel制作动态图表相关教程,阅读专题下面的文章了解更多详细教程。

24

2025.12.29

freeok看剧入口合集
freeok看剧入口合集

本专题整合了freeok看剧入口网址,阅读下面的文章了解更多网址。

74

2025.12.29

俄罗斯搜索引擎Yandex最新官方入口网址
俄罗斯搜索引擎Yandex最新官方入口网址

Yandex官方入口网址是https://yandex.com;用户可通过网页端直连或移动端浏览器直接访问,无需登录即可使用搜索、图片、新闻、地图等全部基础功能,并支持多语种检索与静态资源精准筛选。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

207

2025.12.29

python中def的用法大全
python中def的用法大全

def关键字用于在Python中定义函数。其基本语法包括函数名、参数列表、文档字符串和返回值。使用def可以定义无参数、单参数、多参数、默认参数和可变参数的函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

16

2025.12.29

python改成中文版教程大全
python改成中文版教程大全

Python界面可通过以下方法改为中文版:修改系统语言环境:更改系统语言为“中文(简体)”。使用 IDE 修改:在 PyCharm 等 IDE 中更改语言设置为“中文”。使用 IDLE 修改:在 IDLE 中修改语言为“Chinese”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

18

2025.12.29

C++的Top K问题怎么解决
C++的Top K问题怎么解决

TopK问题可通过优先队列、partial_sort和nth_element解决:优先队列维护大小为K的堆,适合流式数据;partial_sort对前K个元素排序,适用于需有序结果且K较小的场景;nth_element基于快速选择,平均时间复杂度O(n),效率最高但不保证前K内部有序。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

12

2025.12.29

热门下载

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

精品课程

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

共23课时 | 2.1万人学习

C# 教程
C# 教程

共94课时 | 5.6万人学习

Java 教程
Java 教程

共578课时 | 39.5万人学习

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

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