RESTEasy Reactiveへの移行

次の表は、従来のRESTEasyの依存関係と新しいRESTEasy Reactiveの依存関係を対応付けたものです。

RESTEasy Reactiveは、 org.jboss.resteasy.annotations パッケージの各種カスタムアノテーションには対応していません。

次の表は、従来のRESTEasyアノテーションと新しいRESTEasy Reactiveアノテーションを対応させたものです。

RESTEasy Reactiveは、RESTEasy Classicと同じ仕様に準拠した動作を提供しますが、実行時に正確に同じプロバイダの実装が含まれているわけではありません。

プロバイダーの違いによって動作が異なる可能性がある最も一般的なケースは、含まれる jakarta.ws.rs.ext.ExceptionMapper の実装です。アプリケーションに含まれるクラスを確認するには、開発モードでアプリケーションを起動し、 http://localhost:8080/q/dev-ui/io.quarkus.quarkus-resteasy-reactive/exception-mappers に移動します。

RESTEasy ReactiveのHTTP Multipartサポートは、RESTEasy Classicと同じ型やアノテーションを再利用 しない ため、ユーザーはリファレンスドキュメントの この 部分を読むことが推奨されます。

Quarkusでは、一般的なユースケースで簡単に使えるようにするために、Jakarta RESTメソッドのメディアタイプを決定する際にスマートデフォルトを使用しています。 quarkus-resteasy-reactive と quarkus-resteasy の違いは、メソッドが String を返すときに、 text/html の代わりに text/plain をデフォルトのメディアタイプとして使用することです。

次の表は、従来の REST Client の依存関係と、新しい Reactive REST Client の依存関係を対応付けたものです。

quarkus-rest-client を使用する場合、ユーザーは quarkus-keycloak-admin-client を使用して、RESTクライアントを活用してターゲットのKeycloakインスタンスを管理することができます。

一方、 quarkus-rest-client-reactive を使用する場合、ユーザーは同じ機能にアクセスするために quarkus-keycloak-admin-client-reactive を使用し、reactive REST Client を使用する必要があります。

quarkus-rest-client を使用する場合、ユーザーは quarkus-oidc-client-filter エクステンションを使用して、OpenID Connect および OAuth 2.0 準拠の Authorization Server からアクセストークンを取得し、更新することができます。

一方、 quarkus-rest-client-reactive を使用する場合、同じ機能を利用するためには、 quarkus-oidc-client-filter-reactive を使用する必要があります。

同様に、 quarkus-oidc-token-propagation は、従来の REST のユーザーが現在の Bearer または Authorization Code Flow のアクセストークンを伝搬することを可能にします。

一方、 quarkus-rest-client-reactive を使用する場合、同じ機能を利用するためには、 quarkus-oidc-token-propagation-reactive を使用する必要があります。

このセクションは、Jakarta RESTおよび/またはREST Client機能に依存するカスタムエクステンションを開発したユーザーだけが読む必要のある高度なセクションです。