Deprecated List (Apache Tomcat 8.5.12 API Documentation)

# Deprecated API

## Contents

- Deprecated Classes
- Deprecated Fields
- Deprecated Methods

- Deprecated Classes
  Class and Description
  org.apache.jasper.xmlparser.ASCIIReader Will be removed in Tomcat 9.0.x onwards
  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.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.catalina.util.MIME2Java Unused. Will be removed in Tomcat 9.
  org.apache.jasper.xmlparser.SymbolTable Will be removed in Tomcat 9.0.x onwards
  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.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 Fields
  Field and Description
  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.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.catalina.util.DOMWriter.out Will be made private in Tomcat 9.
  org.apache.catalina.servlets.DefaultServlet.RESOURCES_JNDI_NAME Unused. Will be removed in Tomcat 9.
  org.apache.catalina.session.StandardSession.sessionContext
  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.authenticator.Constants.USE_SUBJECT_CREDS_ONLY_PROPERTY Unused. Will be removed in Tomcat 9.

- Deprecated Methods
  Method and Description
  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.catalina.startup.Tomcat.addWebapp(Host, String, String, ContextConfig) Use `Tomcat.addWebapp(Host, String, String, LifecycleListener)` instead
  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.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.catalina.util.URLEncoder.encode(String) Use `URLEncoder.encode(String, String)`
  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.catalina.loader.WebappClassLoaderBase.filter(String) Use `WebappClassLoaderBase.filter(String, boolean)` This will be removed in Tomcat 9
  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.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.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.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.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.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.tomcat.jdbc.pool.interceptor.StatementCache.isCached(String) Unused. Will be removed in Tomcat 9
  org.apache.catalina.connector.Request.isRequestedSessionIdFromUrl() As of Version 2.1 of the Java Servlet API, use `isRequestedSessionIdFromURL()` instead.
  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.catalina.util.DOMWriter.normalize(String) Will be made private in Tomcat 9.
  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.renderHtml(String, WebResource) Unused. Will be removed in Tomcat 9
  org.apache.catalina.servlets.DefaultServlet.renderXml(String, WebResource, Source) Unused. Will be removed in Tomcat 9
  org.apache.jasper.runtime.JspContextWrapper.resolveVariable(String)
  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.tomcat.jni.SSLContext.setNextProtos(long, String) use `SSLContext.setNpnProtos(long, String[], int)`
  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.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.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.

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