1.5. 非推奨のコンポーネントおよび機能

Red Hat build of Quarkus 3.20 では、@ConfigRoot と @ConfigItem に基づくレガシー設定クラスは非推奨になりました。この非推奨化は、より一貫性がありタイプセーフな設定モデルを提供する @ConfigMapping フレームワークへの移行に備えるためのものです。

既存の設定クラスの互換性レイヤーはこのリリースでは引き続き利用可能ですが、今後のバージョンでは削除される予定です。

長期的な互換性を確保するために、開発者には、コードを更新して @ConfigMapping インターフェイスを使用することを推奨します。

詳細は、JIRA issue QDOCS-1150 を参照してください。

Red Hat build of Quarkus 3.20 では、quarkus.http.cors 設定プロパティーは非推奨になりました。Cross-Origin Resource Sharing (CORS) を有効にするには、代わりに quarkus.http.cors.enabled プロパティーを使用します。

詳細は、Cross-Origin Resource Sharing (CORS) ガイド を参照してください。

Red Hat build of Quarkus 3.20 では、quarkus.log.*.json 設定プロパティーが非推奨になりました。ロギングで JSON 形式を有効にするには、代わりに quarkus.log.*.json.enabled プロパティーを使用します。

この変更は、YAML 設定との互換性を向上させるために導入されました。以前の構造では、ルートキーに値を割り当てるために ~ などの特殊な構文を使用する必要がありました。そのため、設定で混乱やエラーが発生しやすくなっていました。

詳細は、Migration Guide 3.19 を参照してください。

Red Hat build of Quarkus 3.20 では、quarkus-smallrye-fault-tolerance エクステンションに SmallRye Fault Tolerance 6.7.0 が組み込まれています。これにより、互換性を失わせる変更点は導入されませんが、次の更新が導入されます。

詳細は、SmallRye Fault Tolerance 6.7.0 のリリース告知を参照してください。これには、プログラム API の移行ガイドへのリンクと、新しい設定プロパティーの詳細が記載されています。Quarkus ガイド SmallRye のフォールトトレランス には、これらの設定プロパティーの詳細なリファレンスが記載されています。

Red Hat build of Quarkus 3.20 では、Jakarta WebSocket 仕様を実装する quarkus-websockets および quarkus-websockets-client エクステンションが非推奨になりました。

Red Hat build of Quarkus は、今後のリリースでこれらのエクステンションのサポートを停止する予定です。

今後のバージョンとの互換性を確保するには、Quarkus WebSockets Next エクステンション (quarkus-websockets-next) に移行してください。このエクステンションは、より効率的な最新の WebSocket API を提供します。

詳細は、次の Quarkus リソースを参照してください。

この変更には手動による介入が必要です。これは、Red Hat build of Quarkus 3.20 へのアプリケーションの移行 ガイドで説明されている自動更新プロセスには含まれていません。