Deprecated API

Deprecated Classes

org.apache.catalina.util.CGIProcessEnvironment

org.apache.tomcat.util.buf.DateTool
Will be replaced with a more efficient impl, based on FastDateFormat, with an API using less objects.

org.apache.catalina.ant.InstallTask
Replaced by DeployTask

org.apache.catalina.cluster.session.JvmRouteSessionIDBinderLifecycleListener

org.apache.catalina.util.ProcessEnvironment

org.apache.catalina.util.ProcessHelper

org.apache.catalina.ant.RemoveTask
Replaced by UndeployTask

org.apache.catalina.loader.WebappClassLoader.PrivilegedFindResource
Not used

Deprecated Fields

org.apache.catalina.util.HexUtils.DEC
Use HexUtils.getDec(int)

org.apache.tomcat.util.buf.HexUtils.DEC
Use HexUtils.getDec(int)

org.apache.tomcat.util.digester.Digester.JAXP_SCHEMA_LANGUAGE
This is now managed by ParserFeatureSetterFactory

Deprecated Methods

org.apache.tomcat.util.digester.Rule.begin(Attributes)
Use the begin method with namespace and name parameters instead.

org.apache.tomcat.util.digester.Rule.body(String)
Use the body method with namespace and name parameters instead.

org.apache.tomcat.util.http.ServerCookie.checkName(String)
- Not used

org.apache.tomcat.util.buf.B2CConverter.convert(ByteChunk, CharChunk)

org.apache.catalina.realm.JAASRealm.createPrincipal(String, Subject)
Use JAASRealm.createPrincipal(String, Subject, LoginContext)

org.apache.catalina.Manager.createSession()

org.apache.catalina.session.ManagerBase.createSession()

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.tomcat.util.digester.Rule.end()
Use the end method with namespace and name parameters instead.

org.apache.catalina.startup.ExpandWar.expand(InputStream, File, String)

org.apache.catalina.cluster.tcp.DataSender.getAckTimeout()
since 5.5.25 use timeout instead

org.apache.catalina.connector.Connector.getBufferSize()

org.apache.coyote.ajp.AjpMessage.getBytes(byte[])

org.apache.catalina.util.CookieTools.getCookieHeaderValue(Cookie)
Use StringBuffer version

org.apache.tomcat.util.digester.Digester.getDebug()
This method now always returns 0. Digester uses the apache jakarta commons-logging library; see the documentation for that library for more information.

org.apache.catalina.cluster.tcp.ReplicationTransmitter.getIsSenderSynchronized()
since version 5.5.7

org.apache.catalina.Cluster.getProtocol()

org.apache.tomcat.util.digester.Digester.getReader()
Use getXMLReader() instead, which can throw a SAXException if the reader cannot be instantiated

org.apache.catalina.connector.Request.getRealPath(String)
As of version 2.1 of the Java Servlet API, use ServletContext.getRealPath().

org.apache.catalina.core.ApplicationContext.getServlet(String)
As of Java Servlet API 2.1, with no direct replacement.

org.apache.catalina.core.ApplicationContext.getServletNames()
As of Java Servlet API 2.1, with no direct replacement.

org.apache.catalina.core.ApplicationContext.getServlets()
As of Java Servlet API 2.1, with no direct 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.catalina.cluster.session.DeltaSession.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.util.buf.MessageBytes.getTime()
The buffer are general purpose, caching for headers should be done in headers

org.apache.tomcat.util.http.Cookies.getTokenEndPosition(byte[], int, int)
- Use private method #getTokenEndPosition(byte[], int, int, boolean) instead

org.apache.catalina.session.StandardSession.getValue(String)
As of Version 2.2, this method is replaced by getAttribute()

org.apache.catalina.cluster.session.DeltaSession.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.cluster.session.DeltaSession.getValueNames()
As of Version 2.2, this method is replaced by getAttributeNames()

org.apache.catalina.Cluster.installContext(String, URL)

org.apache.catalina.connector.Request.isRequestedSessionIdFromUrl()
As of Version 2.1 of the Java Servlet API, use isRequestedSessionIdFromURL() instead.

org.apache.catalina.core.ApplicationContext.log(Exception, String)
As of Java Servlet API 2.1, use log(String, Throwable) instead

org.apache.tomcat.util.digester.Digester.log(String)
Call getLogger() and use it's logging methods

org.apache.tomcat.util.digester.Digester.log(String, Throwable)
Call getLogger() and use it's logging methods

org.apache.tomcat.util.digester.RulesBase.match(String)
Call match(namespaceURI,pattern) instead.

org.apache.tomcat.util.digester.Rules.match(String)
Call match(namespaceURI,pattern) instead.

org.apache.tomcat.util.digester.AbstractRulesImpl.match(String)
Call match(namespaceURI,pattern) instead.

org.apache.tomcat.util.http.ServerCookie.maybeQuote(int, StringBuffer, String)
- Not used

org.apache.catalina.ssi.SSIServletRequestUtil.normalize(String)

org.apache.catalina.authenticator.DigestAuthenticator.parseUsername(String)
Unused. Will be removed in Tomcat 8.0.x

org.apache.catalina.session.StandardSession.putValue(String, Object)
As of Version 2.2, this method is replaced by setAttribute()

org.apache.catalina.cluster.session.DeltaSession.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.cluster.session.DeltaSession.removeValue(String)
As of Version 2.2, this method is replaced by removeAttribute()

org.apache.tomcat.util.IntrospectionUtils.replaceProperties(String, Object)
Use the explicit method

org.apache.catalina.cluster.tcp.DataSender.setAckTimeout(long)
since 5.5.25 use timeout instead

org.apache.catalina.realm.JAASRealm.setAppName(String)
JAAS should use the Engine (domain) name and webpp/host overrides

org.apache.tomcat.util.net.TcpConnectionHandler.setAttribute(String, Object)
This has nothing to do with Tcp, was used as a workaround.

org.apache.catalina.connector.Connector.setBufferSize(int)

org.apache.catalina.startup.Catalina.setCatalinaBase()
Use initDirs()

org.apache.catalina.startup.Catalina.setCatalinaHome()
Use initDirs()

org.apache.tomcat.util.digester.Digester.setDebug(int)
This method now has no effect at all. Digester uses the apache jakarta comons-logging library; see the documentation for that library for more information.

org.apache.naming.resources.ResourceAttributes.setLastModified(Date)

org.apache.catalina.cluster.session.JvmRouteBinderValve.setNewSessionCookie(Request, Response, String)
Use Request.changeSessionId(String)

org.apache.catalina.Cluster.setProtocol(String)

org.apache.tomcat.util.net.TcpConnectionHandler.setServer(Object)
This has nothing to do with TcpHandling, was used as a workaround

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.util.buf.MessageBytes.setTime(long, DateFormat)
The buffer are general purpose, caching for headers should be done in headers. The second parameter allows us to pass a date format instance to avoid synchronization problems.

org.apache.catalina.Cluster.startContext(String)

org.apache.catalina.Cluster.stop(String)

Deprecated Constructors

org.apache.tomcat.util.digester.CallMethodRule(Digester, String, int)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use CallMethodRule.CallMethodRule(String methodName,int paramCount) instead.

org.apache.tomcat.util.digester.CallMethodRule(Digester, String, int, Class[])
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use CallMethodRule.CallMethodRule(String methodName,int paramCount, Class [] paramTypes) instead.

org.apache.tomcat.util.digester.CallMethodRule(Digester, String, int, String[])
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use CallMethodRule.CallMethodRule(String methodName,int paramCount, String [] paramTypes) instead.

org.apache.tomcat.util.digester.CallParamRule(Digester, int)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use CallParamRule.CallParamRule(int paramIndex) instead.

org.apache.tomcat.util.digester.CallParamRule(Digester, int, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use CallParamRule.CallParamRule(int paramIndex, String attributeName) instead.

org.apache.tomcat.util.digester.FactoryCreateRule(Digester, Class)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use FactoryCreateRule.FactoryCreateRule(Class clazz) instead.

org.apache.tomcat.util.digester.FactoryCreateRule(Digester, Class, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use FactoryCreateRule.FactoryCreateRule(Class clazz, String attributeName) instead.

org.apache.tomcat.util.digester.FactoryCreateRule(Digester, ObjectCreationFactory)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use FactoryCreateRule.FactoryCreateRule(ObjectCreationFactory creationFactory) instead.

org.apache.tomcat.util.digester.FactoryCreateRule(Digester, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use FactoryCreateRule.FactoryCreateRule(String className) instead.

org.apache.tomcat.util.digester.FactoryCreateRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use FactoryCreateRule.FactoryCreateRule(String className, String attributeName) instead.

org.apache.jk.common.JkInputStream(MsgContext)

org.apache.tomcat.util.buf.MessageBytes()
Use static newInstance() in order to allow future hooks.

org.apache.jk.common.MsgAjp()
Use the buffer size constructor.

org.apache.jk.core.MsgContext()

org.apache.tomcat.util.digester.ObjectCreateRule(Digester, Class)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use ObjectCreateRule.ObjectCreateRule(Class clazz) instead.

org.apache.tomcat.util.digester.ObjectCreateRule(Digester, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use ObjectCreateRule.ObjectCreateRule(String className) instead.

org.apache.tomcat.util.digester.ObjectCreateRule(Digester, String, Class)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use ObjectCreateRule.ObjectCreateRule(String attributeName, Class clazz) instead.

org.apache.tomcat.util.digester.ObjectCreateRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use ObjectCreateRule.ObjectCreateRule(String className, String attributeName) instead.

org.apache.tomcat.util.digester.Rule(Digester)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use Rule.Rule() instead.

org.apache.tomcat.util.digester.SetNextRule(Digester, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetNextRule.SetNextRule(String methodName) instead.

org.apache.tomcat.util.digester.SetNextRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetNextRule.SetNextRule(String methodName,String paramType) instead.

org.apache.tomcat.util.digester.SetPropertiesRule(Digester)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetPropertiesRule.SetPropertiesRule() instead.

org.apache.tomcat.util.digester.SetPropertyRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetPropertyRule.SetPropertyRule(String name, String value) instead.

org.apache.tomcat.util.digester.SetRootRule(Digester, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetRootRule.SetRootRule(String methodName) instead.

org.apache.tomcat.util.digester.SetRootRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetRootRule.SetRootRule(String methodName,String paramType) instead.

org.apache.tomcat.util.digester.SetTopRule(Digester, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetTopRule.SetTopRule(String methodName) instead.

org.apache.tomcat.util.digester.SetTopRule(Digester, String, String)
The digester instance is now set in the Digester.addRule(java.lang.String, org.apache.tomcat.util.digester.Rule) method. Use SetTopRule.SetTopRule(String methodName, String paramType) instead.