1.5. 弃用的组件和功能
本节中列出的组件和功能在 Red Hat build of Quarkus 3.20 中弃用。这个版本包括了并支持它们。但是,不会对这些组件和功能进行任何增强,它们可能会在以后被删除。
有关本发行版本中弃用的组件和功能列表,请登录红帽客户门户网站并查看 红帽构建的 Quarkus 组件详情页面。
1.5.1. 旧配置类已弃用
在红帽构建的 Quarkus 3.20 中,基于 @ConfigRoot
和 @ConfigItem
的传统配置类已弃用。此弃用准备迁移到 @ConfigMapping
框架,该框架提供了更加一致和类型安全的配置模型。
本发行版本中提供了现有配置类的兼容性层,但计划在以后的版本中删除。
建议开发人员更新其代码,以使用 @ConfigMapping
接口来确保长期兼容性。
如需更多信息,请参阅 JIRA 问题 QDOCS-1150。
1.5.2. quarkus.http.cors
属性已弃用
在 Red Hat build of Quarkus 3.20 中,quarkus.http.cors
配置属性已弃用。若要启用 Cross-Origin Resource Sharing (CORS),请改为使用 quarkus.http.cors.enabled
属性。
按如下方式更新您的配置:
quarkus.http.cors.enabled=true
引进了这个更改来提高与 YAML 配置的兼容性,以前的结构需要使用特殊语法(如
~
)为 root 键分配值,从而导致混淆或容易出错的设置。
有关更多信息,请参阅 跨资源共享(CORS)指南。
1.5.3. quarkus.log commands.json
属性已弃用
在 Red Hat build of Quarkus 3.20 中,quarkus.log aws.json
配置属性已弃用。要为日志记录启用 JSON 格式,请使用 quarkus.log aws.json.enabled
属性。
按如下方式更新您的配置:
quarkus.log.console.json.enabled=true
引进了这个更改来提高与 YAML 配置的兼容性,以前的结构需要使用特殊语法(如 ~
)为 root 键分配值,从而导致混淆或容易出错的设置。
如需更多信息,请参阅 迁移指南 3.19。
1.5.4. smallrye Fault Tolerance 版本 6.7.0 弃用了第一代程序 API
在 Red Hat build of Quarkus 3.20 中,quarkus-smallrye-fault-tolerance
扩展包括 SmallRye Fault Tolerance 6.7.0,它没有破坏更改,但包括以下更新:
-
Programmatic API 的第一个版本(
FaultTolerance
,@ApplyFaultTolerance
)已弃用,计划在 SmallRye Fault Tolerance 7.0 中删除。第二个版本(Guard
、TypedGuard
、@ApplyGuard
)充当替换,但存在显著区别。 - 规范定义的配置属性仍然可用,但红帽构建的 Quarkus 现在提供您可以改为使用的原生配置属性。
如需更多信息,请参阅 SmallRye Fault Tolerance 6.7.0 发行公告,其中包括到 programmatic API 迁移指南的链接,以及新配置属性的详情。Quarkus SmallRye Fault Tolerance 指南为这些配置属性提供了完整的参考。
1.5.5. Websocket 和 WebSockets 客户端扩展已弃用
红帽构建的 Quarkus 3.20 弃用 quarkus-websockets
和 quarkus-websockets-client
扩展,该扩展实现了 Jakarta WebSocket 规格。
Red Hat build of Quarkus 计划在以后的发行版本中停止支持这些扩展。
为确保与即将推出的版本兼容,请迁移到 Quarkus WebSockets Next 扩展quarkus-websockets-next
,它提供现代、效率更高的 WebSocket API。
如需更多信息,请参阅以下 Quarkus 资源:
- WebSocket Next 入门
- Websocket 下一步参考指南
- quarkus WebSockets Next extension 部分 "Release Notes for Red Hat build of Quarkus 3.20" 指南中的
这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。