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.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.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.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.http.FastHttpDateFormat.RFC1123_DATE	Unused. This will be removed in Tomcat 10.

Methods

Method	Description
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.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.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.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.getNewDeltaSession()	Unused. This will be removed in Tomcat 10.
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.Manager.changeSessionId(Session)	Use Manager.rotateSessionId(Session). Will be removed in Tomcat 10
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.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.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.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.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.file.ConfigFileLoader.getInputStream(String)
org.apache.tomcat.util.file.ConfigFileLoader.getURI(String)
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.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.SocketWrapperBase.awaitReadComplete(long, TimeUnit)
org.apache.tomcat.util.net.SocketWrapperBase.awaitWriteComplete(long, TimeUnit)

Constructors

Constructor	Description
org.apache.catalina.authenticator.BasicAuthenticator.BasicCredentials(ByteChunk, Charset)	Unused. Will be removed in Tomcat 10. Use 3-arg constructor
org.apache.tomcat.dbcp.dbcp2.PStmtKey(String)	Use PStmtKey(String, String, String).