# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

- Deprecated Interfaces
  Interface and Description
  org.apache.tomcat.util.codec.BinaryDecoder This interface is unused and will be removed in Tomcat 9
  org.apache.tomcat.util.codec.BinaryEncoder This interface is unused and will be removed in Tomcat 9
  org.apache.tomcat.util.codec.Decoder This interface is unused and will be removed in Tomcat 9
  org.apache.tomcat.util.digester.DocumentProperties.Encoding This method will be removed in Tomcat 9
  org.apache.tomcat.util.codec.Encoder This interface is unused and will be removed in Tomcat 9
  org.apache.catalina.GSSRealm This will be removed in Tomcat 9 and integrated into `Realm`.

- Deprecated Classes
  Class and Description
  org.apache.coyote.ajp.AjpProtocol This class will be removed in Tomcat 9.
  org.apache.jasper.xmlparser.ASCIIReader Will be removed in Tomcat 9.0.x onwards
  org.apache.catalina.util.ConcurrentDateFormat Unused. This will be removed in Tomcat 10. Use `ConcurrentDateFormat`
  org.apache.catalina.realm.Constants Unused. Will be removed in Tomcat 9
  org.apache.naming.Constants Unused. Will be removed in Tomcat 9.
  org.apache.tomcat.util.digester.Digester.EnvironmentPropertySource Use `EnvironmentPropertySource` This will be removed in Tomcat 10 onwards.
  org.apache.jasper.el.ELResolverImpl
  org.apache.jasper.xmlparser.EncodingMap Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.el.ExpressionEvaluatorImpl
  org.apache.jasper.el.ExpressionImpl
  org.apache.jasper.el.FunctionMapperImpl
  org.apache.coyote.http11.Http11Protocol This class will be removed in Tomcat 9.
  org.apache.catalina.realm.JDBCRealm Will be removed in Tomcat 10 onwards. Use the DataSourceRealm instead.
  org.apache.catalina.session.JDBCStore Removed in Tomcat 10 and replaced by DataSourceStore with removal of legacy JDBC code
  org.apache.catalina.mbeans.JmxRemoteLifecycleListener The features provided by this listener are now available in the remote JMX capability included with the JRE. This listener will be removed in Tomcat 10 and may be removed from Tomcat 8.5.x some time after 2020-12-31.
  org.apache.catalina.util.MIME2Java Unused. Will be removed in Tomcat 9.
  org.apache.tomcat.dbcp.dbcp2.cpdsadapter.PStmtKeyCPDS Use `PStmtKey`.
  org.apache.tomcat.util.digester.RuleSetBase Unnecessary once deprecated methods are removed. Will be removed in Tomcat 9.
  org.apache.jasper.xmlparser.SymbolTable Will be removed in Tomcat 9.0.x onwards
  org.apache.catalina.util.SystemPropertyReplacerListener No longer used. Will be removed in Tomcat 9.
  org.apache.tomcat.util.compat.TLS Unused. This will be removed in Tomcat 10.
  org.apache.jasper.xmlparser.UCSReader Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.xmlparser.UTF8Reader Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.el.VariableResolverImpl
  org.apache.tomcat.util.http.parser.Vary Use `TokenList`.
  org.apache.jasper.xmlparser.XMLChar Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.xmlparser.XMLEncodingDetector Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.xmlparser.XMLString Will be removed in Tomcat 9.0.x onwards
  org.apache.jasper.xmlparser.XMLStringBuffer Will be removed in Tomcat 9.0.x onwards

- Deprecated Exceptions
  Exceptions and Description
  org.apache.tomcat.util.codec.DecoderException This exception is unused and will be removed in Tomcat 9
  org.apache.tomcat.util.codec.EncoderException This exception is unused and will be removed in Tomcat 9

- Deprecated Fields
  Field and Description
  org.apache.coyote.http11.Constants.ACK_BYTES_REASON This option will be removed in Tomcat 9. Reason phrase will not be sent.
  org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH
  org.apache.catalina.loader.WebappClassLoaderBase.allPermission Unused. This will be removed in Tomcat 9.
  org.apache.catalina.util.DOMWriter.canonical Will be made private in Tomcat 9.
  org.apache.coyote.http11.Constants.CLOSE_BYTES Unused. Will be removed in Tomcat 10.
  org.apache.catalina.mapper.MappingData.contextPath Unused. This will be removed in Tomcat 10.
  org.apache.coyote.Constants.DEFAULT_CHARACTER_ENCODING This will be removed in Tomcat 9.0.x onwards.
  org.apache.tomcat.util.http.Parameters.DEFAULT_ENCODING This will be removed in Tomcat 9.0.x
  org.apache.catalina.tribes.membership.MemberImpl.DO_DNS_LOOKUPS This will be removed without replacement in Tomact 10 onwards
  org.apache.catalina.authenticator.Constants.FORM_PRINCIPAL_NOTE Unused. Will be removed in Tomcat 10.
  org.apache.catalina.connector.Response.format Unused. This will be removed in Tomcat 10
  org.apache.catalina.connector.Request.formats Unused. This will be removed in Tomcat 10
  org.apache.catalina.connector.Request.GMT_ZONE Unused. This will be removed in Tomcat 10.
  org.apache.coyote.http11.Constants.KEEPALIVE Unused. Will be removed in Tomcat 10.
  org.apache.coyote.http11.Constants.KEEPALIVE_BYTES Unused. Will be removed in Tomcat 10.
  org.apache.catalina.ha.session.DeltaManager.managerName Unused. Will be removed in Tomcat 9
  org.apache.catalina.realm.UserDatabaseRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.MemoryRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.JNDIRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.JDBCRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.JAASRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.DataSourceRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.catalina.realm.CombinedRealm.name This will be removed in Tomcat 9 onwards.
  org.apache.tomcat.util.digester.RuleSetBase.namespaceURI Unused. This will be removed in Tomcat 9.
  org.apache.tomcat.util.digester.RulesBase.namespaceURI Unused. Will be removed in Tomcat 9.0.x
  org.apache.catalina.util.DOMWriter.out Will be made private in Tomcat 9.
  org.apache.tomcat.util.digester.CallMethodRule.paramClassNames Unused. This will be removed in Tomcat 9.
  org.apache.catalina.filters.CorsFilter.REQUEST_HEADER_VARY Unused. Will be removed in Tomcat 10
  org.apache.catalina.servlets.DefaultServlet.RESOURCES_JNDI_NAME Unused. Will be removed in Tomcat 9.
  org.apache.tomcat.util.http.FastHttpDateFormat.RFC1123_DATE Unused. This will be removed in Tomcat 10.
  org.apache.catalina.session.StandardSession.sessionContext
  org.apache.catalina.Globals.SSI_FLAG_ATTR Unused. This is no longer used as the CGIO servlet now has generic handling for when it is used as an include. This will be removed in Tomcat 10
  org.apache.tomcat.jni.SSL.SSL_OP_PKCS1_CHECK_1 Unsupported in the current version of OpenSSL
  org.apache.tomcat.jni.SSL.SSL_OP_PKCS1_CHECK_2 Unsupported in the current version of OpenSSL
  org.apache.catalina.connector.Connector.URIEncoding This will be removed in 9.0.x onwards
  org.apache.catalina.connector.Connector.URIEncodingLower This will be removed in 9.0.x onwards
  org.apache.coyote.Constants.USE_CUSTOM_STATUS_MSG_IN_HEADER This option will be removed in Tomcat 9. Reason phrase will not be sent.
  org.apache.catalina.authenticator.Constants.USE_SUBJECT_CREDS_ONLY_PROPERTY Unused. Will be removed in Tomcat 9.

- Deprecated Methods
  Method and Description
  org.apache.coyote.AbstractProcessor.ack() Unused. This will be removed in Tomcat 10 onwards. Use `AbstractProcessor.ack(ContinueResponseTiming)`.
  org.apache.catalina.Context.addServletMapping(String, String) Will be removed in Tomcat 9. Use `Context.addServletMappingDecoded(String, String)`
  org.apache.catalina.core.StandardContext.addServletMapping(String, String)
  org.apache.catalina.Context.addServletMapping(String, String, boolean) Will be removed in Tomcat 9. Use `Context.addServletMappingDecoded(String, String, boolean)`
  org.apache.catalina.core.StandardContext.addServletMapping(String, String, boolean)
  org.apache.jasper.compiler.SmapGenerator.addSmap(String, String) Unused. This will be removed in Tomcat 9.0.x
  org.apache.jasper.compiler.SmapGenerator.addStratum(SmapStratum, boolean) Use `SmapGenerator.setStratum(SmapStratum)`
  org.apache.catalina.startup.Tomcat.addWebapp(Host, String, String, ContextConfig) Use `Tomcat.addWebapp(Host, String, String, LifecycleListener)` instead
  org.apache.tomcat.util.net.SocketWrapperBase.awaitReadComplete(long, TimeUnit)
  org.apache.tomcat.util.net.SocketWrapperBase.awaitWriteComplete(long, TimeUnit)
  org.apache.tomcat.jdbc.pool.PooledConnection.checkUser(String, String) use `PooledConnection.shouldForceReconnect(String, String)` method kept since it was public, to avoid changing interface.
  org.apache.catalina.core.NamingContextListener.containerEvent(ContainerEvent) The `ContainerListener` interface and implementing methods will be removed from this class for Tomcat 10 onwards.
  org.apache.tomcat.util.buf.UDecoder.convert(CharChunk, boolean) Unused. Will be removed in Tomcat 10
  org.apache.tomcat.util.buf.UDecoder.convert(MessageBytes, boolean) Unused. Will be removed in Tomcat 10
  org.apache.tomcat.util.buf.UDecoder.convert(String, boolean) Unused. Will be removed in Tomcat 10
  org.apache.catalina.storeconfig.StoreAppender.convertStr(String) This method will be removed in Tomcat 9
  org.apache.catalina.servlets.DefaultServlet.copy(WebResource, InputStream, PrintWriter, String) Unused. This will be removed in Tomcat 9. Use `DefaultServlet.copy(InputStream, PrintWriter, String)`
  org.apache.catalina.servlets.DefaultServlet.copy(WebResource, InputStream, ServletOutputStream) Unused. This will be removed in Tomcat 9. Use `DefaultServlet.copy(InputStream, ServletOutputStream)`
  org.apache.catalina.mbeans.MBeanFactory.createJDBCRealm(String, String, String, String, String) This method will be removed in Tomcat 10. Use a DataSourceRealm instead.
  org.apache.tomcat.util.codec.binary.BaseNCodec.decode(Object) This unused method will be removed in Tomcat 9
  org.apache.catalina.ha.session.DeltaManager.deserializeDeltaRequest(DeltaSession, byte[]) Unused. This will be removed in Tomcat 10. Calling this method may result in a deadlock. See: https://bz.apache.org/bugzilla/show_bug.cgi?id=62841
  org.apache.catalina.realm.RealmBase.Digest(String, String, String) Unused. This will be removed in Tomcat 9.
  org.apache.coyote.http2.Stream.doNotifyAll()
  org.apache.coyote.http2.Http2UpgradeHandler.doNotifyAll()
  org.apache.coyote.Request.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `Request.doRead(ApplicationBufferHandler)`
  org.apache.coyote.InputBuffer.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `InputBuffer.doRead(ApplicationBufferHandler)`
  org.apache.coyote.ajp.AjpProcessor.SocketInputBuffer.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `AjpProcessor.SocketInputBuffer.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.Http11InputBuffer.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `Http11InputBuffer.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.filters.VoidInputFilter.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `VoidInputFilter.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.filters.SavedRequestInputFilter.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `SavedRequestInputFilter.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.filters.IdentityInputFilter.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `IdentityInputFilter.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.filters.ChunkedInputFilter.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `ChunkedInputFilter.doRead(ApplicationBufferHandler)`
  org.apache.coyote.http11.filters.BufferedInputFilter.doRead(ByteChunk) Unused. Will be removed in Tomcat 9. Use `BufferedInputFilter.doRead(ApplicationBufferHandler)`
  org.apache.coyote.Response.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `Response.doWrite(ByteBuffer)`
  org.apache.coyote.OutputBuffer.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `OutputBuffer.doWrite(ByteBuffer)`
  org.apache.coyote.ajp.AjpProcessor.SocketOutputBuffer.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `AjpProcessor.SocketOutputBuffer.doWrite(ByteBuffer)`
  org.apache.coyote.http11.Http11OutputBuffer.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `Http11OutputBuffer.doWrite(ByteBuffer)`
  org.apache.coyote.http11.Http11OutputBuffer.SocketOutputBuffer.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `Http11OutputBuffer.SocketOutputBuffer.doWrite(ByteBuffer)`
  org.apache.coyote.http11.filters.VoidOutputFilter.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `VoidOutputFilter.doWrite(ByteBuffer)`
  org.apache.coyote.http11.filters.IdentityOutputFilter.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `IdentityOutputFilter.doWrite(ByteBuffer)`
  org.apache.coyote.http11.filters.GzipOutputFilter.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `GzipOutputFilter.doWrite(ByteBuffer)`
  org.apache.coyote.http11.filters.ChunkedOutputFilter.doWrite(ByteChunk) Unused. Will be removed in Tomcat 9. Use `ChunkedOutputFilter.doWrite(ByteBuffer)`
  org.apache.coyote.http2.Http2OutputBuffer.doWrite(ByteChunk)
  org.apache.catalina.core.StandardContext.dynamicServletAdded(Wrapper) This will be removed in Tomcat 9. The registration should be created directly.
  org.apache.tomcat.util.codec.binary.BaseNCodec.encode(Object) This unused method will be removed in Tomcat 9
  org.apache.catalina.util.URLEncoder.encode(String) Use `URLEncoder.encode(String, String)`
  org.apache.catalina.util.URLEncoder.encode(String, String) This will be removed in Tomcat 9.0.x
  org.apache.catalina.connector.Response.encodeRedirectUrl(String) As of Version 2.1 of the Java Servlet API, use `encodeRedirectURL()` instead.
  org.apache.catalina.filters.CsrfPreventionFilter.CsrfResponseWrapper.encodeRedirectUrl(String)
  org.apache.catalina.connector.Response.encodeUrl(String) As of Version 2.1 of the Java Servlet API, use `encodeURL()` instead.
  org.apache.catalina.filters.CsrfPreventionFilter.CsrfResponseWrapper.encodeUrl(String)
  org.apache.tomcat.Jar.entryExists(String) Unused. This will be removed in Tomcat 9 onwards.
  org.apache.tomcat.util.scan.ReferenceCountedJar.entryExists(String)
  org.apache.tomcat.util.scan.JarFileUrlJar.entryExists(String)
  org.apache.tomcat.util.scan.AbstractInputStreamJar.entryExists(String)
  org.apache.jasper.compiler.JspUtil.escapeXml(String) This method will be removed in Tomcat 9
  org.apache.catalina.manager.StatusTransformer.filter(Object) This method will be removed in Tomcat 9
  org.apache.catalina.loader.WebappClassLoaderBase.filter(String) Use `WebappClassLoaderBase.filter(String, boolean)` This will be removed in Tomcat 9
  org.apache.catalina.util.RequestUtil.filter(String) This method will be removed in Tomcat 9
  org.apache.jasper.security.SecurityUtil.filter(String) This method will be removed in Tomcat 9
  org.apache.catalina.manager.StatusTransformer.filterXml(String) This method will be removed in Tomcat 9
  org.apache.catalina.util.ErrorPageSupport.find(String) Unused. Will be removed in Tomcat 10. Use `ErrorPageSupport.find(Throwable)` instead.
  org.apache.catalina.Context.findErrorPage(String) Unused. Will be removed in Tomcat 10. Use `Context.findErrorPage(Throwable)` instead.
  org.apache.catalina.core.StandardContext.findErrorPage(String)
  org.apache.catalina.mbeans.ContextMBean.findErrorPage(String) Unused. Will be removed in Tomcat 10. Use `ContextMBean.findErrorPage(Throwable)` instead.
  org.apache.catalina.Context.findStatusPage(int) Unused. Will be removed in Tomcat 10. Use `Context.findErrorPage(int)` instead.
  org.apache.catalina.core.StandardContext.findStatusPage(int)
  org.apache.catalina.Context.findStatusPages() Unused. Will be removed in Tomcat 10. Use `Context.findErrorPages()` instead.
  org.apache.catalina.core.StandardContext.findStatusPages()
  org.apache.tomcat.util.http.FastHttpDateFormat.formatDate(long, DateFormat) Unused. This will be removed in Tomcat 10
  org.apache.tomcat.util.http.CookieProcessor.generateHeader(Cookie) This method has been replaced with `CookieProcessor.generateHeader(Cookie, HttpServletRequest)` and will be removed from Tomcat 10 onwards.
  org.apache.tomcat.util.http.CookieProcessorBase.generateHeader(Cookie, HttpServletRequest) This implementation calls the deprecated `CookieProcessor.generateHeader(Cookie)` method. Implementors should not rely on this method as it is present only for transitional compatibility and will be removed in Tomcat 9.
  org.apache.catalina.connector.Connector.getAttribute(String) Use `Connector.getProperty(String)`. This will be removed in Tomcat 10 onwards.
  org.apache.coyote.AbstractProtocol.getBacklog()
  org.apache.tomcat.util.net.AbstractEndpoint.getBacklog()
  org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getBigDecimal(int, int) Use `DelegatingResultSet.getBigDecimal(int)`
  org.apache.tomcat.dbcp.dbcp2.DelegatingCallableStatement.getBigDecimal(int, int) Use `DelegatingCallableStatement.getBigDecimal(int)` or `DelegatingCallableStatement.getBigDecimal(String)`
  org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getBigDecimal(String, int) Use `DelegatingResultSet.getBigDecimal(String)`
  org.apache.tomcat.util.buf.B2CConverter.getCharsetLower(String) Will be removed in Tomcat 9.0.x
  org.apache.coyote.http11.AbstractHttp11Protocol.getCompressableMimeType() Use `AbstractHttp11Protocol.getCompressibleMimeType()`
  org.apache.coyote.http11.AbstractHttp11Protocol.getCompressableMimeTypes() Use `AbstractHttp11Protocol.getCompressibleMimeTypes()`
  org.apache.coyote.http11.Http11Processor.getCompression() Use `AbstractHttp11Protocol.getCompression()`
  org.apache.catalina.ha.session.DeltaManager.getCounterNoStateTransfered() Use `DeltaManager.getCounterNoStateTransferred()`. Will be removed in Tomcat 10 onwards.
  org.apache.tomcat.dbcp.dbcp2.BasicDataSource.getEnableAutoCommitOnReturn() Use `BasicDataSource.getAutoCommitOnReturn()`.
  org.apache.tomcat.util.descriptor.web.XmlEncodingBase.getEncoding() This method will be removed in Tomcat 9
  org.apache.tomcat.util.http.Parameters.getEncoding() This method will be removed in Tomcat 9.0.x
  org.apache.catalina.filters.ExpiresFilter.getExpirationDate(ExpiresFilter.XHttpServletResponse) Will be removed in Tomcat 10. Use `ExpiresFilter.getExpirationDate(HttpServletRequest, XHttpServletResponse)`
  org.apache.jasper.runtime.PageContextImpl.getExpressionEvaluator()
  org.apache.jasper.runtime.JspContextWrapper.getExpressionEvaluator()
  org.apache.catalina.realm.UserDatabaseRealm.getName()
  org.apache.catalina.realm.RealmBase.getName() This will be removed in Tomcat 9 onwards. Use `Class.getSimpleName()` instead.
  org.apache.catalina.realm.NullRealm.getName()
  org.apache.catalina.realm.MemoryRealm.getName()
  org.apache.catalina.realm.JNDIRealm.getName()
  org.apache.catalina.realm.JDBCRealm.getName()
  org.apache.catalina.realm.JAASRealm.getName()
  org.apache.catalina.realm.DataSourceRealm.getName()
  org.apache.catalina.realm.CombinedRealm.getName()
  org.apache.tomcat.util.digester.RuleSetBase.getNamespaceURI() Unused. This will be removed in Tomcat 9.
  org.apache.tomcat.util.digester.RuleSet.getNamespaceURI() Unused. Will be removed in Tomcat 9
  org.apache.tomcat.util.digester.Rules.getNamespaceURI() Unused. Will be removed in Tomcat 9
  org.apache.catalina.ha.session.DeltaManager.getNewDeltaSession() Unused. This will be removed in Tomcat 10.
  org.apache.coyote.CompressionConfig.getNoCompressionStrongETag() Will be removed in Tomcat 10 where it will be hard-coded to `true`
  org.apache.coyote.http11.AbstractHttp11Protocol.getNoCompressionStrongETag()
  org.apache.coyote.http2.Http2Protocol.getNoCompressionStrongETag()
  org.apache.catalina.realm.RealmBase.getPrincipal(String, GSSCredential) This will be removed in Tomcat 10 onwards. Use `RealmBase.getPrincipal(GSSName, GSSCredential)` instead.
  org.apache.catalina.servlets.DefaultServlet.getReadme(WebResource) Unused. Will be removed in Tomcat 9
  org.apache.catalina.connector.Request.getRealPath(String) As of version 2.1 of the Java Servlet API, use `ServletContext.getRealPath()`.
  org.apache.coyote.http11.AbstractHttp11Protocol.getRejectIllegalHeaderName() Now an alias for `AbstractHttp11Protocol.getRejectIllegalHeader()`. Will be removed in Tomcat 10 onwards.
  org.apache.coyote.ajp.AbstractAjpProtocol.getRequiredSecret() Replaced by `AbstractAjpProtocol.getSecret()`. Will be removed in Tomcat 11 onwards
  org.apache.catalina.Realm.getRoles(Principal) This will be removed in Tomcat 10.
  org.apache.tomcat.util.digester.Digester.getRuleNamespaceURI() Unused. Will be removed in Tomcat 9
  org.apache.coyote.AbstractProtocol.getSendReasonPhrase() This option will be removed in Tomcat 9. Reason phrase will not be sent.
  org.apache.catalina.core.ApplicationContextFacade.getServlet(String) As of Java Servlet API 2.1, with no direct replacement.
  org.apache.catalina.core.ApplicationContext.getServlet(String)
  org.apache.jasper.servlet.JspCServletContext.getServlet(String) This method has been deprecated with no replacement
  org.apache.catalina.core.ApplicationContextFacade.getServletNames() As of Java Servlet API 2.1, with no direct replacement.
  org.apache.catalina.core.ApplicationContext.getServletNames()
  org.apache.jasper.servlet.JspCServletContext.getServletNames() This method has been deprecated with no replacement
  org.apache.catalina.core.ApplicationContextFacade.getServlets() As of Java Servlet API 2.1, with no direct replacement.
  org.apache.catalina.core.ApplicationContext.getServlets()
  org.apache.jasper.servlet.JspCServletContext.getServlets() This method has been deprecated with no replacement
  org.apache.catalina.session.StandardSessionFacade.getSessionContext() As of Version 2.1, this method is deprecated and has no replacement.
  org.apache.catalina.session.StandardSession.getSessionContext() As of Version 2.1, this method is deprecated and has no replacement. It will be removed in a future version of the Java Servlet API.
  org.apache.coyote.AbstractProtocol.getSoLinger()
  org.apache.tomcat.util.net.AbstractEndpoint.getSoLinger()
  org.apache.coyote.AbstractProtocol.getSoTimeout()
  org.apache.tomcat.util.net.AbstractEndpoint.getSoTimeout()
  org.apache.tomcat.util.net.SSLImplementation.getSSLSupport(SSLSession) This will be removed in Tomcat 10.1.x onwards. Use `SSLImplementation.getSSLSupport(SSLSession, Map)`.
  org.apache.tomcat.util.net.jsse.JSSEImplementation.getSSLSupport(SSLSession)
  org.apache.tomcat.util.net.openssl.OpenSSLImplementation.getSSLSupport(SSLSession)
  org.apache.catalina.ha.session.DeltaManager.getStateTransfered() Use `DeltaManager.getStateTransferred()`. Will be removed in Tomcat 10 onwards.
  org.apache.jasper.compiler.SmapStratum.getStratumName() Unused. This will be removed in Tomcat 9.0.x
  org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getUnicodeStream(int) Use `DelegatingResultSet.getCharacterStream(int)`
  org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getUnicodeStream(String) Use `DelegatingResultSet.getCharacterStream(String)`
  org.apache.catalina.valves.rewrite.ResolverImpl.getUriEncoding()
  org.apache.catalina.valves.rewrite.Resolver.getUriEncoding() This will be removed in Tomcat 9.0.x
  org.apache.catalina.connector.Connector.getURIEncodingLower() This will be removed in 9.0.x onwards
  org.apache.catalina.session.StandardSessionFacade.getValue(String) As of Version 2.2, this method is replaced by `StandardSessionFacade.getAttribute(java.lang.String)`.
  org.apache.catalina.session.StandardSession.getValue(String) As of Version 2.2, this method is replaced by `getAttribute()`
  org.apache.catalina.session.StandardSessionFacade.getValueNames() As of Version 2.2, this method is replaced by `StandardSessionFacade.getAttributeNames()`
  org.apache.catalina.session.StandardSession.getValueNames() As of Version 2.2, this method is replaced by `getAttributeNames()`
  org.apache.jasper.runtime.PageContextImpl.getVariableResolver()
  org.apache.jasper.runtime.JspContextWrapper.getVariableResolver()
  org.apache.catalina.util.DOMWriter.getWriterEncoding() Unused. Will be removed in Tomcat 9.
  org.apache.catalina.startup.Catalina.initDirs() unused. Will be removed in Tomcat 10 onwards.
  org.apache.tomcat.jdbc.pool.interceptor.StatementCache.isCached(String) Unused. Will be removed in Tomcat 9
  org.apache.catalina.core.StandardWrapper.isContainerProvidedServlet(String) Unused. Will be removed in Tomcat 9
  org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.isEnableAutoCommitOnReturn() Use `PoolableConnectionFactory.isAutoCommitOnReturn()`.
  org.apache.catalina.connector.Request.isRequestedSessionIdFromUrl() As of Version 2.1 of the Java Servlet API, use `isRequestedSessionIdFromURL()` instead.
  org.apache.tomcat.util.net.SocketWrapperBase.isSecure() Unused. Will be removed in Tomcat 10.
  org.apache.tomcat.util.net.SocketWrapperBase.isUpgraded() Unused. Will be removed in Tomcat 10.
  org.apache.catalina.filters.CorsFilter.isValidOrigin(String) This will be removed in Tomcat 10 Use `RequestUtil.isValidOrigin(String)`
  org.apache.catalina.core.ApplicationContextFacade.log(Exception, String) As of Java Servlet API 2.1, use `log(String, Throwable)` instead
  org.apache.catalina.core.ApplicationContext.log(Exception, String)
  org.apache.jasper.servlet.JspCServletContext.log(Exception, String) Use log(String,Throwable) instead
  org.apache.tomcat.dbcp.pool2.impl.CallStackUtils.newCallStack(String, boolean) use `CallStackUtils.newCallStack(String, boolean, boolean)`
  org.apache.catalina.util.DOMWriter.normalize(String) Will be made private in Tomcat 9.
  org.apache.tomcat.util.http.FastHttpDateFormat.parseDate(String, DateFormat[]) Unused. This will be removed in Tomcat 10 Use `FastHttpDateFormat.parseDate(String)`
  org.apache.tomcat.dbcp.pool2.PoolUtils.prefill(KeyedObjectPool<K, V>, Collection<K>, int) Use `KeyedObjectPool.addObjects(Collection, int)`.
  org.apache.tomcat.dbcp.pool2.PoolUtils.prefill(KeyedObjectPool<K, V>, K, int) Use `KeyedObjectPool.addObjects(Object, int)`.
  org.apache.tomcat.dbcp.pool2.PoolUtils.prefill(ObjectPool<T>, int) Use `ObjectPool.addObjects(int)`.
  org.apache.catalina.manager.ManagerServlet.printResources(PrintWriter, String, Context, String, Class<?>, StringManager) Use `ManagerServlet.printResources(PrintWriter, String, javax.naming.Context, String, StringManager)` This method will be removed in Tomcat 10.x onwards
  org.apache.tomcat.util.http.Parameters.processParameters(MessageBytes, String) This method will be removed in Tomcat 9.0.x
  org.apache.catalina.session.StandardSessionFacade.putValue(String, Object) As of Version 2.2, this method is replaced by `StandardSessionFacade.setAttribute(java.lang.String, java.lang.Object)`
  org.apache.catalina.session.StandardSession.putValue(String, Object) As of Version 2.2, this method is replaced by `setAttribute()`
  org.apache.catalina.session.StandardSessionFacade.removeValue(String) As of Version 2.2, this method is replaced by `StandardSessionFacade.removeAttribute(java.lang.String)`
  org.apache.catalina.session.StandardSession.removeValue(String) As of Version 2.2, this method is replaced by `removeAttribute()`
  org.apache.catalina.servlets.DefaultServlet.render(String, WebResource) Unused. Will be removed in Tomcat 9
  org.apache.catalina.servlets.DefaultServlet.render(String, WebResource, String) Use `DefaultServlet.render(HttpServletRequest, String, WebResource, String)` instead
  org.apache.catalina.servlets.DefaultServlet.renderHtml(String, WebResource) Unused. Will be removed in Tomcat 9
  org.apache.catalina.servlets.DefaultServlet.renderHtml(String, WebResource, String) Unused. Will be removed in Tomcat 10
  org.apache.catalina.servlets.DefaultServlet.renderXml(String, WebResource, Source) Unused. Will be removed in Tomcat 9
  org.apache.catalina.servlets.DefaultServlet.renderXml(String, WebResource, Source, String) Unused. Will be removed in Tomcat 10
  org.apache.tomcat.util.IntrospectionUtils.replaceProperties(String, Hashtable<Object, Object>, IntrospectionUtils.PropertySource[]) Use `IntrospectionUtils.replaceProperties(String, Hashtable, PropertySource[], ClassLoader)`
  org.apache.jasper.runtime.JspContextWrapper.resolveVariable(String)
  org.apache.jasper.JspC.scanFiles(File) This will be removed in Tomcat 10. Use `JspC.scanFiles()`
  org.apache.catalina.connector.Response.sendAcknowledgement() Unused. Will be removed in Tomcat 10. Use `Response.sendAcknowledgement(ContinueResponseTiming)`.
  org.apache.catalina.ha.session.DeltaManager.serializeDeltaRequest(DeltaSession, DeltaRequest) Unused. This will be removed in Tomcat 10. Calling this method may result in a deadlock. See: https://bz.apache.org/bugzilla/show_bug.cgi?id=62841
  org.apache.catalina.Wrapper.servletSecurityAnnotationScan() This will be removed in Tomcat 9.
  org.apache.catalina.connector.Connector.setAttribute(String, Object) Use `Connector.setProperty(String, String)`. This will be removed in Tomcat 10 onwards.
  org.apache.coyote.AbstractProtocol.setBacklog(int)
  org.apache.tomcat.util.net.AbstractEndpoint.setBacklog(int)
  org.apache.coyote.Request.setCharacterEncoding(String) This method will be removed in Tomcat 9.0.x
  org.apache.coyote.http11.AbstractHttp11Protocol.setCompressableMimeType(String) Use `AbstractHttp11Protocol.setCompressibleMimeType(String)`
  org.apache.coyote.http11.Http11Processor.setCompressableMimeTypes(String[]) Use `AbstractHttp11Protocol.setCompressibleMimeType(String)`
  org.apache.coyote.http11.Http11Processor.setCompressibleMimeTypes(String[]) Use `AbstractHttp11Protocol.setCompressibleMimeType(String)`
  org.apache.coyote.http11.Http11Processor.setCompression(String) Use `AbstractHttp11Protocol.setCompression(String)`
  org.apache.coyote.http11.Http11Processor.setCompressionMinSize(int) Use `AbstractHttp11Protocol.setCompressionMinSize(int)`
  org.apache.catalina.connector.Request.setContext(Context) Use setters on `MappingData` object. Depending on use case, you may need to update other `MappingData` fields as well, such as `contextSlashCount` and `host`.
  org.apache.jasper.compiler.SmapGenerator.setDoEmbedded(boolean) Unused. Will be removed in Tomcat 9.0.x
  org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.setEnableAutoCommitOnReturn(boolean) Use `PoolableConnectionFactory.setAutoCommitOnReturn(boolean)`.
  org.apache.tomcat.dbcp.dbcp2.BasicDataSource.setEnableAutoCommitOnReturn(boolean) Use `BasicDataSource.setAutoCommitOnReturn(boolean)`.
  org.apache.catalina.connector.OutputBuffer.setEncoding(String) This method will be removed in Tomcat 9.0.x
  org.apache.catalina.connector.InputBuffer.setEncoding(String) This method will be removed in Tomcat 9.0.x
  org.apache.tomcat.util.descriptor.web.XmlEncodingBase.setEncoding(String) This method will be removed in Tomcat 9
  org.apache.tomcat.util.http.Parameters.setEncoding(String) This method will be removed in Tomcat 9.0.x
  org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.setMaxOpenPrepatedStatements(int) Use `PoolableConnectionFactory.setMaxOpenPreparedStatements(int)`.
  org.apache.tomcat.util.digester.Rules.setNamespaceURI(String) Unused. Will be removed in Tomcat 9
  org.apache.tomcat.jni.SSLContext.setNextProtos(long, String) use `SSLContext.setNpnProtos(long, String[], int)`
  org.apache.coyote.CompressionConfig.setNoCompressionStrongETag(boolean) Will be removed in Tomcat 10 where it will be hard-coded to `true`
  org.apache.coyote.http11.AbstractHttp11Protocol.setNoCompressionStrongETag(boolean)
  org.apache.coyote.http2.Http2Protocol.setNoCompressionStrongETag(boolean)
  org.apache.coyote.http11.Http11Processor.setNoCompressionUserAgents(String) Use `AbstractHttp11Protocol.setNoCompressionUserAgents(String)`
  org.apache.tomcat.util.buf.CharChunk.setOptimizedWrite(boolean) Unused code. This is now a NO-OP and will be removed without replacement in Tomcat 10.
  org.apache.catalina.connector.Connector.setProtocol(String) Will be removed in Tomcat 9. Protocol must be configured via the constructor
  org.apache.catalina.connector.Connector.setProtocolHandlerClassName(String) Will be removed in Tomcat 9. Protocol must be configured via the constructor
  org.apache.tomcat.util.http.Parameters.setQueryStringEncoding(String) This method will be removed in Tomcat 9
  org.apache.coyote.http11.AbstractHttp11Protocol.setRejectIllegalHeaderName(boolean) Now an alias for `AbstractHttp11Protocol.setRejectIllegalHeader(boolean)`. Will be removed in Tomcat 10 onwards.
  org.apache.coyote.ajp.AjpProcessor.setRequiredSecret(String)
  org.apache.coyote.ajp.AbstractAjpProtocol.setRequiredSecret(String) Replaced by `AbstractAjpProtocol.setSecret(String)`. Will be removed in Tomcat 11 onwards
  org.apache.tomcat.util.digester.Digester.setRuleNamespaceURI(String) Unused. Will be removed in Tomcat 9
  org.apache.tomcat.util.net.SocketWrapperBase.setSecure(boolean) Unused. Will be removed in Tomcat 10.
  org.apache.coyote.AbstractProtocol.setSendReasonPhrase(boolean) This option will be removed in Tomcat 9. Reason phrase will not be sent.
  org.apache.coyote.http11.Http11Processor.setServer(String) Use `AbstractHttp11Protocol.setServer(String)`
  org.apache.coyote.http11.Http11Processor.setServerRemoveAppProvidedValues(boolean)
  org.apache.catalina.Wrapper.setServletSecurityAnnotationScanRequired(boolean) This will be removed in Tomcat 9.
  org.apache.coyote.AbstractProtocol.setSoLinger(int)
  org.apache.tomcat.util.net.AbstractEndpoint.setSoLinger(int)
  org.apache.coyote.AbstractProtocol.setSoTimeout(int)
  org.apache.tomcat.util.net.AbstractEndpoint.setSoTimeout(int)
  org.apache.catalina.ha.session.DeltaManager.setStateTransfered(boolean) Use `DeltaManager.setStateTransferred(boolean)`. Will be removed in Tomcat 10 onwards.
  org.apache.catalina.connector.Response.setStatus(int, String) As of Version 2.1 of the Java Servlet API, this method has been deprecated due to the ambiguous meaning of the message parameter.
  org.apache.tomcat.dbcp.dbcp2.DelegatingPreparedStatement.setUnicodeStream(int, InputStream, int) Use setAsciiStream(), setCharacterStream() or setNCharacterStream()
  org.apache.tomcat.util.net.SocketWrapperBase.setUpgraded(boolean) Unused. Will be removed in Tomcat 10.
  org.apache.jasper.JspC.setWebXmlFragment(String) Will be removed in Tomcat 10. Use `JspC.setWebXmlInclude(String)`
  org.apache.catalina.connector.Request.setWrapper(Wrapper) Use setters on `MappingData` object. Depending on use case, you may need to update other `MappingData` fields as well, such as `context` and `contextSlashCount`.
  org.apache.catalina.util.DOMWriter.sortAttributes(NamedNodeMap) Will be made private in Tomcat 9.
  org.apache.tomcat.util.buf.UDecoder.URLDecode(byte[], String, boolean) This method will be removed in Tomcat 9
  org.apache.tomcat.util.buf.UDecoder.URLDecode(String) Unused. This will be removed in Tomcat 10 onwards
  org.apache.tomcat.util.buf.UDecoder.URLDecode(String, String) This method will be removed in Tomcat 9
  org.apache.tomcat.util.buf.UDecoder.URLDecode(String, String, boolean) This method will be removed in Tomcat 9

- Deprecated Constructors
  Constructor and Description
  org.apache.catalina.authenticator.BasicAuthenticator.BasicCredentials(ByteChunk, Charset) Unused. Will be removed in Tomcat 10. Use 3-arg constructor
  org.apache.catalina.util.DOMWriter(Writer, boolean)
  org.apache.tomcat.util.net.jsse.JSSESupport(SSLSession) This will be removed in Tomcat 10.1.x onwards Use `JSSESupport.JSSESupport(SSLSession, Map)`
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String) Use `PStmtKey.PStmtKey(String, String, String)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, int, int) Use `PStmtKey.PStmtKey(String, String, String, int, int)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String) Use `PStmtKey.PStmtKey(String, String, String)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int) Use `PStmtKey.PStmtKey(String, String, String, int)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int[]) Use `PStmtKey.PStmtKey(String, String, String, int[])`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int, int) Use @link `PStmtKey.PStmtKey(String, String, String, int, int)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int, int, int) Use `PStmtKey.PStmtKey(String, String, String, int, int, int)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int, int, int, PoolingConnection.StatementType) Use `PStmtKey.PStmtKey(String, String, String, int, int, int, PoolingConnection.StatementType)`
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, int, int, PoolingConnection.StatementType) Use `PStmtKey.PStmtKey(String, String, String, int, int, PoolingConnection.StatementType)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, PoolingConnection.StatementType) Use `PStmtKey.PStmtKey(String, String, String, PoolingConnection.StatementType)`.
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, PoolingConnection.StatementType, Integer) Use `PStmtKey.PStmtKey(String, String, String, PoolingConnection.StatementType, Integer)`
  org.apache.tomcat.dbcp.dbcp2.PStmtKey(String, String, String[]) Use `PStmtKey.PStmtKey(String, String, String, String[])`.
  org.apache.jasper.compiler.SmapStratum(String) Use the no-arg constructor
  org.apache.catalina.loader.WebappLoader(ClassLoader) Use `Container.setParentClassLoader(ClassLoader)` to specify the required class loader. This method will be removed in Tomcat 10 onwards.

Copyright © 2000-2021 Apache Software Foundation. All Rights Reserved.