Deprecated API

Contents

• Classes
• Fields
• Methods
• Constructors

Classes

Class	Description
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 9.0.x some time after 2020-12-31.
org.apache.catalina.realm.JDBCRealm	Will be removed in Tomcat 10 onwards. Use the DataSourceRealm instead.
org.apache.catalina.servlets.Constants
org.apache.catalina.session.JDBCStore	Removed in Tomcat 10 and replaced by DataSourceStore with removal of legacy JDBC code
org.apache.catalina.startup.SetAllPropertiesRule	This will be removed in Tomcat 10
org.apache.catalina.startup.SetContextPropertiesRule	This will be removed in Tomcat 10
org.apache.catalina.tribes.transport.bio.BioReceiver	This will be removed in Tomcat 10
org.apache.catalina.tribes.transport.bio.BioReplicationTask	This will be removed in Tomcat 10
org.apache.catalina.tribes.transport.bio.BioSender	This will be removed in Tomcat 10
org.apache.catalina.tribes.transport.bio.MultipointBioSender	This will be removed in Tomcat 10
org.apache.catalina.tribes.transport.bio.PooledMultiSender	This will be removed in Tomcat 10
org.apache.catalina.util.ConcurrentDateFormat	Unused. This will be removed in Tomcat 10. Use ConcurrentDateFormat
org.apache.jasper.el.ELResolverImpl
org.apache.jasper.el.ExpressionEvaluatorImpl
org.apache.jasper.el.ExpressionImpl
org.apache.jasper.el.FunctionMapperImpl
org.apache.jasper.el.VariableResolverImpl
org.apache.tomcat.dbcp.dbcp2.cpdsadapter.PStmtKeyCPDS	Use PStmtKey.
org.apache.tomcat.util.compat.TLS	Unused. This will be removed in Tomcat 10.
org.apache.tomcat.util.digester.Digester.EnvironmentPropertySource	Use EnvironmentPropertySource This will be removed in Tomcat 10 onwards.
org.apache.tomcat.util.http.parser.Vary	Use TokenList.

Fields

Field	Description
org.apache.catalina.authenticator.Constants.FORM_PRINCIPAL_NOTE	Unused. 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.catalina.connector.Response.format	Unused. This will be removed in Tomcat 10
org.apache.catalina.filters.CorsFilter.REQUEST_HEADER_VARY	Unused. Will be removed in Tomcat 10
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.catalina.mapper.MappingData.contextPath	Unused. This will be removed in Tomcat 10.
org.apache.catalina.session.StandardSession.sessionContext
org.apache.catalina.startup.HostConfig.serviced	Unused. Will be removed in Tomcat 10.1.x onwards. Replaced by the private servicedSet field.
org.apache.catalina.tribes.membership.MemberImpl.DO_DNS_LOOKUPS	This will be removed without replacement in Tomact 10 onwards
org.apache.catalina.util.LifecycleMBeanBase.mserver
org.apache.coyote.http11.Constants.CLOSE_BYTES	Unused. 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.tomcat.jni.OS.IS_NETWARE	Hard-coded to false since there has not been a supported Netware platform for many years. This will be removed in Tomcat 10 onwards
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.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH
org.apache.tomcat.util.http.FastHttpDateFormat.RFC1123_DATE	Unused. This will be removed in Tomcat 10.

Methods

Method	Description
org.apache.catalina.connector.Connector.getAttribute(String)	Use Connector.getProperty(String). This will be removed in Tomcat 10 onwards.
org.apache.catalina.connector.Connector.setAttribute(String, Object)	Use Connector.setProperty(String, String). This will be removed in Tomcat 10 onwards.
org.apache.catalina.connector.CoyoteAdapter.checkNormalize(MessageBytes)	This code will be removed in Apache Tomcat 10 onwards
org.apache.catalina.connector.Request.getRealPath(String)	As of version 2.1 of the Java Servlet API, use ServletContext.getRealPath().
org.apache.catalina.connector.Request.isRequestedSessionIdFromUrl()	As of Version 2.1 of the Java Servlet API, use isRequestedSessionIdFromURL() instead.
org.apache.catalina.connector.Response.encodeRedirectUrl(String)	As of Version 2.1 of the Java Servlet API, use encodeRedirectURL() instead.
org.apache.catalina.connector.Response.encodeUrl(String)	As of Version 2.1 of the Java Servlet API, use encodeURL() instead.
org.apache.catalina.connector.Response.sendAcknowledgement()	Unused. Will be removed in Tomcat 10. Use Response.sendAcknowledgement(ContinueResponseTiming).
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.catalina.Context.findErrorPage(String)	Unused. Will be removed in Tomcat 10. Use Context.findErrorPage(Throwable) instead.
org.apache.catalina.Context.findStatusPage(int)	Unused. Will be removed in Tomcat 10. Use Context.findErrorPage(int) instead.
org.apache.catalina.Context.findStatusPages()	Unused. Will be removed in Tomcat 10. Use Context.findErrorPages() instead.
org.apache.catalina.Context.isParallelAnnotationScanning()	This method will be removed in Tomcat 11 onwards
org.apache.catalina.core.ApplicationContext.getServlet(String)
org.apache.catalina.core.ApplicationContext.getServletNames()
org.apache.catalina.core.ApplicationContext.getServlets()
org.apache.catalina.core.ApplicationContext.log(Exception, String)
org.apache.catalina.core.ApplicationContextFacade.getServlet(String)	As of Java Servlet API 2.1, with no direct replacement.
org.apache.catalina.core.ApplicationContextFacade.getServletNames()	As of Java Servlet API 2.1, with no direct replacement.
org.apache.catalina.core.ApplicationContextFacade.getServlets()	As of Java Servlet API 2.1, with no direct replacement.
org.apache.catalina.core.ApplicationContextFacade.log(Exception, String)	As of Java Servlet API 2.1, use log(String, Throwable) instead
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.catalina.core.StandardContext.addMessageDestinationRef(MessageDestinationRef)	This will be removed in Tomcat 10. Use StandardContext.getNamingResources() instead
org.apache.catalina.core.StandardContext.findErrorPage(String)
org.apache.catalina.core.StandardContext.findMessageDestinationRef(String)	This will be removed in Tomcat 10. Use StandardContext.getNamingResources() instead
org.apache.catalina.core.StandardContext.findMessageDestinationRefs()	This will be removed in Tomcat 10. Use StandardContext.getNamingResources() instead
org.apache.catalina.core.StandardContext.findStatusPage(int)
org.apache.catalina.core.StandardContext.findStatusPages()
org.apache.catalina.core.StandardContext.removeMessageDestinationRef(String)	This will be removed in Tomcat 10. Use StandardContext.getNamingResources() instead
org.apache.catalina.filters.CorsFilter.isValidOrigin(String)	This will be removed in Tomcat 10 Use RequestUtil.isValidOrigin(String)
org.apache.catalina.filters.CsrfPreventionFilter.CsrfResponseWrapper.encodeRedirectUrl(String)
org.apache.catalina.filters.CsrfPreventionFilter.CsrfResponseWrapper.encodeUrl(String)
org.apache.catalina.filters.ExpiresFilter.getExpirationDate(ExpiresFilter.XHttpServletResponse)	Will be removed in Tomcat 10. Use ExpiresFilter.getExpirationDate(HttpServletRequest, XHttpServletResponse)
org.apache.catalina.ha.deploy.FarmWarDeployer.addServiced(String)	Unused. Will be removed in Tomcat 10.1.x onwards. Use FarmWarDeployer.tryAddServiced(java.lang.String)
org.apache.catalina.ha.deploy.FarmWarDeployer.isServiced(String)	Unused. Will be removed in Tomcat 10.1.x onwards.
org.apache.catalina.ha.deploy.FileMessageFactory.main(String[])
org.apache.catalina.ha.session.DeltaManager.changeSessionId(Session, boolean)	Will be removed in Tomcat 10
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.ha.session.DeltaManager.getCounterNoStateTransfered()	Use DeltaManager.getCounterNoStateTransferred(). Will be removed in Tomcat 10 onwards.
org.apache.catalina.ha.session.DeltaManager.getNewDeltaSession()	Unused. This will be removed in Tomcat 10.
org.apache.catalina.ha.session.DeltaManager.getStateTransfered()	Use DeltaManager.getStateTransferred(). Will be removed in Tomcat 10 onwards.
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.ha.session.DeltaManager.setStateTransfered(boolean)	Use DeltaManager.setStateTransferred(boolean). Will be removed in Tomcat 10 onwards.
org.apache.catalina.Loader.getReloadable()	Use Context.getReloadable(). This method will be removed in Tomcat 10.
org.apache.catalina.Loader.setReloadable(boolean)	Use Context.setReloadable(boolean). This method will be removed in Tomcat 10.
org.apache.catalina.Manager.changeSessionId(Session)	Use Manager.rotateSessionId(Session). Will be removed in Tomcat 10
org.apache.catalina.manager.ManagerServlet.addServiced(String)	Unused. Will be removed in Tomcat 10.1.x onwards. Use ManagerServlet.tryAddServiced(java.lang.String)
org.apache.catalina.manager.ManagerServlet.isServiced(String)	Unused. Will be removed in Tomcat 10.1.x onwards.
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.catalina.mbeans.ContextMBean.findErrorPage(String)	Unused. Will be removed in Tomcat 10. Use ContextMBean.findErrorPage(Throwable) instead.
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.catalina.Realm.getRoles(Principal)	This will be removed in Tomcat 10.
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.render(String, WebResource, String)	Use DefaultServlet.render(HttpServletRequest, String, WebResource, String) instead
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, String)	Unused. Will be removed in Tomcat 10
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.catalina.session.StandardSession.getValue(String)	As of Version 2.2, this method is replaced by getAttribute()
org.apache.catalina.session.StandardSession.getValueNames()	As of Version 2.2, this method is replaced by getAttributeNames()
org.apache.catalina.session.StandardSession.putValue(String, Object)	As of Version 2.2, this method is replaced by setAttribute()
org.apache.catalina.session.StandardSession.removeValue(String)	As of Version 2.2, this method is replaced by removeAttribute()
org.apache.catalina.session.StandardSessionFacade.getSessionContext()	As of Version 2.1, this method is deprecated and has no replacement.
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.StandardSessionFacade.getValueNames()	As of Version 2.2, this method is replaced by StandardSessionFacade.getAttributeNames()
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.StandardSessionFacade.removeValue(String)	As of Version 2.2, this method is replaced by StandardSessionFacade.removeAttribute(java.lang.String)
org.apache.catalina.startup.Catalina.initDirs()	unused. Will be removed in Tomcat 10 onwards.
org.apache.catalina.startup.HostConfig.addServiced(String)	Unused. This method will be removed in Tomcat 10.1.x onwards. Use HostConfig.tryAddServiced(java.lang.String) instead.
org.apache.catalina.startup.HostConfig.isServiced(String)	Unused. This method will be removed in Tomcat 10.1.x onwards. Use HostConfig.tryAddServiced(java.lang.String) instead.
org.apache.catalina.tribes.transport.AbstractRxTask.isDoRun()	Will be removed in Tomcat 10
org.apache.catalina.tribes.transport.AbstractRxTask.setDoRun(boolean)	Will be removed in Tomcat 10
org.apache.coyote.AbstractProcessor.ack()	Unused. This will be removed in Tomcat 10 onwards. Use AbstractProcessor.ack(ContinueResponseTiming).
org.apache.coyote.AbstractProtocol.getAcceptorThreadCount()	Will be removed in Tomcat 10.
org.apache.coyote.AbstractProtocol.setAcceptorThreadCount(int)	Will be removed in Tomcat 10.
org.apache.coyote.ajp.AbstractAjpProtocol.getRequiredSecret()	Replaced by AbstractAjpProtocol.getSecret(). Will be removed in Tomcat 11 onwards
org.apache.coyote.ajp.AbstractAjpProtocol.setRequiredSecret(String)	Replaced by AbstractAjpProtocol.setSecret(String). Will be removed in Tomcat 11 onwards
org.apache.coyote.CompressionConfig.getNoCompressionStrongETag()	Will be removed in Tomcat 10 where it will be hard-coded to true
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.getNoCompressionStrongETag()
org.apache.coyote.http11.AbstractHttp11Protocol.getRejectIllegalHeaderName()	Now an alias for AbstractHttp11Protocol.getRejectIllegalHeader(). Will be removed in Tomcat 10 onwards.
org.apache.coyote.http11.AbstractHttp11Protocol.setNoCompressionStrongETag(boolean)
org.apache.coyote.http11.AbstractHttp11Protocol.setRejectIllegalHeaderName(boolean)	Now an alias for AbstractHttp11Protocol.setRejectIllegalHeader(boolean). Will be removed in Tomcat 10 onwards.
org.apache.coyote.http11.Http11NioProtocol.getPollerThreadCount()	This getter will be removed in Tomcat 10.
org.apache.coyote.http11.Http11NioProtocol.setPollerThreadCount(int)	This setter will be removed in Tomcat 10.
org.apache.coyote.http2.Http2Protocol.getNoCompressionStrongETag()
org.apache.coyote.http2.Http2Protocol.setNoCompressionStrongETag(boolean)
org.apache.coyote.UpgradeProtocol.setHttp11Protocol(AbstractProtocol<?>)	This will be removed in Tomcat 10. Use UpgradeProtocol.setHttp11Protocol(AbstractHttp11Protocol) instead
org.apache.jasper.JspC.scanFiles(File)	This will be removed in Tomcat 10. Use JspC.scanFiles()
org.apache.jasper.JspC.setWebXmlFragment(String)	Will be removed in Tomcat 10. Use JspC.setWebXmlInclude(String)
org.apache.jasper.runtime.JspContextWrapper.getExpressionEvaluator()
org.apache.jasper.runtime.JspContextWrapper.getVariableResolver()
org.apache.jasper.runtime.JspContextWrapper.resolveVariable(String)
org.apache.jasper.runtime.PageContextImpl.getExpressionEvaluator()
org.apache.jasper.runtime.PageContextImpl.getVariableResolver()
org.apache.jasper.servlet.JspCServletContext.getServlet(String)	This method has been deprecated with no replacement
org.apache.jasper.servlet.JspCServletContext.getServletNames()	This method has been deprecated with no replacement
org.apache.jasper.servlet.JspCServletContext.getServlets()	This method has been deprecated with no replacement
org.apache.jasper.servlet.JspCServletContext.log(Exception, String)	Use log(String,Throwable) instead
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.getEnableAutoCommitOnReturn()	Use BasicDataSource.getAutoCommitOnReturn().
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.setEnableAutoCommitOnReturn(boolean)	Use BasicDataSource.setAutoCommitOnReturn(boolean).
org.apache.tomcat.dbcp.dbcp2.DelegatingCallableStatement.getBigDecimal(int, int)	Use DelegatingCallableStatement.getBigDecimal(int) or DelegatingCallableStatement.getBigDecimal(String)
org.apache.tomcat.dbcp.dbcp2.DelegatingPreparedStatement.setUnicodeStream(int, InputStream, int)	Use setAsciiStream(), setCharacterStream() or setNCharacterStream()
org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getBigDecimal(int, int)	Use DelegatingResultSet.getBigDecimal(int)
org.apache.tomcat.dbcp.dbcp2.DelegatingResultSet.getUnicodeStream(int)	Use DelegatingResultSet.getCharacterStream(int)
org.apache.tomcat.dbcp.dbcp2.managed.DataSourceXAConnectionFactory.getUsername()	Use DataSourceXAConnectionFactory.getUserName().
org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.isEnableAutoCommitOnReturn()	Use PoolableConnectionFactory.isAutoCommitOnReturn().
org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.setEnableAutoCommitOnReturn(boolean)	Use PoolableConnectionFactory.setAutoCommitOnReturn(boolean).
org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.setMaxOpenPrepatedStatements(int)	Use PoolableConnectionFactory.setMaxOpenPreparedStatements(int).
org.apache.tomcat.dbcp.pool2.impl.CallStackUtils.newCallStack(String, boolean)	use CallStackUtils.newCallStack(String, boolean, boolean)
org.apache.tomcat.dbcp.pool2.PoolUtils.prefill(ObjectPool<T>, int)	Use ObjectPool.addObjects(int).
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.tomcat.jni.SSLContext.setNextProtos(long, String)	use SSLContext.setNpnProtos(long, String[], int)
org.apache.tomcat.util.buf.ByteChunk.substract()
org.apache.tomcat.util.buf.ByteChunk.substractB()
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.tomcat.util.buf.CharChunk.substract()
org.apache.tomcat.util.buf.UDecoder.convert(CharChunk, boolean)	Unused. Will be removed in Tomcat 10
org.apache.tomcat.util.buf.UDecoder.URLDecode(String)	Unused. This will be removed in Tomcat 10 onwards
org.apache.tomcat.util.file.ConfigFileLoader.getInputStream(String)
org.apache.tomcat.util.file.ConfigFileLoader.getURI(String)
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.FastHttpDateFormat.formatDate(long, DateFormat)	Unused. This will be removed in Tomcat 10
org.apache.tomcat.util.http.FastHttpDateFormat.parseDate(String, DateFormat[])	Unused. This will be removed in Tomcat 10 Use FastHttpDateFormat.parseDate(String)
org.apache.tomcat.util.IntrospectionUtils.replaceProperties(String, Hashtable<Object, Object>, IntrospectionUtils.PropertySource[])	Use IntrospectionUtils.replaceProperties(String, Hashtable, PropertySource[], ClassLoader)
org.apache.tomcat.util.net.AbstractEndpoint.getAcceptorThreadCount()	Will be removed in Tomcat 10.
org.apache.tomcat.util.net.AbstractEndpoint.Handler.getOpenSockets()	Unused, will be removed in Tomcat 10, replaced by AbstractEndpoint.getConnections
org.apache.tomcat.util.net.AbstractEndpoint.setAcceptorThreadCount(int)	Will be removed in Tomcat 10.
org.apache.tomcat.util.net.Acceptor.stop()	This method will be removed in Tomcat 10.1.x onwards. Use Acceptor.stop(int) instead.
org.apache.tomcat.util.net.jsse.JSSEImplementation.getSSLSupport(SSLSession)
org.apache.tomcat.util.net.NioEndpoint.getPollerThreadCount()	Will be removed in Tomcat 10.
org.apache.tomcat.util.net.NioEndpoint.setPollerThreadCount(int)	Will be removed in Tomcat 10.
org.apache.tomcat.util.net.openssl.OpenSSLImplementation.getSSLSupport(SSLSession)
org.apache.tomcat.util.net.SocketWrapperBase.awaitReadComplete(long, TimeUnit)
org.apache.tomcat.util.net.SocketWrapperBase.awaitWriteComplete(long, TimeUnit)
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.tomcat.util.net.SocketWrapperBase.setSecure(boolean)	Unused. Will be removed in Tomcat 10.
org.apache.tomcat.util.net.SocketWrapperBase.setUpgraded(boolean)	Unused. Will be removed in Tomcat 10.
org.apache.tomcat.util.net.SSLImplementation.getSSLSupport(SSLSession)	This will be removed in Tomcat 10.1.x onwards. Use SSLImplementation.getSSLSupport(SSLSession, Map).

Constructors

Constructor	Description
org.apache.catalina.authenticator.BasicAuthenticator.BasicCredentials(ByteChunk, Charset)	Unused. Will be removed in Tomcat 10. Use 3-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.
org.apache.tomcat.dbcp.dbcp2.PStmtKey(String)	Use PStmtKey(String, String, String).
org.apache.tomcat.util.net.jsse.JSSESupport(SSLSession)	This will be removed in Tomcat 10.1.x onwards Use JSSESupport(SSLSession, Map)