## Deprecated API

Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Interfaces
javax.servlet.jsp.el.FunctionMapper As of JSP 2.1, replaced by `FunctionMapper`
javax.servlet.http.HttpSessionContext As of Java(tm) Servlet API 2.1 for security reasons, with no replacement. This interface will be removed in a future version of this API.
javax.servlet.SingleThreadModel As of Java Servlet API 2.4, with no direct replacement.
javax.servlet.jsp.el.VariableResolver As of JSP 2.1, replaced by `ELResolver`

Deprecated Classes
org.mortbay.html.Element Unless somebody steps forward to update and maintain this package
javax.servlet.jsp.el.Expression As of JSP 2.1, replaced by `ValueExpression`
javax.servlet.jsp.el.ExpressionEvaluator As of JSP 2.1, replaced by `ExpressionFactory`
javax.servlet.http.HttpUtils As of Java(tm) Servlet API 2.3. These methods were only useful with the default encoding and have been moved to the request interfaces.
org.mortbay.html.Page Unless somebody steps forward to update and maintain this package
org.mortbay.html.Text all Composites now take Strings direct.

Deprecated Exceptions
javax.servlet.jsp.el.ELException As of JSP 2.1, replaced by `ELException`
javax.servlet.jsp.el.ELParseException As of JSP 2.1, replaced by `ELException`

Deprecated Fields
javax.servlet.jsp.tagext.BodyTag.EVAL_BODY_TAG As of Java JSP API 1.2, use BodyTag.EVAL_BODY_BUFFERED or IterationTag.EVAL_BODY_AGAIN.

Deprecated Methods
dojox.cometd.Bayeux.addFilter(String, DataFilter) user `Channel.addDataFilter(DataFilter)`
org.mortbay.cometd.AbstractBayeux.addFilter(String, DataFilter) user `Channel#addFilter`
org.mortbay.jetty.servlet.ServletHandler.addFilter(String, String, int)
org.mortbay.jetty.servlet.ServletHandler.addServlet(String, String)
org.mortbay.jetty.webapp.WebAppContext.addWebApplications(HandlerContainer, String, String, boolean, boolean) use `WebAppDeployer` or `ContextDeployer`
org.mortbay.jetty.webapp.WebAppContext.addWebApplications(HandlerContainer, String, String, String[], boolean, boolean) use `WebAppDeployer` or `ContextDeployer`
org.mortbay.jetty.webapp.WebAppContext.addWebApplications(Server, String, String, boolean, boolean) use `WebAppDeployer` or `ContextDeployer`
org.mortbay.jetty.webapp.WebAppContext.addWebApplications(Server, String, String, String[], boolean, boolean) use `WebAppDeployer` or `ContextDeployer`
org.mortbay.html.Element.attributes(String) Use attribute(String).
dojox.cometd.Bayeux.deliver(Client, Client, String, Message) use `Client.deliver(Client, Message)`
org.mortbay.cometd.AbstractBayeux.deliver(Client, Client, String, Message) use `Client.deliver(Client, Message)`
dojox.cometd.Client.deliver(Client, Message) use `Client.deliver(Client, String, Object, String)`
org.mortbay.cometd.ClientImpl.deliver(Client, Message) use `ClientImpl.deliver(Client, String, Object, String)`
org.mortbay.cometd.client.BayeuxClient.deliver(Client, Message) use `BayeuxClient.deliver(Client, String, Object, String)`
javax.servlet.http.HttpServletResponse.encodeRedirectUrl(String) As of version 2.1, use encodeRedirectURL(String url) instead
javax.servlet.http.HttpServletResponse.encodeUrl(String) As of version 2.1, use encodeURL(String url) instead
org.mortbay.jetty.security.SslSelectChannelConnector.getCipherSuites() As of Java Servlet API 2.0, with no replacement.
com.sun.el.parser.SimpleCharStream.getColumn()
org.apache.taglibs.standard.extra.spath.ASCII_UCodeESC_CharStream.getColumn()
org.apache.taglibs.standard.extra.spath.ASCII_CharStream.getColumn()
org.apache.taglibs.standard.lang.jstl.parser.SimpleCharStream.getColumn()
javax.servlet.jsp.JspContext.getExpressionEvaluator() As of JSP 2.1, replaced by `JspApplicationContext.getExpressionFactory()`
org.mortbay.jetty.handler.ContextHandler.getHosts()
javax.servlet.http.HttpSessionContext.getIds() As of Java Servlet API 2.1 with no replacement. This method must return an empty `Enumeration` and will be removed in a future version of this API.
org.mortbay.jetty.servlet.AbstractSessionManager.NullSessionContext.getIds() From HttpSessionContext
com.sun.el.parser.SimpleCharStream.getLine()
org.apache.taglibs.standard.extra.spath.ASCII_UCodeESC_CharStream.getLine()
org.apache.taglibs.standard.extra.spath.ASCII_CharStream.getLine()
org.apache.taglibs.standard.lang.jstl.parser.SimpleCharStream.getLine()
dojox.cometd.Client.getListener() Returns only the first listener added
org.mortbay.cometd.client.BayeuxClient.getListener()
org.mortbay.jetty.SessionManager.getMetaManager() use `SessionManager.getIdManager()`
org.mortbay.jetty.servlet.AbstractSessionManager.getMetaManager() use `AbstractSessionManager.getIdManager()`
javax.servlet.ServletRequest.getRealPath(String) As of Version 2.1 of the Java Servlet API, use `ServletContext.getRealPath(java.lang.String)` instead.
javax.servlet.jsp.JspException.getRootCause() As of JSP 2.1, replaced by `Throwable.getCause()`
org.mortbay.util.Scanner.getScanDir() use getScanDirs() instead
javax.servlet.UnavailableException.getServlet() As of Java Servlet API 2.2, with no replacement. Returns the servlet that is reporting its unavailability.

javax.servlet.ServletContext.getServlet(String)
As of Java Servlet API 2.1, with no direct replacement.

This method was originally defined to retrieve a servlet from a `ServletContext`. In this version, this method always returns `null` and remains only to preserve binary compatibility. This method will be permanently removed in a future version of the Java Servlet API.

In lieu of this method, servlets can share information using the `ServletContext` class and can perform shared business logic by invoking methods on common non-servlet classes.

org.apache.jasper.servlet.JspCServletContext.getServlet(String) This method has been deprecated with no replacement

javax.servlet.ServletContext.getServletNames()
As of Java Servlet API 2.1, with no replacement.

This method was originally defined to return an `Enumeration` of all the servlet names known to this context. In this version, this method always returns an empty `Enumeration` and remains only to preserve binary compatibility. This method will be permanently removed in a future version of the Java Servlet API.

org.apache.jasper.servlet.JspCServletContext.getServletNames() This method has been deprecated with no replacement

javax.servlet.ServletContext.getServlets()
As of Java Servlet API 2.0, with no replacement.

This method was originally defined to return an `Enumeration` of all the servlets known to this servlet context. In this version, this method always returns an empty enumeration and remains only to preserve binary compatibility. This method will be permanently removed in a future version of the Java Servlet API.

org.apache.jasper.servlet.JspCServletContext.getServlets() This method has been deprecated with no replacement
javax.servlet.http.HttpSessionContext.getSession(String) As of Java Servlet API 2.1 with no replacement. This method must return null and will be removed in a future version of this API.
org.mortbay.jetty.servlet.AbstractSessionManager.NullSessionContext.getSession(String) From HttpSessionContext
javax.servlet.http.HttpSession.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.mortbay.jetty.servlet.AbstractSessionManager.Session.getSessionContext()
javax.servlet.http.HttpSession.getValue(String) As of Version 2.2, this method is replaced by `HttpSession.getAttribute(java.lang.String)`.
org.mortbay.jetty.servlet.AbstractSessionManager.Session.getValue(String) As of Version 2.2, this method is replaced by `AbstractSessionManager.Session.getAttribute(java.lang.String)`
javax.servlet.http.HttpSession.getValueNames() As of Version 2.2, this method is replaced by `HttpSession.getAttributeNames()`
org.mortbay.jetty.servlet.AbstractSessionManager.Session.getValueNames() As of Version 2.2, this method is replaced by `AbstractSessionManager.Session.getAttributeNames()`
javax.servlet.jsp.JspContext.getVariableResolver() As of JSP 2.1, replaced by `ELContext.getELResolver()`, which can be obtained by `jspContext.getELContext().getELResolver()`.
org.mortbay.jetty.servlet.ServletHandler.isInitializeAtStart()
javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromUrl() As of Version 2.1 of the Java Servlet API, use `HttpServletRequest.isRequestedSessionIdFromURL()` instead.
javax.servlet.ServletContext.log(Exception, String) As of Java Servlet API 2.1, use `ServletContext.log(String message, Throwable throwable)` instead. This method was originally defined to write an exception's stack trace and an explanatory error message to the servlet log file.
org.apache.jasper.servlet.JspCServletContext.log(Exception, String) Use log(String,Throwable) instead
dojox.cometd.Bayeux.newClient(String, Listener) use `Bayeux.newClient(String)`
org.mortbay.cometd.AbstractBayeux.newClient(String, Listener) use `AbstractBayeux.newClient(String)`
org.mortbay.util.ajax.JSON.parse(InputStream) use `JSON.parse(Reader)`
org.mortbay.util.ajax.JSON.parse(InputStream, boolean) use `JSON.parse(Reader, boolean)`
dojox.cometd.Bayeux.publish(Client, String, Object, String) use `Channel.publish(Client, Object, String)`
org.mortbay.cometd.AbstractBayeux.publish(Client, String, Object, String) use `Channel.publish(Client, Object, String)`
dojox.cometd.Client.publish(String, Object, String) use `Channel.publish(Client, Object, String)`
org.mortbay.cometd.ClientImpl.publish(String, Object, String) use `Channel#publish(Client, Object, String)`
javax.servlet.http.HttpSession.putValue(String, Object) As of Version 2.2, this method is replaced by `HttpSession.setAttribute(java.lang.String, java.lang.Object)`
org.mortbay.jetty.servlet.AbstractSessionManager.Session.putValue(String, Object) As of Version 2.2, this method is replaced by `AbstractSessionManager.Session.setAttribute(java.lang.String, java.lang.Object)`
dojox.cometd.Bayeux.removeFilter(String, DataFilter) user `Channel.removeDataFilter(DataFilter)`
javax.servlet.http.HttpSession.removeValue(String) As of Version 2.2, this method is replaced by `HttpSession.removeAttribute(java.lang.String)`
org.mortbay.jetty.servlet.AbstractSessionManager.Session.removeValue(String) As of Version 2.2, this method is replaced by `AbstractSessionManager.Session.removeAttribute(java.lang.String)`
org.mortbay.html.Applet.setAlternate(Element) use add
org.mortbay.html.Applet.setAlternate(String) use add
org.mortbay.html.Table.setCellNestingFactory(CompositeFactory) Use setNestingFactory or setThreadNestingFactory
org.mortbay.jetty.security.SslSelectChannelConnector.setCipherSuites(String[]) As of Java Servlet API 2.0, with no replacement.
org.mortbay.jetty.handler.ContextHandler.setHosts(String[]) use `ContextHandler.setConnectorNames(String[])`
org.mortbay.jetty.servlet.ServletHandler.setInitializeAtStart(boolean)
dojox.cometd.Client.setListener(Listener) use `Client.addListener(EventListener)`
org.mortbay.cometd.client.BayeuxClient.setListener(Listener)
org.mortbay.jetty.nio.SelectChannelConnector.setLowResourcesMaxIdleTime(long) use `SelectChannelConnector.setLowResourceMaxIdleTime(int)`
org.mortbay.jetty.servlet.AbstractSessionManager.setMetaManager(SessionIdManager) use `AbstractSessionManager.setIdManager(SessionIdManager)`
org.mortbay.util.Scanner.setScanDir(File) use setScanDirs(List dirs) instead
javax.servlet.http.HttpServletResponse.setStatus(int, String) As of version 2.1, due to ambiguous meaning of the message parameter. To set a status code use `setStatus(int)`, to send an error with a description use `sendError(int, String)`. Sets the status code and message for this response.
dojox.cometd.Client.subscribe(String) use `Channel.subscribe(Client)`
org.mortbay.cometd.ClientImpl.subscribe(String) use `Channel#subscribe(Client)`
dojox.cometd.Bayeux.subscribe(String, Client) use `Channel.subscribe(Client)`
dojox.cometd.Client.unsubscribe(String) use `Channel.unsubscribe(Client)`
org.mortbay.cometd.ClientImpl.unsubscribe(String) use `Channel#unsubscribe(Client)`
dojox.cometd.Bayeux.unsubscribe(String, Client) use `Channel.unsubscribe(Client)`

Deprecated Constructors
org.mortbay.cometd.ClientImpl(AbstractBayeux, String, Listener)
org.apache.jasper.runtime.TagHandlerPool(int) Use static getTagHandlerPool
javax.servlet.UnavailableException(int, Servlet, String) As of Java Servlet API 2.2, use `UnavailableException.UnavailableException(String, int)` instead.
javax.servlet.UnavailableException(Servlet, String) As of Java Servlet API 2.2, use `UnavailableException.UnavailableException(String)` instead.

Copyright © 2008 Mort Bay Consulting. All Rights Reserved.