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
知元AI

AI智能语音聊天 对讲问答 AI绘画 AI写作 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 是启用该管道的最小必要操作——轻量、标准、可靠。

相关文章

夸克浏览器
夸克浏览器

夸克Quark是一款采用 chromium 单核设计,网页渲染加载速度快,还有 0.3s 闪电启动的极速体验。内置隐私防护功能,能多方面保护用户隐私,可识别各种恶意软件和钓鱼网站,确保上网安全。与夸克网盘一体设计,拥有夸克高考、夸克搜题等多种智能工具,还有超过上万条过滤规则的超强去广告功能,以及智能拼页的阅读模式等。

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

1893

2024.04.01

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

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

2087

2024.08.01

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

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

1028

2024.11.28

java版本选择建议
java版本选择建议

本专题整合了java版本相关合集,阅读专题下面的文章了解更多详细内容。

0

2026.01.21

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

12

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

4

2026.01.21

无人机驾驶证报考 uom民用无人机综合管理平台官网
无人机驾驶证报考 uom民用无人机综合管理平台官网

无人机驾驶证(CAAC执照)报考需年满16周岁,初中以上学历,身体健康(矫正视力1.0以上,无严重疾病),且无犯罪记录。个人需通过民航局授权的训练机构报名,经理论(法规、原理)、模拟飞行、实操(GPS/姿态模式)及地面站训练后考试合格,通常15-25天拿证。

16

2026.01.21

Python多线程合集
Python多线程合集

本专题整合了Python多线程相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.21

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

4

2026.01.21

热门下载

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

精品课程

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

共23课时 | 2.7万人学习

C# 教程
C# 教程

共94课时 | 7.2万人学习

Java 教程
Java 教程

共578课时 | 49.1万人学习

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

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