コンテンツ

目次

一般

Apache Tomcat® のバージョン間の移行またはアップグレードに適用される一般的な考慮事項については、最初に一般的な移行ガイドページをお読みください。

10.1.x から 11.0.x への移行

このセクションでは、10.1.x から 11.0.x へのアップグレード時に後方互換性の問題を引き起こす可能性のある、すべての既知の変更点をリストしています。

Java 21 が必要

Apache Tomcat 11.0.x には、Java 21 以降が必要です。 Apache Tomcat 10.1.x には Java 11 が必要でした。

SecurityManager は Java 17 以降で非推奨となり、SecurityManager の下で実行するためのサポートは Jakarta EE 11 仕様プロジェクトで削除されました。そのため、Tomcat 11.0.x では SecurityManager を設定するためのサポートが削除されました。

仕様 API

Apache Tomcat 11.0 は、Jakarta Servlet 6.1、Jakarta Server Pages 4.0、Jakarta Expression Language 6.0、Jakarta WebSocket 2.2、および Jakarta Authentication 3.1 の仕様をサポートしています。

Servlet 6.1 API

変更なし。

Server Pages 4.0

3.1 API で非推奨とマークされたすべてのメソッドとクラスが削除されました。

Expression Language 6.0

5.0 API で非推奨とマークされたすべてのメソッドとクラスが削除されました。

SecurityManager の下で実行するためのサポートが削除されました。

WebSocket TBD

SecurityManager の下で実行するためのサポートが削除されました。

認証 TBD

SecurityManager の下で実行するためのサポートが削除されました。

内部 API

Tomcat 11.0 の内部 API は Tomcat 10.1 と概ね互換性がありますが、詳細レベルでは多くの変更があり、バイナリ互換性はありません。 Tomcat の内部と対話するカスタムコンポーネントの開発者は、関連する API の JavaDoc を確認する必要があります。

特に注意が必要なのは

  • 10.1.x で非推奨とマークされたすべてのコードが削除されました。
  • バイトから文字への変換は、変換に失敗した場合に例外をスローするようになりました。

11.0.x のアップグレード

Apache Tomcat のインスタンスを Tomcat 11.0 のあるバージョンから別のバージョンにアップグレードする場合、特に $CATALINA_HOME と $CATALINA_BASE に separate な場所を使用している場合は、設定ファイルの変更（新しい属性やデフォルトの変更など）がアップグレードの一部として適用されていることを確認する必要があります。これらの変更の特定を支援するために、以下のフォームを使用して、Tomcat 11.0 の異なるバージョンの設定ファイル間の違いを表示できます。

Tomcat 11.0.x の注目すべき変更点

Tomcat 開発者は、各安定版パッチリリースが以前のリリースと完全に後方互換性を持つように努めています。バグを修正するために、後方互換性を損なう必要がある場合があります。ほとんどの場合、これらの変更は気付かれません。このセクションでは、完全に後方互換性がない変更と、アップグレード時に破損を引き起こす可能性のある変更をリストしています。

  • 11.0.0-M5 以降、コネクタ属性 maxParameterCount のデフォルト値が 10,000 から 1,000 に減りました。

Tomcat 11.0.x の設定ファイルの差異

以下のボックスから設定ファイル、古いバージョン、および新しいバージョンを選択し、「差分を表示」をクリックして差分を表示します。差分は新しいタブ/ウィンドウに表示されます。

注： 差分がない場合は、エラーページが表示されます。

作業コピー内から、次のような Git コマンドを使用することもできます

git diff 11.0.0-M1 11.0.0-M3 -- conf/