Red Hat build of Quarkus 3.15 へのアプリケーションの移行

Red Hat build of Quarkus 3.15 では、最新の Spring Boot 3 API 更新に合わせて quarkus-spring-data-rest-extension がアップグレードされました。

コード内で PagingAndSortingRepository インターフェイスを使用している場合、このアップグレードによって重大な変更が発生する可能性があります。以前は、PagingAndSortingRepository は CrudRepository を拡張し、カスタムリポジトリーが CrudRepository からメソッドを継承できるようにしていました。

この変更に関連する問題を解決するには、カスタムリポジトリーを更新して、ListCrudRepository または CrudRepository のいずれかを直接拡張する必要があります。この調整により、必要なメソッドへの継続的なアクセスが確保され、更新されたアーキテクチャーとの互換性が維持されます。

Red Hat build of Quarkus 3.15 では、Dev Services を起動するかどうかを決定する方法が変更されました。

以前は、Dev Services を起動するかを決定するために、Red Hat build of Quarkus は、設定プロパティーが拡張せずに定義されているかをチェックしていました。ただし、この方法では、プロパティーが空の値に展開された場合に問題が発生しました。

現在、Red Hat build of 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 が意図せず起動することが回避されます。式で変数が定義されていない場合、式全体が空になります。

Red Hat build of Quarkus 3.15 では、GraalVM SDK の依存関係がバージョン 23.1.2 に更新され、以前の見落としが修正され、最新の GraalVM 機能との互換性が確保されています。

GraalVM の代替を使用してエクステンションを開発する場合は、org.graalvm.sdk:graal-sdk 依存関係を org.graalvm.sdk:nativeimage に置き換えます。nativeimage アーティファクトには置換に必要なクラスのみが含まれるため、より合理化されます。

この変更を適用するには、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 の query メソッドを使用して間接参照を削除します。

@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();

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、次のパッケージ関連のプロパティーが改名または変更されました。設定で元のプロパティーを使用した場合、それらは引き続き機能しますが、警告が表示されます。

この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

これらの変更を反映し、ビルドプロセス中の警告メッセージを停止するために、コードファイルと設定ファイルを更新します。

Red Hat build of Quarkus 3.15 では、ProfileManager が複数のプロファイルを処理しなかったため、非推奨の ProfileManager クラスと ProfileManager#getActiveProfile メソッドが削除されました。

この削除により、次の設定変更が必要になります。

アクティブなプロファイルを取得するには、io.quarkus.runtime.configuration.ConfigUtils#getProfiles API を使用します。

この変更は手動で適用する必要があります。これは、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 クラスのサポートもしばらく継続される予定です。非推奨化の予定は、後日発表される予定です。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Hibernate ORM エクステンションは、実行時に接続するデータベースバージョンが、ビルド時に設定されたバージョン以上であることを確認します。この検証は、設定が Red Hat build of Quarkus でサポートされている最小データベースバージョンをターゲットとするデフォルト設定に依存している場合でも実行されます。

この更新の目的は、Hibernate ORM または Red Hat build of Quarkus がサポートしなくなったデータベースバージョンを使用しようとした場合に、アプリケーション開発者に警告することです。サポートされなくなったデータベースバージョンを使用しようとすると、Red Hat build of Quarkus は起動せず、例外がスローされます。

この変更は、次のデータベースバージョンに依存するアプリケーションに影響します。

データベースをサポートされているバージョンにアップグレードできない場合でも、一部の機能が動作しない可能性がありますが、引き続き使用してみることはできます。以前のサポートされていないデータベースバージョンを引き続き使用するには、db-version を明示的に設定し、必要に応じて dialect も設定します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

詳細は、以下の資料を参照してください。

Red Hat build of Quarkus 3.15 では、いくつかの Dev Services のデフォルトイメージが次のバージョンに更新されました。

この変更を適用するには、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 Query Language (HQL)、Java Persistence Query Language (JPQL)、またはネイティブクエリーを実行する前に、これらの変更がクエリー結果に影響を及ぼす可能性があることを検出した場合、Hibernate ORM は保留中の変更のみをデータベースにフラッシュします。

ほとんどの場合、この最適化により、バッチ処理の効率化など、アプリケーションのパフォーマンスが向上しますが、次の問題が発生する可能性があります。

以前の動作に戻して別のデフォルト値を選択する場合は、quarkus.hibernate-orm.flush.mode 設定プロパティーが導入されています。このプロパティーを always に設定します: quarkus.hibernate-orm.flush.mode=always。

この変更は手動で適用する必要があります。これは、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 が接続するデータベース内のシステムテーブルに依存しており、Red Hat build of Quarkus 3.15 では、これらのシステムテーブルのスキーマが変更される可能性があります。

このエクステンションを使用する場合は、データベーススキーマを移行する必要があります。データベーススキーマを移行する方法は、"Hibernate Search migration" ガイドの Outbox polling database tables セクションを参照してください。

データベーススキーマを更新できない場合は、次の設定を適用して以前のデフォルトを復元します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Hibernate ORM with Panache、Hibernate Reactive with Panache、または MongoDB with Panache を使用する場合、外部定義エンティティーに io.quarkus:quarkus-panache-common アノテーションプロセッサーが不要になったため、削除されました。

以前のリリースでは、このアノテーションプロセッサーはクラスパスで見つかったときに自動的に実行されていました。ビルドツールでアノテーションプロセッサーのセットをオーバーライドした場合は、明示的に追加する必要がありました。

アノテーションプロセッサーリストから io.quarkus:quarkus-panache-common へのすべての参照を削除します。

この変更を適用するには、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 メッセージングエクステンションの 同期メソッド の実行モードがデフォルトでワーカースレッドに設定されるようになりました。以前のバージョンでは、これらのメソッドは Vert.x イベントループ (I/O スレッド) で実行されていました。

たとえば、次の処理メソッドは、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 スレッド) で呼び出されるようになります。

メッセージングメソッドを確認して、必要な実行モードで実行されることを確認し、必要に応じてコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarku 3.15 では、SmallRye Reactive Messaging エクステンションの名前が quarkus-messaging-* に変更され、リアクティブワークロードとブロッキングワークロードの両方をサポートしていることが反映されています。

Maven の再配置が実装されました。この変更を適用するには、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドに記載されている自動更新を実行します。

プロジェクト内の古いエクステンション名のすべてのインスタンスを新しい名前に置き換えます。

設定ルートも quarkus.smallrye-reactive-messaging. から quarkus.messaging. に更新されました。必要に応じて、古い設定プロパティーに戻すための自動フォールバックメカニズムが用意されています。

これらの変更を反映するようにコードと設定を更新します。

Red Hat build of Quarkus 3.15 では、quarkus.opentelemetry.* namespace の下にあるすべての設定プロパティーが削除されました。

これらのプロパティーは非推奨となり、バージョン 3.2 および 3.8 では下位互換性のために維持されています。これらは 3.15 で削除されたため、アプリケーションを移行するには次の変更を行う必要があります。

これらの新しいプロパティーと値を使用するには、コードと設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、非推奨のアノテーション io.opentelemetry.extension.annotations.WithSpan が削除されました。新しい io.opentelemetry.instrumentation.annotations.WithSpan アノテーションを使用するようにコードを更新します。

この更新との互換性を確保するために、古いアノテーションに依存する設定またはコードを確認して変更してください。

この変更は手動で適用する必要があります。これは、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 semantic convention stability migration で定義された新しい規則が適用されます。また、非推奨の標準の削除も完了します。これらの規約に依存するコードまたは設定を更新します。

さらに、オプトインがサポートされなくなったため、quarkus.otel.semconv-stability.opt-in システムプロパティーは削除されました。このプロパティーに依存するコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、OpenTelemetry (OTel) REST クライアントのスパン名に HTTP リクエストメソッドとパスの両方が含まれるようになりました (例: GET /hello)。以前の REST クライアントのスパン名には、HTTP メソッドのみが含まれていました。

REST クライアントスパンの特定の形式に依存するコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、使用するライブラリーの更新により、データベース操作によって生成されるスパン名が変更されました。

たとえば、この変更前は、データベーステーブルを作成するための古いスパン名は DB Query でした。この変更により、新しいスパン名は CREATE TABLE {table_name} になります。

この新しい命名規則により、実行される特定のデータベース操作を正確に反映する、より説明的で意味のあるスパン名が提供されます。

その結果、可観測性ツールでデータベース操作によって生成されたスパンに異なる名前が付けられていることに気付く場合があります。

新しい命名規則に対応するために、古いスパン名に依存するカスタムモニタリング設定、アラート、またはダッシュボードを確認して更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

データベーススパンの命名規則とベストプラクティスの詳細は、OpenTelemetry Database Span Semantic Conventions の仕様を参照してください。

以前のバージョンでは、一部の設定プロパティーが quarkus.health 設定ルートの下に誤って配置されていました。

Red Hat build of Quarkus 3.15 では、一貫性を保つために、これらのプロパティーは quarkus.smallrye-health 設定ルートに再配置されました。

Red Hat build of Quarkus 3.15 では、古い設定ルートを持つプロパティーは非推奨となり、今後のリリースで削除される予定です。新しいプロパティーのロケーションを使用するようにコードまたは設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Java Keystroke (JKS) はデフォルトのキーストアおよびトラストストア形式ではなくなりました。

代わりに、Red Hat build of Quarkus は、次のようにファイル拡張子に基づいて形式を決定します。

ファイルでこれらの拡張子のいずれも使用していない場合は、ファイル形式を設定する必要があります。

たとえば、JKS 形式を指定するには、次の設定値を設定します。

Red Hat build of Quarkus 3.15 では、io.quarkus.oidc.UserInfo が REST エンドポイントに注入されると、quarkus.oidc.authentication.user-info-required プロパティーが自動的に true に設定されるようになりました。この変更により、UserInfo は通常、使用が意図されたときに注入されるため、このプロパティーを手動で設定する必要がなくなります。

ただし、複数の OIDC テナントがエンドポイントを保護し、一部のテナントが UserInfo をサポートしていない複雑なセットアップでは、この変更によりテナントの初期化が失敗する可能性があります。これは、UserInfo をサポートしていないテナントが UserInfo を取得するように設定されている場合にのみ発生し、そのテナントによって保護されたリクエストが失敗する可能性があります。

マルチテナントセットアップでこのような失敗を回避するには、UserInfo をサポートしていないテナントに対して、テナント固有の quarkus.oidc.<tenant-id>.authentication.user-info-required プロパティーを false に設定します。これにより、UserInfo をサポートするテナントのみがその取得を強制するようになります。

この変更は手動で適用する必要があります。これは、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>

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、Quarkus REST (旧称 RESTEasy Reactive) の Hypertext Application Language (HAL) ラッパークラスのシグネチャーが変更され、コレクション内の要素の型が含まれるようになりました。

コード内で HAL ラッパークラスを使用する場所に適切な型引数を追加します。

この変更は手動で適用する必要があります。これは、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 リンクのサポート セクションを参照してください。

以前のリリースでは、要求されたリソースが REST リソースでない場合でも、Quarkus REST (旧称 RESTEasy Reactive) フィルターが実行されていました。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 リソースで実行されていたため、他のエクステンションが "Not Found" シナリオを効果的に処理することが困難でした。

この変更は手動で適用する必要があります。これは、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 アノテーションを適用します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

Red Hat build of Quarkus 3.15 では、RESTEasy Reactive エクステンションの名前が quarkus-rest-* に変更され、リアクティブワークロードとブロッキングワークロードの両方をサポートしていることが反映されています。

Maven の再配置が実装されました。この変更を適用するには、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 も含まれるように強化されています。

新しいエクステンション名を使用するようにコードと設定を更新します。

この変更は手動で適用する必要があります。これは、Red Hat build of Quarkus 3.15 へのアプリケーションの移行 ガイドで説明されている自動更新ではカバーされません。

詳細は、Quarkus の Web 依存関係ロケーター ガイドを参照してください。