Author: markt
Date: Wed Dec 8 10:17:50 2021
New Revision: 1895691
URL: http://svn.apache.org/viewvc?rev=1895691&view=rev
Log:
Add some notable changes to the migration guide
Modified:
tomcat/site/trunk/docs/migration-10.1.html
tomcat/site/trunk/xdocs/migration-10.1.xml
Modified: tomcat/site/trunk/docs/migration-10.1.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/migration-10.1.html?rev=1895691&r1=1895690&r2=1895691&view=diff
==============================================================================
--- tomcat/site/trunk/docs/migration-10.1.html (original)
+++ tomcat/site/trunk/docs/migration-10.1.html Wed Dec 8 10:17:50 2021
@@ -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
10.0.x</title><meta name="author" content="Apache Tomcat
Project"></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/SupportApache-small.png"; class="support-asf"
alt="Support Apache"></a><a h
ref="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><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.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/downloa
d-80.cgi">Tomcat 8</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-10.1-doc/index.html">Tomcat 10.1 (alpha)</a></li><li><a
href="./tomcat-10.0-doc/index.html">Tomcat 10.0</a></li><li><a
href="./tomcat-9.0-doc/index.html">Tomcat 9.0</a></li><li><a
href="./tomcat-8.5-doc/index.html">Tomcat 8.5</a></li><li><a
href="./connectors-doc/">Tomcat Connectors</a></li><li><a
href="./native-doc/">Tomcat Native</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://bl
ogs.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://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.apache.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.0.x_to_10.1.x">Migrating from 10.0.x to
10.1.x</a><ol><li><a href="#Java_11_required">Java 11 required</a></li><li><a
href="#Specification_APIs">Specification APIs</a></li><li><a
href="#Servlet_TBD_API">Servlet TBD API</a></li><li><a
href="#Server_Pages_TBD">Server Pages TBD</a></li><li><a
href="#Expression_Language_TBD">Expression Language TBD</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_10.1.x">Upgrading 10.1.x</a><ol><li><a
href="#Tomcat_10.1.x_noteable_changes">Tomcat 10.1.x noteable
changes</a></li><li><a
href="#Tomcat_10.1.x_configuration_file_differences">Tomcat 10.1.x
configuration file differences</a></li></ol></li></ul>
+<ul><li><a href="#General">General</a></li><li><a
href="#Migrating_from_10.0.x_to_10.1.x">Migrating from 10.0.x to
10.1.x</a><ol><li><a href="#Java_11_required">Java 11 required</a></li><li><a
href="#Specification_APIs">Specification APIs</a></li><li><a
href="#Servlet_6.0_API">Servlet 6.0 API</a></li><li><a
href="#Server_Pages_3.1">Server Pages 3.1</a></li><li><a
href="#Expression_Language_5.0">Expression Language 5.0</a></li><li><a
href="#WebSocket_2.1">WebSocket 2.1</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_10.1.x">Upgrading 10.1.x</a><ol><li><a
href="#Tomcat_10.1.x_noteable_changes">Tomcat 10.1.x noteable
changes</a></li><li><a
href="#Tomcat_10.1.x_configuration_file_differences">Tomcat 10.1.x
configuration file differences</a></li></ol></li></ul>
</div><h3 id="General">General</h3><div class="text">
<p>Please read general <a href="migration.html">Migration Guide page</a> first,
@@ -22,27 +22,39 @@ of Apache Tomcat.</p>
<div class="subsection"><h4 id="Specification_APIs">Specification
APIs</h4><div class="text">
<p>Apache Tomcat 10.1 supports the Jakarta Servlet 6.0,
- Jakarta Server Pages TBD, Jakarta Expression Language TBD,
- JakartaWebSocket TBD and Jakarta Authentication TBD
+ Jakarta Server Pages 3.1, Jakarta Expression Language 5.0,
+ JakartaWebSocket 2.1 and Jakarta Authentication TBD
<a
href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications";>specifications</a>.
</p>
</div></div>
- <div class="subsection"><h4 id="Servlet_TBD_API">Servlet TBD API</h4><div
class="text">
-
+ <div class="subsection"><h4 id="Servlet_6.0_API">Servlet 6.0 API</h4><div
class="text">
+
+ <p>All methods and classes marked as deprecated in the 5.0 API have been
+ removed.</p>
+
+ <p>Support for Cookie specifications other than RFC 6265 has been removed
+ and a number of methods deprecated as a result.</p>
+
<p>A new method, <code>Cookie.setAttribute(String name, String
value)</code>
has been added.</p>
+ <p>The process for decoding and normalizing URIs has been clarified.</p>
+
+ <p>New methods and classes have been added to provide access to unique
+ identifiers for the current request and/or associated connection.</p>
+
</div></div>
- <div class="subsection"><h4 id="Server_Pages_TBD">Server Pages TBD</h4><div
class="text">
-
- <p>No changes.</p>
+ <div class="subsection"><h4 id="Server_Pages_3.1">Server Pages 3.1</h4><div
class="text">
+
+ <p>Added an option to raise a <code>PropertyNotFoundException</code> when
an
+ EL expression contains an unknown identifier.</p>
</div></div>
- <div class="subsection"><h4 id="Expression_Language_TBD">Expression Language
TBD</h4><div class="text">
+ <div class="subsection"><h4 id="Expression_Language_5.0">Expression Language
5.0</h4><div class="text">
<p>The EL API now uses generics where appropriate.</p>
@@ -51,9 +63,10 @@ of Apache Tomcat.</p>
</div></div>
- <div class="subsection"><h4 id="WebSocket_TBD">WebSocket TBD</h4><div
class="text">
+ <div class="subsection"><h4 id="WebSocket_2.1">WebSocket 2.1</h4><div
class="text">
- <p>No changes.</p>
+ <p>The packaging of the API JARs has changed to remove duplicate classes.
+ The server API now has a dependency on the client API JAR.</p>
</div></div>
Modified: tomcat/site/trunk/xdocs/migration-10.1.xml
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/migration-10.1.xml?rev=1895691&r1=1895690&r2=1895691&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/migration-10.1.xml (original)
+++ tomcat/site/trunk/xdocs/migration-10.1.xml Wed Dec 8 10:17:50 2021
@@ -35,27 +35,39 @@ of Apache Tomcat.</p>
<subsection name="Specification APIs">
<p>Apache Tomcat 10.1 supports the Jakarta Servlet 6.0,
- Jakarta Server Pages TBD, Jakarta Expression Language TBD,
- JakartaWebSocket TBD and Jakarta Authentication TBD
+ Jakarta Server Pages 3.1, Jakarta Expression Language 5.0,
+ JakartaWebSocket 2.1 and Jakarta Authentication TBD
<a
href="https://cwiki.apache.org/confluence/display/TOMCAT/Specifications";>specifications</a>.
</p>
</subsection>
- <subsection name="Servlet TBD API">
-
+ <subsection name="Servlet 6.0 API">
+
+ <p>All methods and classes marked as deprecated in the 5.0 API have been
+ removed.</p>
+
+ <p>Support for Cookie specifications other than RFC 6265 has been removed
+ and a number of methods deprecated as a result.</p>
+
<p>A new method, <code>Cookie.setAttribute(String name, String
value)</code>
has been added.</p>
+ <p>The process for decoding and normalizing URIs has been clarified.</p>
+
+ <p>New methods and classes have been added to provide access to unique
+ identifiers for the current request and/or associated connection.</p>
+
</subsection>
- <subsection name="Server Pages TBD">
-
- <p>No changes.</p>
+ <subsection name="Server Pages 3.1">
+
+ <p>Added an option to raise a <code>PropertyNotFoundException</code> when
an
+ EL expression contains an unknown identifier.</p>
</subsection>
- <subsection name="Expression Language TBD">
+ <subsection name="Expression Language 5.0">
<p>The EL API now uses generics where appropriate.</p>
@@ -64,9 +76,10 @@ of Apache Tomcat.</p>
</subsection>
- <subsection name="WebSocket TBD">
+ <subsection name="WebSocket 2.1">
- <p>No changes.</p>
+ <p>The packaging of the API JARs has changed to remove duplicate classes.
+ The server API now has a dependency on the client API JAR.</p>
</subsection>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
![https://www.apache.org/images/SupportApache-small.png"](https://www.apache.org/images/SupportApache-small.png"){kind=link}