Top For Removal Deprecated
Tomcat 10.1.19

Deprecated API


Terminally Deprecated Item Summary

SinceTerminally Deprecated Item and Description
Servlet 6.0

Returns:

always null
jakarta.servlet.SessionCookieConfig.getComment
()

This is no longer required with RFC 6265

Servlet 6.0
jakarta.servlet.SessionCookieConfig.setComment(String
Ignore
comment
)

This is no longer required with RFC 6265

Servlet 6.0

Returns:

always null
jakarta.servlet.http.Cookie.getComment
()

This is no longer required with RFC 6265

Servlet 6.0

Returns:

Always zero
jakarta.servlet.http.Cookie.getVersion
()

This is no longer required with RFC 6265

Servlet 6.0
jakarta.servlet.http.Cookie.setComment(String
ignored
purpose
)

This is no longer required with RFC 6265

Servlet 6.0
jakarta.servlet.http.Cookie.setVersion(int
Ignored
v
)

This is no longer required with RFC 6265

Servlet 6.0
jakarta.servlet.http.HttpServlet.LEGACY_DO_HEAD

May be removed in a future release

Tomcat 10.1.x
Tomcat 10.1.x
Tomcat 10.1.x
Tomcat 10.1.x
Tomcat 10.1.x

Deprecated Item Summary

SinceDeprecated Item and Description

Returns:

true if the resources archive lookup will use a bloom filter.
org.apache.catalina.Context.getUseBloomFilterForArchives
()

This method will be removed in Tomcat 11 onwards. Use WebResourceRoot#getArchiveIndexStrategy()

Returns:

the value of the parallel annotation scanning flag. If true, it will dispatch scanning to the utility executor.
org.apache.catalina.Context.isParallelAnnotationScanning
()

This method will be removed in Tomcat 11 onwards

org.apache.catalina.Context.setUseBloomFilterForArchives(boolean
The new fast class path scan flag
useBloomFilterForArchives
)

This method will be removed in Tomcat 11 onwards Use WebResourceRoot#setArchiveIndexStrategy(String)

Returns:

the associated principal, or null if there is none.
org.apache.catalina.Realm.authenticate
(String
Username of the Principal to look up
username
,
String
Digest which has been submitted by the client
digest
,
String
Unique (or supposedly unique) token which has been used for this request
nonce
,
String
the nonce counter
nc
,
String
the client chosen nonce
cnonce
,
String
the "quality of protection" (nc and cnonce will only be used, if qop is not null).
qop
,
String
Realm name
realm
,
String
Second digest calculated as digest(Method + ":" + uri)
digestA2
)

Unused. Use authenticate(String, String, String, String, String, String, String, String, String). Will be removed in Tomcat 11.

Returns:

the bytes count that has been read
org.apache.catalina.connector.Request.readPostBody
(byte[]
The bytes array in which the body will be read
body
,
int
The body length
len
)

Unused. Will be removed in Tomcat 11.0.x onwards. Use readPostBodyFully(byte[], int)

Returns:

false if the error flag was already set
org.apache.catalina.connector.Response.setError
()

This method will be changed to return void in Tomcat 11 onwards

org.apache.catalina.core.ApplicationRequest.isSpecial(String
Attribute name to be tested
name
)

Will be made private in Tomcat 11 onwards.

org.apache.catalina.core.ApplicationRequest.specials

Will be removed without replacement in Tomcat 11 onwards.

Returns:

Cumulative error count of all servlets in this StandardContext
org.apache.catalina.core.StandardContext.getErrorCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

Returns:

Cumulative request count of all servlets in this StandardContext
org.apache.catalina.core.StandardContext.getRequestCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

org.apache.catalina.core.StandardContext.setUseBloomFilterForArchives(boolean
The new fast class path scan flag
useBloomFilterForArchives
)

Returns:

the number of requests processed by the wrapper that resulted in an error.
org.apache.catalina.core.StandardWrapper.getErrorCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

Returns:

the number of requests processed by the wrapper.
org.apache.catalina.core.StandardWrapper.getRequestCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

Returns:

the number of requests processed by the associated wrapper that resulted in an error.
org.apache.catalina.core.StandardWrapperValve.getErrorCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

Returns:

the number of requests processed by the associated wrapper.
org.apache.catalina.core.StandardWrapperValve.getRequestCount
()

The return type will change to long in Tomcat 11 onwards. Callers of this method should switch to storing the result of calls to this method in a long value rather than an int.

Returns:

concatenated string
org.apache.catalina.filters.RemoteIpFilter.listToCommaDelimitedString
(List<String>
List of strings
stringList
)

Unused. Will be removed in Tomcat 11 onwards

org.apache.catalina.loader.WebappClassLoaderBase.securityManager

Deprecated as a consequence of SecurityManager being deprecated. See corresponding docs for further information.

org.apache.catalina.realm.GenericPrincipal(String
The username of the user represented by this Principal
name
,
String
Unused
password
,
List<String>
List of roles (must be Strings) possessed by this user
roles
)

This method will be removed in Tomcat 11 onwards

org.apache.catalina.realm.GenericPrincipal(String
The username of the user represented by this Principal
name
,
String
Unused
password
,
List<String>
List of roles (must be Strings) possessed by this user
roles
,
Principal
- the principal to be returned from the request getUserPrincipal call if not null; if null, this will be returned
userPrincipal
)

This method will be removed in Tomcat 11 onwards

org.apache.catalina.realm.GenericPrincipal(String
The username of the user represented by this Principal
name
,
String
Unused
password
,
List<String>
List of roles (must be Strings) possessed by this user
roles
,
Principal
- the principal to be returned from the request getUserPrincipal call if not null; if null, this will be returned
userPrincipal
,
LoginContext
- If provided, this will be used to log out the user at the appropriate time
loginContext
)

This method will be removed in Tomcat 11 onwards

org.apache.catalina.realm.GenericPrincipal(String
The username of the user represented by this Principal
name
,
String
Unused
password
,
List<String>
List of roles (must be Strings) possessed by this user
roles
,
Principal
- the principal to be returned from the request getUserPrincipal call if not null; if null, this will be returned
userPrincipal
,
LoginContext
- If provided, this will be used to log out the user at the appropriate time
loginContext
,
GSSCredential
- If provided, the user's delegated credentials
gssCredential
)

This method will be removed in Tomcat 11 onwards

org.apache.catalina.realm.RealmBase.authenticate(String
Username of the Principal to look up
username
,
String
Digest which has been submitted by the client
clientDigest
,
String
Unique (or supposedly unique) token which has been used for this request
nonce
,
String
the nonce counter
nc
,
String
the client chosen nonce
cnonce
,
String
the "quality of protection" (nc and cnonce will only be used, if qop is not null).
qop
,
String
Realm name
realm
,
String
Second digest calculated as digest(Method + ":" + uri)
digestA2
)

Returns:

the digest for the specified user
org.apache.catalina.realm.RealmBase.getDigest
(String
The user name
username
,
String
The realm name
realmName
)

Unused. Use getDigest(String, String, String). Will be removed in Tomcat 11.

org.apache.coyote.Request.setStartTime(long
time
startTime
)

This setter will be removed in Tomcat 11

Returns:

false if the error flag was already set
org.apache.coyote.Response.setError
()

This method will be changed to return void in Tomcat 11 onwards

Returns:

The current secret
org.apache.coyote.ajp.AbstractAjpProtocol.getRequiredSecret
()

Replaced by getSecret(). Will be removed in Tomcat 11 onwards

org.apache.coyote.ajp.AbstractAjpProtocol.setRequiredSecret(String
The required secret
requiredSecret
)

Replaced by setSecret(String). Will be removed in Tomcat 11 onwards

Returns:

true if Tomcat will allow such requests, otherwise false
org.apache.coyote.http11.AbstractHttp11Protocol.getAllowHostHeaderMismatch
()

This will removed in Tomcat 11 onwards where allowHostHeaderMismatch will be hard-coded to false.

Returns:

true if the request will be rejected or false if the header will be ignored
org.apache.coyote.http11.AbstractHttp11Protocol.getRejectIllegalHeader
()

This will removed in Tomcat 11 onwards where allowHostHeaderMismatch will be hard-coded to true.

org.apache.coyote.http11.AbstractHttp11Protocol.setAllowHostHeaderMismatch(boolean
true to allow such requests, false to reject them with a 400
allowHostHeaderMismatch
)

This will removed in Tomcat 11 onwards where allowHostHeaderMismatch will be hard-coded to false.

org.apache.coyote.http11.AbstractHttp11Protocol.setRejectIllegalHeader(boolean
true to reject requests with illegal header names or values, false to ignore the header
rejectIllegalHeader
)

This will removed in Tomcat 11 onwards where allowHostHeaderMismatch will be hard-coded to true.

org.apache.coyote.http2.Constants.DEFAULT_WEIGHT

Unused. Will be removed in Tomcat 11 onwards.

Returns:

true if a frame was read otherwise false
org.apache.coyote.http2.Http2Parser.readFrame
(boolean
Should this method block until a frame is available if no frame is available immediately?
block
)

Unused. Will be removed in Tomcat 11 onwards.

org.apache.coyote.http2.Http2UpgradeHandler.reprioritise(int
Unused
streamId
,
int
Unused
parentStreamId
,
boolean
Unused
exclusive
,
int
Unused
weight
)

Unused. Will be removed in Tomcat 11 onwards.

Returns:

trueif the pool does not need to reconnect
org.apache.tomcat.jdbc.pool.PooledConnection.checkUser
(String
The user name
username
,
String
The password
password
)

use shouldForceReconnect(String, String) method kept since it was public, to avoid changing interface.

Returns:

The result of converting the bytes to a String
org.apache.tomcat.util.buf.ByteChunk.toStringInternal
()

Unused. This method will be removed in Tomcat 11 onwards.

Returns:

the corresponding value
org.apache.tomcat.util.buf.StringCache.find
(ByteChunk
The name to find
name
)

Unused. Will be removed in Tomcat 11. Use find(ByteChunk, CodingErrorAction, CodingErrorAction)

org.apache.tomcat.util.http.Parameters.FailReason.REQUEST_BODY_INCOMPLETE

Unused. Will be removed in Tomcat 11.0.x onwards

Returns:

Always false
org.apache.tomcat.util.net.AbstractEndpoint.getDeferAccept
()

This code will be removed in Tomcat 11 onwards

org.apache.tomcat.util.security.MD5Encoder

Unused. Use HexUtils instead. Will be removed in Tomcat 11.

org.apache.tomcat.util.security.PrivilegedSetAccessControlContext.acc

Deprecated as a consequence of AccessControlContext being deprecated. See corresponding docs for further information.