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 指南中的自动更新过程中。