Author: markt
Date: Tue Aug 13 10:50:14 2024
New Revision: 1919848
URL: http://svn.apache.org/viewvc?rev=1919848&view=rev
Log:
Update 11.0.x migration guide
Modified:
tomcat/site/trunk/docs/migration-11.0.html
tomcat/site/trunk/xdocs/migration-11.0.xml
Modified: tomcat/site/trunk/docs/migration-11.0.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration-11.0.html?rev=1919848&r1=1919847&r2=1919848&view=diff
==============================================================================
--- tomcat/site/trunk/docs/migration-11.0.html (original)
+++ tomcat/site/trunk/docs/migration-11.0.html Tue Aug 13 10:50:14 2024
@@ -1,6 +1,6 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="en"><head><META http-equiv="Content-Type" content="text/html;
charset=UTF-8"><meta name="viewport" content="width=device-width,
initial-scale=1"><link href="res/css/tomcat.css" rel="stylesheet"
type="text/css"><link href="res/css/fonts/fonts.css" rel="stylesheet"
type="text/css"><title>Apache Tomcat® - Migration Guide - Tomcat
11.0.x</title><meta name="author" content="Apache Tomcat Project"><script
src="https://www.apachecon.com/event-images/snippet.js";></script></head><body><div
id="wrapper"><header id="header"><div class="clearfix"><div
class="menu-toggler pull-left" tabindex="1"><div
class="hamburger"></div></div><a href="http://tomcat.apache.org/";><img
class="tomcat-logo pull-left noPrint" alt="Tomcat Home"
src="res/images/tomcat.png"></a><h1 class="pull-left">Apache
Tomcat<sup>®</sup></h1><div class="asf-logos pull-right"><a
href="https://www.apache.org/foundation/contributing.html"; target="_blank"
class="pull-left"><img src="https://www.apache.org/images/S
upportApache-small.png" class="support-asf" alt="Support Apache"></a><a
href="http://www.apache.org/"; target="_blank" class="pull-left"><img
src="res/images/asf_logo.svg" class="asf-logo" alt="The Apache Software
Foundation"></a></div></div></header><main id="middle"><div><div
id="mainLeft"><div id="nav-wrapper"><form
action="https://www.google.com/search"; method="get"><div
class="searchbox"><input value="tomcat.apache.org" name="sitesearch"
type="hidden"><input aria-label="Search text" placeholder="Search…"
required="required" name="q" id="query"
type="search"><button>GO</button></div></form><div class="asfevents"><a
class="acevent" data-format="square"
data-width="150"></a></div><nav><div><h2>Apache Tomcat</h2><ul><li><a
href="./index.html">Home</a></li><li><a
href="./taglibs.html">Taglibs</a></li><li><a href="./maven-plugin.html">Maven
Plugin</a></li></ul></div><div><h2>Download</h2><ul><li><a
href="./whichversion.html">Which version?</a></li><li><a href="https://tomcat.ap
ache.org/download-11.cgi">Tomcat 11 (beta)</a></li><li><a
href="https://tomcat.apache.org/download-10.cgi";>Tomcat 10</a></li><li><a
href="https://tomcat.apache.org/download-90.cgi";>Tomcat 9</a></li><li><a
href="https://tomcat.apache.org/download-migration.cgi";>Tomcat Migration Tool
for Jakarta EE</a></li><li><a
href="https://tomcat.apache.org/download-connectors.cgi";>Tomcat
Connectors</a></li><li><a
href="https://tomcat.apache.org/download-native.cgi";>Tomcat
Native</a></li><li><a
href="https://tomcat.apache.org/download-taglibs.cgi";>Taglibs</a></li><li><a
href="https://archive.apache.org/dist/tomcat/";>Archives</a></li></ul></div><div><h2>Documentation</h2><ul><li><a
href="./tomcat-11.0-doc/index.html">Tomcat 11.0 (beta)</a></li><li><a
href="./tomcat-10.1-doc/index.html">Tomcat 10.1</a></li><li><a
href="./tomcat-9.0-doc/index.html">Tomcat 9.0</a></li><li><a
href="./upgrading.html">Upgrading</a></li><li><a
href="./connectors-doc/index.html">Tomcat Connectors</a></li><li><a href="./nat
ive-doc/index.html">Tomcat Native 2</a></li><li><a
href="./native-1.3-doc/index.html">Tomcat Native 1.3</a></li><li><a
href="https://cwiki.apache.org/confluence/display/TOMCAT";>Wiki</a></li><li><a
href="./migration.html">Migration Guide</a></li><li><a
href="./presentations.html">Presentations</a></li><li><a
href="https://cwiki.apache.org/confluence/x/Bi8lBg";>Specifications</a></li></ul></div><div><h2>Problems?</h2><ul><li><a
href="./security.html">Security Reports</a></li><li><a
href="./findhelp.html">Find help</a></li><li><a
href="https://cwiki.apache.org/confluence/display/TOMCAT/FAQ";>FAQ</a></li><li><a
href="./lists.html">Mailing Lists</a></li><li><a href="./bugreport.html">Bug
Database</a></li><li><a href="./irc.html">IRC</a></li></ul></div><div><h2>Get
Involved</h2><ul><li><a href="./getinvolved.html">Overview</a></li><li><a
href="./source.html">Source code</a></li><li><a
href="./ci.html">Buildbot</a></li><li><a
href="https://cwiki.apache.org/confluence/x/vIPzBQ";>Translations</
a></li><li><a
href="./tools.html">Tools</a></li></ul></div><div><h2>Media</h2><ul><li><a
href="https://twitter.com/theapachetomcat";>Twitter</a></li><li><a
href="https://www.youtube.com/c/ApacheTomcatOfficial";>YouTube</a></li><li><a
href="https://blogs.apache.org/tomcat/";>Blog</a></li></ul></div><div><h2>Misc</h2><ul><li><a
href="./whoweare.html">Who We Are</a></li><li><a
href="https://www.redbubble.com/people/comdev/works/30885254-apache-tomcat";>Swag</a></li><li><a
href="./heritage.html">Heritage</a></li><li><a
href="http://www.apache.org";>Apache Home</a></li><li><a
href="./resources.html">Resources</a></li><li><a
href="./contact.html">Contact</a></li><li><a
href="./legal.html">Legal</a></li><li><a
href="https://privacy.apache.org/policies/privacy-policy-public.html";>Privacy</a></li><li><a
href="https://www.apache.org/foundation/contributing.html";>Support
Apache</a></li><li><a
href="https://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li><li><a
href="http://www.apach
e.org/foundation/thanks.html">Thanks</a></li><li><a
href="http://www.apache.org/licenses/";>License</a></li></ul></div></nav></div></div><div
id="mainRight"><div id="content"><h2 style="display: none;">Content</h2><h3
id="Table_of_Contents">Table of Contents</h3><div class="text">
-<ul><li><a href="#General">General</a></li><li><a
href="#Migrating_from_10.1.x_to_11.0.x">Migrating from 10.1.x to
11.0.x</a><ol><li><a href="#Java_21_required">Java 21 required</a></li><li><a
href="#Specification_APIs">Specification APIs</a></li><li><a
href="#Servlet_6.1_API">Servlet 6.1 API</a></li><li><a href="#Pages_4.0">Pages
4.0</a></li><li><a href="#Expression_Language_6.0">Expression Language
6.0</a></li><li><a href="#WebSocket_TBD">WebSocket TBD</a></li><li><a
href="#Authentication_TBD">Authentication TBD</a></li><li><a
href="#Internal_APIs">Internal APIs</a></li></ol></li><li><a
href="#Upgrading_11.0.x">Upgrading 11.0.x</a><ol><li><a
href="#Tomcat_11.0.x_noteable_changes">Tomcat 11.0.x noteable
changes</a></li><li><a
href="#Tomcat_11.0.x_configuration_file_differences">Tomcat 11.0.x
configuration file differences</a></li></ol></li></ul>
+<ul><li><a href="#General">General</a></li><li><a
href="#Migrating_from_10.1.x_to_11.0.x">Migrating from 10.1.x to
11.0.x</a><ol><li><a href="#Java_17_required">Java 17 required</a></li><li><a
href="#Specification_APIs">Specification APIs</a></li><li><a
href="#Servlet_6.1_API">Servlet 6.1 API</a></li><li><a href="#Pages_4.0">Pages
4.0</a></li><li><a href="#Expression_Language_6.0">Expression Language
6.0</a></li><li><a href="#WebSocket_2.2">WebSocket 2.2</a></li><li><a
href="#Authentication_3.1">Authentication 3.1</a></li><li><a
href="#Annotations_3.0">Annotations 3.0</a></li><li><a
href="#Internal_APIs">Internal APIs</a></li></ol></li><li><a
href="#Upgrading_11.0.x">Upgrading 11.0.x</a><ol><li><a
href="#Tomcat_11.0.x_noteable_changes">Tomcat 11.0.x noteable
changes</a></li><li><a
href="#Tomcat_11.0.x_configuration_file_differences">Tomcat 11.0.x
configuration file differences</a></li></ol></li></ul>
</div><h3 id="General">General</h3><div class="text">
<p>Please read the general <a href="migration.html">Migration Guide page</a>
@@ -12,9 +12,9 @@ versions of Apache Tomcat<sup>®</sup
<p>This section lists all the known changes between 10.1.x and 11.0.x
which may cause backwards compatibility problems when upgrading.</p>
- <div class="subsection"><h4 id="Java_21_required">Java 21 required</h4><div
class="text">
+ <div class="subsection"><h4 id="Java_17_required">Java 17 required</h4><div
class="text">
- <p>Apache Tomcat 11.0.x requires Java 21 or later. Apache Tomcat 10.1.x
+ <p>Apache Tomcat 11.0.x requires Java 17 or later. Apache Tomcat 10.1.x
required Java 11.</p>
<p>The <code>SecurityManager</code> has been deprecated in Java 17 onwards
@@ -26,9 +26,9 @@ versions of Apache Tomcat<sup>®</sup
<div class="subsection"><h4 id="Specification_APIs">Specification
APIs</h4><div class="text">
- <p>Apache Tomcat 11.0 supports the Jakarta Servlet 6.1,
- Jakarta Pages 4.0, Jakarta Expression Language 6.0,
- JakartaWebSocket 2.2 and Jakarta Authentication 3.1
+ <p>Apache Tomcat 11.0 supports the Jakarta Servlet 6.1, Jakarta Pages 4.0,
+ Jakarta Expression Language 6.0, JakartaWebSocket 2.2,
+ Jakarta Authentication 3.1 and Jakarta Annotations 3.0
<a
href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications";>specifications</a>.
</p>
@@ -36,8 +36,25 @@ versions of Apache Tomcat<sup>®</sup
<div class="subsection"><h4 id="Servlet_6.1_API">Servlet 6.1 API</h4><div
class="text">
- <p>No changes.</p>
-
+ <p>The expected behaviour for adding and setting HTTP headers with
+ <code>null</code> or the empty string has been clarified.</p>
+
+ <p>The meaning of "write operation" in the context of the Javadoc for
+ <code>ServletOutputStream.isReady()</code> has been clarified.</p>
+
+ <p><code>ServletRequest.getParameter()</code> and the other parameter
+ methods are now documented to throw a runtime exception if the call
triggers
+ parsing of the parameters and an error is encountered during that
+ parsing.</p>
+
+ <p>Support for HTTP/2 sever push is now optional and has been removed from
+ Tomcat.</p>
+
+ <p>Clarify the behaviour of <code>Cookie.setAttribute(String,String)</code>
+ and <code>Cookie.getAttribute(String)</code> with cookie attributes such as
+ <code>HttpOnly</code>, <code>Secure</code> and <code>Partitioned</code>
that
+ do not have a value.</p>
+
</div></div>
<div class="subsection"><h4 id="Pages_4.0">Pages 4.0</h4><div class="text">
@@ -57,20 +74,26 @@ versions of Apache Tomcat<sup>®</sup
</div></div>
- <div class="subsection"><h4 id="WebSocket_TBD">WebSocket TBD</h4><div
class="text">
+ <div class="subsection"><h4 id="WebSocket_2.2">WebSocket 2.2</h4><div
class="text">
<p>Support for running under a <code>SecurityManager</code> has been
removed.</p>
</div></div>
- <div class="subsection"><h4 id="Authentication_TBD">Authentication
TBD</h4><div class="text">
+ <div class="subsection"><h4 id="Authentication_3.1">Authentication
3.1</h4><div class="text">
<p>Support for running under a <code>SecurityManager</code> has been
removed.</p>
</div></div>
+ <div class="subsection"><h4 id="Annotations_3.0">Annotations 3.0</h4><div
class="text">
+
+ <p>None.</p>
+
+ </div></div>
+
<div class="subsection"><h4 id="Internal_APIs">Internal APIs</h4><div
class="text">
<p>Whilst the Tomcat 11.0 internal API is broadly compatible with Tomcat
10.1
@@ -83,6 +106,11 @@ versions of Apache Tomcat<sup>®</sup
<li>All code marked as deprecated in 10.1.x has been removed.</li>
<li>Conversions from bytes to characters now throw an exception if the
conversion fails.</li>
+ <li>Support for using the ^ character to separate the WAR file and WAR
+ contents in Tomcat's custom WAR URL handler has been removed. The
+ current default separator character of * remains unchanged.</li>
+ <li>Cookie parsing and handling now treats the quotes in a quoted cookie
+ value as part of the value as required by RFC 6265.</li>
</ul>
</div></div>
Modified: tomcat/site/trunk/xdocs/migration-11.0.xml
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/migration-11.0.xml?rev=1919848&r1=1919847&r2=1919848&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/migration-11.0.xml (original)
+++ tomcat/site/trunk/xdocs/migration-11.0.xml Tue Aug 13 10:50:14 2024
@@ -25,9 +25,9 @@ versions of Apache Tomcat<sup>®</su
<p>This section lists all the known changes between 10.1.x and 11.0.x
which may cause backwards compatibility problems when upgrading.</p>
- <subsection name="Java 21 required">
+ <subsection name="Java 17 required">
- <p>Apache Tomcat 11.0.x requires Java 21 or later. Apache Tomcat 10.1.x
+ <p>Apache Tomcat 11.0.x requires Java 17 or later. Apache Tomcat 10.1.x
required Java 11.</p>
<p>The <code>SecurityManager</code> has been deprecated in Java 17 onwards
@@ -39,9 +39,9 @@ versions of Apache Tomcat<sup>®</su
<subsection name="Specification APIs">
- <p>Apache Tomcat 11.0 supports the Jakarta Servlet 6.1,
- Jakarta Pages 4.0, Jakarta Expression Language 6.0,
- JakartaWebSocket 2.2 and Jakarta Authentication 3.1
+ <p>Apache Tomcat 11.0 supports the Jakarta Servlet 6.1, Jakarta Pages 4.0,
+ Jakarta Expression Language 6.0, JakartaWebSocket 2.2,
+ Jakarta Authentication 3.1 and Jakarta Annotations 3.0
<a
href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications";>specifications</a>.
</p>
@@ -49,8 +49,25 @@ versions of Apache Tomcat<sup>®</su
<subsection name="Servlet 6.1 API">
- <p>No changes.</p>
-
+ <p>The expected behaviour for adding and setting HTTP headers with
+ <code>null</code> or the empty string has been clarified.</p>
+
+ <p>The meaning of "write operation" in the context of the Javadoc for
+ <code>ServletOutputStream.isReady()</code> has been clarified.</p>
+
+ <p><code>ServletRequest.getParameter()</code> and the other parameter
+ methods are now documented to throw a runtime exception if the call
triggers
+ parsing of the parameters and an error is encountered during that
+ parsing.</p>
+
+ <p>Support for HTTP/2 sever push is now optional and has been removed from
+ Tomcat.</p>
+
+ <p>Clarify the behaviour of <code>Cookie.setAttribute(String,String)</code>
+ and <code>Cookie.getAttribute(String)</code> with cookie attributes such as
+ <code>HttpOnly</code>, <code>Secure</code> and <code>Partitioned</code>
that
+ do not have a value.</p>
+
</subsection>
<subsection name="Pages 4.0">
@@ -70,20 +87,26 @@ versions of Apache Tomcat<sup>®</su
</subsection>
- <subsection name="WebSocket TBD">
+ <subsection name="WebSocket 2.2">
<p>Support for running under a <code>SecurityManager</code> has been
removed.</p>
</subsection>
- <subsection name="Authentication TBD">
+ <subsection name="Authentication 3.1">
<p>Support for running under a <code>SecurityManager</code> has been
removed.</p>
</subsection>
+ <subsection name="Annotations 3.0">
+
+ <p>None.</p>
+
+ </subsection>
+
<subsection name="Internal APIs">
<p>Whilst the Tomcat 11.0 internal API is broadly compatible with Tomcat
10.1
@@ -96,6 +119,11 @@ versions of Apache Tomcat<sup>®</su
<li>All code marked as deprecated in 10.1.x has been removed.</li>
<li>Conversions from bytes to characters now throw an exception if the
conversion fails.</li>
+ <li>Support for using the ^ character to separate the WAR file and WAR
+ contents in Tomcat's custom WAR URL handler has been removed. The
+ current default separator character of * remains unchanged.</li>
+ <li>Cookie parsing and handling now treats the quotes in a quoted cookie
+ value as part of the value as required by RFC 6265.</li>
</ul>
</subsection>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
