## 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.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.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.

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