Red Hat build of Quarkus 3.15 发行注记

随着红帽构建的 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 参考指南。

红帽为使用 Quarkus 开发工具提供开发支持，包括 Quarkus CLI 和 Maven 和 Gradle 插件，以设计、开发、测试和部署红帽构建的 Quarkus 应用程序。

红帽不支持在生产环境中使用 Quarkus 开发工具。如需更多信息，请参阅红帽知识库文章 开发支持覆盖范围。

随着红帽构建的 Quarkus 3.15，quarkus-spring-data-rest-extension 被升级，以便与最新的 Spring Boot 3 API 更新保持一致。

如果您在代码中使用 PagingAndSortingRepository 接口，则此升级可能会引入破坏更改。在以前的版本中，PagingAndSortingRepository 扩展 CrudRepository，它允许您的自定义存储库继承 CrudRepository 的方法。

要解决与这个更改相关的问题，您必须更新自定义存储库来直接扩展 ListCrudRepository 或 CrudRepository。此调整可确保持续访问所需的方法，并保持与更新的架构的兼容性。

在 Red Hat build of Quarkus 3.15 中，用来确定 Dev Services 是否启动的方法已更改。

在以前的版本中，要决定是否启动 Dev Services，红帽构建的 Quarkus 会检查是否定义了配置属性而无需扩展它。但是，如果属性扩展到空值，这种方法会导致问题。

现在，红帽构建的 Quarkus 首先检查扩展属性是否为空。当扩展属性结束为空时，这个更改可能会导致 Dev Services 意外启动。当未提供给定属性时，大多数 Dev Services 都会启动，例如 JDBC URL。

由于这个变化，您应该将配置属性调整为包含默认值，确保扩展的属性不为空。

例如，如果您使用 quarkus-test-oidc-server 组件模拟 OpenID Connect (OIDC)服务器，且 application.properties 文件包含：

%test.quarkus.oidc.auth-server-url=${keycloak.url}/realms/quarkus/

%test.quarkus.oidc.auth-server-url=${keycloak.url}/realms/quarkus/

将属性值改为：

%test.quarkus.oidc.auth-server-url=${keycloak.url:replaced-by-test-resource}/realms/quarkus/

%test.quarkus.oidc.auth-server-url=${keycloak.url:replaced-by-test-resource}/realms/quarkus/

这样，如果没有定义 keycloak.url，默认的 replaced-by-test-resource 值可防止属性扩展到空值，从而避免 Dev Services 的意外启动。如果表达式中没有定义变量，则整个表达式将为空。

红帽构建的 Quarkus 3.15 将 GraalVM SDK 依赖项更新为版本 23.1.2，更正早期的超天并确保与最新的 GraalVM 功能兼容。

如果您使用 GraalVM 替换开发扩展，请将 org.graalvm.sdk:graal-sdk 依赖项替换为 org.graalvm.sdk:nativeimage。nativeimage 工件仅包含替换所需的类，使其更精简。

您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

在 Red Hat build of Quarkus 3.15 中，Infinispan 15 组件已升级到 15.0 版本。

在之前的发行版本中，在 Infinispan 15 集成前，您可以使用以下 .Query.java 代码运行查询：

@Inject
RemoteCache<String, Book> booksCache;

…

QueryFactory queryFactory = Search.getQueryFactory(booksCache);
Query query = queryFactory.create("from book_sample.Book");
List<Book> list = query.execute().list();

@Inject
RemoteCache<String, Book> booksCache;

…

QueryFactory queryFactory = Search.getQueryFactory(booksCache);
Query query = queryFactory.create("from book_sample.Book");
List<Book> list = query.execute().list();

但是，在这个版本里，此代码不再可以正常工作，因为 RemoteCache 现在是一个 @ApplicationScoped 代理 bean 和 Search.getQueryFactory 引发 ClassCastException。

要解决这个问题，使用 RemoteCache API 中的 查询 方法删除间接，如下所示：

@Inject
RemoteCache<String, Book> booksCache;

…

Query<Book> query = booksCache.<Book>query("from book_sample.Book");
List<Book> list = query.execute().list();

@Inject
RemoteCache<String, Book> booksCache;

…

Query<Book> query = booksCache.<Book>query("from book_sample.Book");
List<Book> list = query.execute().list();

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，以下与打包相关的属性已被重命名或更改。如果您在配置中使用原始属性，它们仍可以正常工作，但会显示警告。

您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

更新任何代码和配置文件，以反映这些更改并在构建过程中停止警告信息。

在 Red Hat build of Quarkus 3.15 中，弃用的 ProfileManager 类和 ProfileManager"getActiveProfile 方法被删除，因为 ProfileManager 无法处理多个配置集。

在这个版本中，需要以下配置更改：

要检索活跃的配置集，请使用 io.quarkus.runtime.configuration.ConfigUtils"getProfiles API。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在早期版本中，会发现一个不需要的行为，无论生成的工件类型是什么，都会在构建系统的输出目录中生成 quarkus-app 目录。

在 Red Hat build of Quarkus 3.15 中，构建过程只为 fast-jar 软件包创建 quarkus-app 目录，这是默认的工件类型。如果您为不同的工件类型配置构建，则不会创建 quarkus-app 目录。

在 Red Hat build of Quarkus 3.15 中，用于生成运行时文件和配置文件的扩展注解处理器已被重新开发，提供了更大的灵活性，但使用新限制：

我们鼓励迁移至新的 @ConfigMapping 接口，但计划对旧的 @ConfigRoot 类的支持，以确保顺利迁移。计划稍后宣布弃用计划。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，Hibernate ORM 扩展会验证它在运行时连接的数据库版本至少与构建时配置的成本至少相同。即使配置依赖于红帽构建的 Quarkus 支持的最低数据库版本，也会进行这个验证。

在这个版本中，旨在提醒应用程序开发人员是否尝试使用 Hibernate ORM 或红帽构建的 Quarkus 不再支持的数据库版本。如果您尝试使用不再支持的数据库版本，红帽构建的 Quarkus 不会启动并抛出异常。

这个更改会影响依赖以下数据库版本的应用程序：

如果您无法将数据库升级到受支持的版本，您仍然可以尝试使用它，虽然某些功能可能无法正常工作。要继续使用较早的、不受支持的数据库版本，请明确设置 db-version，如有必要，还要设置 dialect。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

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

在 Red Hat build of Quarkus 3.15 中，几个 Dev Services 的默认镜像更新至以下版本：

您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

要使用这些服务的特定版本或分发，您必须手动覆盖应用程序属性中的默认容器镜像。

如需更多信息，请参阅 Quarkus "Dev Services for Elasticsearch" 指南中的 配置 镜像部分。

在 Red Hat build of Quarkus 3.15 中，Hibernate Object/Relational Mapping (ORM) auto-flush 功能已被优化。

现在，默认情况下，在运行 Hibernate 查询语言(HQL)、Java Persistence Query Language (JPQL)或原生查询之前，如果数据库检测到这些更改可能会影响查询结果，则 Hibernate ORM 只清除待处理的更改。

在大多数情况下，这种优化将提高应用程序的性能，如更有效地批处理，但可能会出现以下问题：

如果要恢复到之前的行为并选择替代的默认值，则会引入 quarkus.hibernate-orm.flush.mode 配置属性。将此属性设置为 always:quarkus.hibernate-orm.flush.mode=always。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

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

在 Red Hat build of Quarkus 3.15 中，Hibernate ORM 扩展已升级到 Hibernate ORM 6.6，并包括以下有问题的更改：

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

quarkus-hibernate-search-orm-outbox-polling 扩展依赖于数据库中的系统表，Hibernate ORM 连接，以及红帽构建的 Quarkus 3.15，这些系统表的 schema 可能会改变。

如果使用此扩展，则需要迁移数据库架构。有关如何迁移数据库模式的详情，请参考"Hibernate 搜索迁移"指南中的 Outbox 轮询数据库表 部分。

如果无法更新数据库模式，请应用以下设置来恢复之前的默认值：

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，io.quarkus:quarkus-panache-common 注解处理器已被删除，因为在使用带有 Panache 的 Hibernate ORM 时，不再需要它用于外部定义的实体，使用 Panache 的 Hibernate Reactive with Panache。

在早期版本中，此注解处理器会在 classpath 中找到时自动运行。如果您在构建工具中覆盖了一组注解处理器，则需要显式添加它。

从注解处理器列表中删除对 io.quarkus:quarkus-panache-common 的所有引用。

您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

<build>
    <plugins>
        <!-- other plugins -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.13.0</version> <!-- Necessary for proper dependency management in annotationProcessorPaths -->
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>io.quarkus</groupId>
                        <artifactId>quarkus-panache-common</artifactId>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
        <!-- other plugins -->
    </plugins>
</build>

<build>
    <plugins>
        <!-- other plugins -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.13.0</version> <!-- Necessary for proper dependency management in annotationProcessorPaths -->
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>io.quarkus</groupId>
                        <artifactId>quarkus-panache-common</artifactId>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
        <!-- other plugins -->
    </plugins>
</build>

dependencies {
    annotationProcessor "io.quarkus:quarkus-panache-common"
}

dependencies {
    annotationProcessor "io.quarkus:quarkus-panache-common"
}

在 Red Hat build of Quarkus 3.15 中，Quarkus Messaging extensions 中 同步方法的 执行模式现在默认为 worker 线程。在早期版本中，这些方法在 Vert.x 事件循环(I/O 线程)上运行。

例如，现在在 worker 线程上默认调用以下处理方法，而不是 Vert.x I/O 线程：

package org.acme;

import org.eclipse.microprofile.reactive.messaging.Incoming;
import org.eclipse.microprofile.reactive.messaging.Outgoing;

@Incoming("source")
@Outgoing("sink")
public Result process(int payload) {
    return new Result(payload);
}

package org.acme;

import org.eclipse.microprofile.reactive.messaging.Incoming;
import org.eclipse.microprofile.reactive.messaging.Outgoing;

@Incoming("source")
@Outgoing("sink")
public Result process(int payload) {
    return new Result(payload);
}

要恢复到更早的行为，您可以使用 quarkus.messaging.blocking.signatures.execution.mode 配置属性。

可能的值有：

您还可以使用 @Blocking 和 @NonBlocking 注解来基于每个方法调整执行模式：

package org.acme;

import io.smallrye.common.annotation.NonBlocking;
import org.eclipse.microprofile.reactive.messaging.Incoming;

@Incoming("source")
@NonBlocking
public void consume(int payload) {
    // called on I/O thread
}

package org.acme;

import io.smallrye.common.annotation.NonBlocking;
import org.eclipse.microprofile.reactive.messaging.Incoming;

@Incoming("source")
@NonBlocking
public void consume(int payload) {
    // called on I/O thread
}

通过注解方法 @NonBlocking，您可以确保在 Vert.x 事件循环(I/O 线程)中调用它。

检查您的消息传递方法，以确保它们在所需的执行模式下运行，并根据需要更新您的代码或配置。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，smallRye Reactive Messaging 扩展已被重命名为 quarkus-messaging sHistoryLimit，以反映它们对被动和阻塞工作负载的支持。

Maven 重新定位过程已被实现。您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

将项目中旧扩展名称的所有实例替换为新名称。

配置 root 也已从 quarkus.smallrye-reactive-messaging. 更新至 quarkus.messaging。自动回退机制已就位，可恢复到旧的配置属性（如有必要）。

更新您的代码和配置，以反映这些更改。

在 Red Hat build of Quarkus 3.15 中，quarkus.opentelemetrySetConfiguration 命名空间下 的所有配置属性都已被删除。

这些属性已弃用，并保持在版本 3.2 和 3.8 中的向后兼容性。由于它们现已在 3.15 中删除，您必须进行以下更改来迁移应用程序：

更新您的代码和配置，以使用这些新属性和值。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，弃用的注解 io.opentelemetry.extension.annotations.WithSpan 已被删除。更新您的代码，以使用新的 io.opentelemetry.instrumentation.annotations.WithSpan 注解。

检查并更改依赖旧注解的任何配置或代码，以确保与此次更新兼容。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，OpenTelemetry (OTel) SDK 已升级到版本 1.39.0，并检测到版本 2.5.0。此升级强制使用 OpenTelemetry HTTP 语义约定中定义的新约定稳定性迁移。它还完成删除已弃用的标准。更新依赖于这些约定的任何代码或配置。

另外，quarkus.otel.semconv-stability.opt-in 系统属性已被删除，因为 opting-in 不再被支持。更新依赖于此属性的任何代码或配置。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，OpenTelemetry (OTel) REST 客户端 span 名称现在包含 HTTP 请求方法和路径，例如 GET /hello。较早的 REST 客户端范围名称仅包含 HTTP 方法。

更新依赖于 REST 客户端范围名称特定格式的代码或配置。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，由数据库操作生成的 span 名称因我们使用的库中的更新而改变。

例如，在更改之前，用于创建数据库表的旧 span 名称是 DB Query。现在，在这一变化中，新范围名称为 CREATE TABLE {table_name}。

这个新的命名规则提供了更描述性和有意义的范围名称，可以准确反映执行的特定数据库操作。

因此，您可能会在可观察性工具中发现由数据库操作生成的 span 的不同名称。

检查和更新依赖于旧范围名称的任何自定义监控配置、警报或仪表板，以适应新的命名规则。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

有关数据库范围命名约定和最佳实践的更多信息，请参阅 OpenTelemetry 数据库 Span Semantic Conventions 规格。

在早期版本中，一些配置属性被错误地位于 quarkus.health 配置 root 下。

在 Red Hat build of Quarkus 3.15 中，这些属性已重新定位到 quarkus.smallrye-health 配置 root 以实现一致性：

在 Red Hat build of Quarkus 3.15 中，带有旧配置 root 的属性已被弃用，计划在以后的发行版本中删除。更新任何代码或配置，以使用新的属性位置。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

使用红帽构建的 Quarkus 3.15，Java Keystroke (JKS)不再是默认的密钥存储和信任存储格式。

反之，红帽构建的 Quarkus 根据文件扩展名决定格式，如下所示：

如果您的文件没有使用其中一个扩展，您必须设置文件格式。

例如，要指定 JKS 格式，请设置以下配置值：

在 Red Hat build of Quarkus 3.15 中，quarkus.oidc.authentication.user-info-required 属性现在会在 io.quarkus.oidc.UserInfo 注入 REST 端点时自动设置为 true。这个更改删除了手动配置此属性的需要，因为用户Info 通常会在使用属性时注入。

但是，在更复杂的设置中，如果多个 OIDC 租户安全端点，一些租户不支持 UserInfo，则这个更改可能会导致租户初始化失败。只有在不支持 UserInfo 的租户仍然配置为获取它时，会出现这种情况，可能会导致该租户保护的请求失败。

为了避免多租户设置中的此类故障，在不支持 UserInfo 的租户中将特定于 租户的 quarkus.oidc.<tenant-id>.authentication.user-info-required 属性设置为 false。这样可确保只有支持 UserInfo 的租户强制其收购。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，Quarkus BOM 不再强制执行 org.junit-pioneer 的版本：junit-pioneer 依赖项。如果您在项目中使用此依赖项，则必须在构建文件中明确指定其版本。

要避免构建问题，请在 pom.xml 或 build.gradle 文件中定义版本；例如：

<properties>
    ...
    <junit-pioneer.version>2.2.0</junit-pioneer.version>
    ...
</properties>

<properties>
    ...
    <junit-pioneer.version>2.2.0</junit-pioneer.version>
    ...
</properties>

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 for Quarkus REST （以前称为 RESTEasy Reactive）中），HAL）打包程序类的签名已被修改为包含集合中元素的类型：

在每次代码中使用 HAL 打包程序类时，添加适当的 type 参数。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

@Path("/records")
public class RecordsResource {

    @Inject
    HalService halService;

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @RestLink(rel = "list")
    public HalCollectionWrapper<Record> getAll() {
        List<Record> list = // ...
        HalCollectionWrapper<Record> halCollection = halService.toHalCollectionWrapper( list, "collectionName", Record.class);
        // ...
        return halCollection;
    }

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @Path("/{id}")
    @RestLink(rel = "self")
    @InjectRestLinks(RestLinkType.INSTANCE)
    public HalEntityWrapper<Record> get(@PathParam("id") int id) {
        Record entity = // ...
        HalEntityWrapper<Record> halEntity = halService.toHalWrapper(entity);
        // ...
        return halEntity;
    }
}

@Path("/records")
public class RecordsResource {

    @Inject
    HalService halService;

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @RestLink(rel = "list")
    public HalCollectionWrapper<Record> getAll() {
        List<Record> list = // ...
        HalCollectionWrapper<Record> halCollection = halService.toHalCollectionWrapper( list, "collectionName", Record.class);
        // ...
        return halCollection;
    }

    @GET
    @Produces({ MediaType.APPLICATION_JSON, RestMediaType.APPLICATION_HAL_JSON })
    @Path("/{id}")
    @RestLink(rel = "self")
    @InjectRestLinks(RestLinkType.INSTANCE)
    public HalEntityWrapper<Record> get(@PathParam("id") int id) {
        Record entity = // ...
        HalEntityWrapper<Record> halEntity = halService.toHalWrapper(entity);
        // ...
        return halEntity;
    }
}

虽然使用构造器创建 HAL 包装器仍可以正常工作，但该方法可能在以后的版本中被弃用。因此，开始使用 HalService bean 公开的帮助程序方法。

如需更多信息，请参阅"Quarkus REST"指南中的 Web 链接支持 部分。

在早期版本中，Quarkus REST （以前称为 RESTEasy Reactive）过滤器也会运行，即使请求的资源不是 REST 资源。在 Red Hat build of Quarkus 3.15 中，该行为已更改。现在，Quarkus REST 过滤器仅在 REST 资源上运行。

如果您需要过滤器应用到非Quarkus REST 资源，您可以通过为 NotFoundException 添加自定义 ExceptionMapper 来完成此操作，如下例所示：

package io.quarkus.resteasy.reactive.server.test.customproviders;

import jakarta.ws.rs.NotFoundException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class NotFoundExeptionMapper implements ExceptionMapper<NotFoundException> {
    @Override
    public Response toResponse(NotFoundException exception) {
        return Response.status(404).build();
    }
}

package io.quarkus.resteasy.reactive.server.test.customproviders;

import jakarta.ws.rs.NotFoundException;
import jakarta.ws.rs.core.Response;
import jakarta.ws.rs.ext.ExceptionMapper;
import jakarta.ws.rs.ext.Provider;

@Provider
public class NotFoundExeptionMapper implements ExceptionMapper<NotFoundException> {
    @Override
    public Response toResponse(NotFoundException exception) {
        return Response.status(404).build();
    }
}

使用这个 ExceptionMapper，Quarkus REST 处理 "Not Found" 资源，允许过滤器按预期运行。在以前的版本中，过滤器总是在非 REST 资源上运行，这使得其他扩展很难有效地处理"未找到"场景。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，io.quarkus.qute.TemplateInstance 类不再注册为非阻塞类型。因此，如果 Jakarta REST （以前称为 JAX-RS）资源方法返回 TemplateInstance 对象，它现在默认被视为阻止。

要恢复之前的非阻塞行为，请将 @io.smallrye.common.annotation.NonBlocking 注解应用到资源方法。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

在 Red Hat build of Quarkus 3.15 中，RESTEasy Reactive 扩展已重命名为 quarkus-rest fluentd，以反映它们对被动和阻塞工作负载的支持。

Maven 重新定位过程已被实现。您可以通过运行 Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新来应用此更改。

将项目中旧扩展名称的所有实例替换为新名称。

大多数新扩展名称遵循以下命名约定：

配置根也已更新：

自动回退机制已就位，可恢复到旧的配置属性。

在 Red Hat build of Quarkus 3.15 中，quarkus-webjars-locator 扩展被重命名为 quarkus-web-dependency-locator，并改进了 mvnpm(Maven NPM)和 importmaps。

更新您的代码和配置，以使用新的扩展名称。

您必须手动应用此更改。Migrating applications to Red Hat build of Quarkus 3.15 指南中所述的自动更新不包括它。

如需更多信息，请参阅 Quarkus Web 依赖项 locator 指南。