1.3. 新功能、功能增强和技术变化

随着红帽构建的 Quarkus 3.15，quarkus-spring-data-rest-extension 被重构为与最新的 spring-data-jpa 3.x 更新保持一致。这个版本包括以下密钥更改：

这个重构引入了破坏的变化。如需更多信息，请参阅 影响与早期版本兼容的更改 章节。

红帽构建的 Quarkus 3.15 引入了一个新的扩展 container-image-podman，专用于 Podman。

如果您希望使用 Podman 而不是 Docker，现在可以使用这个新扩展。它复制现有 container-image-docker 扩展的功能，同时支持使用 Podman 构建容器镜像并将其加载到本地 registry 中。

虽然 container-image-docker 扩展是，并且始终与 Podman 的 Docker 兼容 API 兼容，但 container-image-podman 是为使用 Podman 工具集无缝构建镜像而量身定制的。

对 Docker 特定的任务使用 container-image-docker 扩展，对与 Podman 相关的任务使用 container-image-podman 扩展。例如，对于 Docker 和 Podman，构建多平台镜像是不同的。Docker 使用 Buildx 插件，而 Podman 可以原生构建多平台镜像。因此，您必须使用特定的扩展来执行该功能。

在 Red Hat build of Quarkus 3.15 中，以下默认 UBI 镜像已升级：

红帽构建的 Quarkus 3.15 引入了扩展注解处理器的新架构，并删除了如何生成配置文档。

扩展注解处理器有两个主要目的：

通过此重新开发，注释处理器架构得到简化，并将构建扩展所需的文件与生成文档所需的文件分隔开。

在以前的版本中，扩展注解处理器会在 root target/generated/config 目录中生成配置文档。现在，扩展注解处理器会构建配置的模型，然后以各种所需格式输出，如 AsciiDoc。

如需更多信息，请参阅以下 Quarkus 资源：

Arc 是红帽构建的 Quarkus 的上下文和依赖注入(CDI)实施。默认情况下，拦截器只支持受管 Bean，也称为基于类的 Bean。

红帽构建的 Quarkus 3.15 引入了 InterceptionProxy API 和 @BindingsSource 注释，支持生成者方法和复合 Bean 的拦截器。

InterceptionProxy API 创建一个代理，该代理应用 @AroundInvoke 拦截器，然后将方法调用转发到目标实例。使用 @BindingsSource 注释，您可以在拦截器的类是外部且无法更改时设置拦截器绑定。

如需更多信息，请参阅 Quarkus 上下文和依赖项注入 指南。

红帽构建的 Quarkus 3.15 引入了 quarkus.live-reload.enabled 配置属性，您可以在使用带有 Dev 服务的功能的 dev 模式时关闭自动实时重新加载。

默认情况下，此属性设为 true。要禁用自动实时重新加载，请将其设置为 false。

红帽构建的 Quarkus 3.15 对 quarkus config 命令包括以下更新。

如需更多信息，请参阅配置指南中的 Quarkus Secret。

在 Red Hat build of Quarkus 3.15 中，Flyway 扩展已升级到 Flyway 10.10。

如需更多信息，请参阅使用 Flyway 指南 的 Quarkus。

红帽构建的 Quarkus 3.15 引入了增强，可加快大型实体模型的 Hibernate 对象关系映射(ORM)构建时间。

特别是，预计这些增强功能将使 Quarkus dev 模式的 Live Reload 功能更快响应具有大型实体模型的应用程序。

在 Red Hat build of Quarkus 3.15 中，Hibernate ORM 升级到 6.6 版本。

如需更多信息，请参阅以下资源：

在 Red Hat build of Quarkus 3.15 中，Hibernate Reactive 扩展已升级到 2.4 版本。

如需更多信息，请参阅 Quarkus Hibernate Reactive 指南。

在 Red Hat build of Quarkus 3.15 中，Hibernate Search 被升级到 7.2 版本。

Hibernate Search 为您的红帽构建的 Quarkus 应用程序提供索引和全文本搜索功能。要了解更多有关 Hibernate Search 的信息，请参阅以下资源：

在 Red Hat build of Quarkus 3.15 中，MongoDB 客户端从版本 4.11 升级到 5.1 版本。

红帽构建的 Quarkus 3.15 引入了与原生镜像代理集成，您可以在将应用程序编译到原生镜像时，红帽构建的 Quarkus 尚不支持库或组件。

通过这种集成，您可以使用需要大量原生镜像配置的 JDK API。您还可以使用原生镜像代理在 JVM 模式中为应用程序运行集成测试。代理生成的配置可帮助您开始使用不受支持的库并将应用程序作为原生可执行文件运行。

此集成仅适用于 Apache Maven。

如需更多信息，请参阅 Quarkus 原生参考指南。

红帽构建的 Quarkus 3.15 引入了 Dev 服务的 quarkus-observability-devservices 和 quarkus-observability-devservices-lgtm 扩展，支持 OpenTelemetry LGTM (OTel LGTM) Docker 镜像：

您可以更新 pom.xml 文件，将每个扩展添加为依赖项。例如：

<dependency>
   <groupId>io.quarkus</groupId>
   <artifactId>quarkus-observability-devservices-lgtm</artifactId>
   <version>${project.version}</version>
    <scope>provided</scope>
</dependency>

<dependency>
   <groupId>io.quarkus</groupId>
   <artifactId>quarkus-observability-devservices-lgtm</artifactId>
   <version>${project.version}</version>
    <scope>provided</scope>
</dependency>

如需更多信息，请参阅以下 Quarkus 资源：

在 Red Hat build of Quarkus 3.15 中，OpenTelemetry (OTel) SDK 版本从 1.32 升级到 1.39。另外，OTel 检测从版本 1.32 升级到 2.50。

这些升级包括以下破坏更改：

如需更多信息，请参阅 影响与早期版本的兼容性的更改。

当使用带有 OpenTelemetry (OTel)的 quarkus-redis-client 扩展时，Red Hat build of Quarkus 3.15 引入了对追踪的支持。

红帽构建的 Quarkus 提供了手动和自动的工具进行追踪。您必须将此 OpenTelemetry Redis 实现放在 quarkus-opentelemetry 扩展检测下。

追踪数据包括其他属性、request 语句、数据库实例和对等地址。状态代码和消息在错误 span 中提供。

如需更多信息，请参阅使用 Quarkus Redis 客户端 指南。

使用红帽构建的 Quarkus 3.15，您可以使用注解启用特定于 Jakarta REST 端点的身份验证机制。

由于您只能在 REST 端点匹配后选择验证机制，因此只有在禁用主动身份验证时（即 quarkus.http.auth.proactive 设置为 false 时，才会启用此功能。

如需更多信息，请参阅"Quarkus 身份验证机制"指南中的 Jakarta REST 端点启用基于路径的身份验证 部分。

红帽构建的 Quarkus 3.15 引入了一个新的注解 @ClientBasicAuth，它简化了如何在红帽构建的 Quarkus REST 客户端中使用基本身份验证用户名和密码设置 HTTP Authorization 标头。

使用 HTTP 基本身份验证时，quarkus.rest.client.reactive.ClientBasicAuth 注解简化了所需授权标头的配置。

例如：

@ClientBasicAuth(username = "${service.username}", password = "${service.password}")
public interface SomeClient {
}

@ClientBasicAuth(username = "${service.username}", password = "${service.password}")
public interface SomeClient {
}

在本例中，service.username 和 service.password 是您在运行时设置的配置属性，其使用适当的用户名和密码授予对目标服务的访问权限。

如需更多信息，请参阅使用 REST 客户端 的 Quarkus 指南。

在 Red Hat build of Quarkus 3.15 中，您可以使用访问令牌的签发者解决支持 Bearer 令牌身份验证的静态 OpenID Connect (OIDC)租户。

要使基于此问题的解决方案可以正常工作，请确保满足以下条件：

您必须使用 quarkus.oidc.resolve-tenants-with-issuer 属性启用令牌签发者。

如需更多信息，请参阅使用 OIDC 多租户 的 Quarkus 指南。

当用户重定向到 OpenID Connect (OIDC)供应商进行身份验证时，重定向必须指示到在身份验证完成后将用户定向到该供应商。

红帽构建的 Quarkus 3.15 引入了 OpenID Connect (OIDC)重定向过滤器来过滤 OIDC 重定向。您可以注册一个或多个 io.quarkus.oidc.OidcRedirectFilter 实现，以过滤 OIDC 重定向到 OIDC 授权和注销端点，并过滤 local 重定向到自定义错误和 session-expired 页面。

使用 OidcRedirectFilter，您还可以为所有重定向请求添加额外的查询参数、响应标头和设置新的 Cookie。

如需更多信息，请参阅 Quarkus " OIDC authorization code flow mechanism" 指南中的 OIDC redirect filter 部分。

在以前的版本中，如果无法刷新用户会话，当前经过身份验证的用户会被重定向到 OpenID Connect (OIDC)供应商来重新验证。但是，用户可能并不明显，为什么需要重新验证。

使用红帽构建的 Quarkus 3.15，您现在可以配置用户重定向到一个公共的特定于应用程序的、特定于会话的页面。此页面告知用户会话已过期，并建议他们通过指向安全应用程序 Welcome 页面的链接来重新进行身份验证。

要启用此页面，请指定 quarkus.oidc.authentication.session-expired-page 相对路径属性。

如需更多信息，请参阅 Quarkus OIDC 授权代码流机制。

红帽构建的 Quarkus 3.15 通过引入 OpenID Connect (OIDC) TokenCertificateValidator 注解来增强安全性。除了默认的链验证外，您还可以使用此注解将自定义证书链验证检查添加到令牌的证书链。

如需更多信息，请参阅 Quarkus OIDC bearer 令牌身份验证 指南。

使用红帽构建的 Quarkus 3.15，如果安全上下文可用，您可以将安全事件导出为 OpenTelemetry (OTel)事件。此功能将用户标识和角色添加到 span 属性中。

要启用此功能，请在 application.properties 文件中将以下配置属性设置为 true ：

quarkus.otel.security-events.enabled=true

如需更多信息，请参阅以下 Quarkus 资源：

在 OpenID Connect (OIDC)授权过程中，如果 ID 令牌没有提供有关当前经过身份验证的用户的足够信息，您可以从 UserInfo 端点以 JSON 格式获取更多信息。

在 Red Hat build of Quarkus 3.15 中，支持作为签名的 JSON Web Token (JWT)返回的 UserInfo。红帽构建的 Quarkus 会验证此签名的 JWT 令牌，然后使用安全 JSON 数据初始化 UserInfo。

Red Hat build of Quarkus 3.15 引入了一个新的传输层安全(TLS) registry扩展 quarkus-tls-registry，其中包括以下功能：

如需更多信息，请参阅 Quarkus TLS registry 参考指南。

使用 Quarkus REST 客户端时，您可能需要检查发送到服务器的请求，在处理 HTTPS 连接时，检查流量的最简单方法是通过直通代理。

使用红帽构建的 Quarkus 3.15，您可以为 REST 客户端添加 HTTP 直通代理。您可以使用此代理作为 wireshark 的目标，以获取 REST 客户端发送的请求内容。

要启用代理，请将 quarkus.rest-client.<client name>.enable-local-proxy 属性设置为 true。

随着红帽构建的 Quarkus 3.15，Vert.x HTTP 被改进。现在，您可以在 HTTP 服务器启动时运行自定义操作。

要做到这一点，您可以声明一个异步上下文和依赖注入(CDI)观察器方法。然后，当对应的 HTTP 服务器开始侦听配置的主机和端口时，红帽构建的 Quarkus 会触发以下 CDI 事件：

如需更多信息，请参阅 Quarkus HTTP 参考指南。