Top Deprecated
JavaEE API 8.0.1

Deprecated API


No API in this release is deprecated for removal.

Deprecated Item Summary

SinceDeprecated Item and Description

Returns:

The Identity object that identifies the caller.
javax.ejb.EJBContext.getCallerIdentity
()

Use Principal getCallerPrincipal() instead.

Returns:

The environment properties for the enterprise bean.
javax.ejb.EJBContext.getEnvironment
()

Use the JNDI naming context java:comp/env to access enterprise bean's environment.

Returns:

True if the caller has the specified role.
javax.ejb.EJBContext.isCallerInRole
(Identity
The java.security.Identity of the role to be tested.
role
)

Use boolean isCallerInRole(String roleName) instead.

Returns:

a string containing the DTD version number This method is being deprecated. Two DD data formats are being used, DTD and XML Schema. DDBeanRoot.getDDBeanRootVersion should be used in its place.
javax.enterprise.deploy.model.DDBeanRoot.getModuleDTDVersion
()

As of version 1.1 replaced by DDBeanRoot.getDDBeanRootVersion()

Returns:

a string containing the DTD version number
 A module's deployment descriptor file always contains
 a document type identifier, DOCTYPE.  The DOCTYPE statement 
 contains the module DTD version number in the label of the 
 statement.

 	The format of the DOCTYPE statement is:
    <!DOCTYPE root_element PUBLIC "-//organization//label//language" "location">
root_element - is the name of the root document in the DTD. organization - is the name of the organization responsible for the creation and maintenance of the DTD being referenced. label - is a unique descriptive name for the public text being referenced. language - is the ISO 639 language id representing the natural language encoding of th DTD. location - is the URL of the DTD. An example Java EE deployment descriptor DOCTYPE statement is:
    <!DOCTYPE application-client PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application Client 1.3//EN" "http://java.sun.com/dtd/application-client_1_3.dtd">
In this example the label is, "DTD J2EE Application Client 1.3", and the DTD version number is 1.3. A call to getModuleDTDVersion would return a string containing, "1.3".
This method is being deprecated. With the addition of multiple deployment descritors in components for J2EE 1.4 this method is being replaced by DDBeanRoot.getDDBeanRootVersion.
javax.enterprise.deploy.model.DeployableObject.getModuleDTDVersion
()

As of version 1.1 replaced by DDBeanRoot.getDDBeanRootVersion()

Returns:

ProgressObject an object that tracks and reports the status of the distribution process.
javax.enterprise.deploy.spi.DeploymentManager.distribute
(Target[]
A list of server targets the user is specifying this application be deployed to.
targetList
,
InputStream
The input stream containing the application archive to be disrtibuted.
moduleArchive
,
InputStream
The input stream containing the deployment configuration information associated with this application archive.
deploymentPlan
)

as of Java EE 5, replaced with distribute(Target[], ModuleType, InputStream, InputStream)

Returns:

the UI component.
javax.faces.application.Application.createComponent
(ValueBinding
ValueBinding representing a component value binding expression (typically specified by the component attribute of a custom tag)
componentBinding
,
FacesContext
FacesContext for the current request
context
,
String
Component type to create if the ValueBinding does not return a component instance
componentType
)

This has been replaced by createComponent(javax.el.ValueExpression, javax.faces.context.FacesContext, java.lang.String).

Returns:

the method binding.
javax.faces.application.Application.createMethodBinding
(String
Method binding expression for which to return a MethodBinding instance
ref
,
Class<?>[]
Parameter signatures that must be compatible with those of the method to be invoked, or a zero-length array or null for a method that takes no parameters
params
)

This has been replaced by calling getExpressionFactory then ExpressionFactory#createMethodExpression.

Returns:

the value binding.
javax.faces.application.Application.createValueBinding
(String
Value binding expression for which to return a ValueBinding instance
ref
)

This has been replaced by calling getExpressionFactory then ExpressionFactory#createValueExpression.

Returns:

the property resolver.
javax.faces.application.Application.getPropertyResolver
()

This has been replaced by getELResolver.

Returns:

the variable resolver.
javax.faces.application.Application.getVariableResolver
()

This has been replaced by getELResolver.

javax.faces.application.Application.setPropertyResolver(PropertyResolver
The new PropertyResolver instance
resolver
)

The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right place in the application configuration resources which will be considered in the normal course of expression evaluation. This method now will cause the argument resolver to be wrapped inside an implementation of ELResolver and exposed to the EL resolution system as if the user had called addELResolver.

javax.faces.application.Application.setVariableResolver(VariableResolver
The new VariableResolver instance
resolver
)

The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right place in the application configuration resources which will be considered in the normal course of expression evaluation. This method now will cause the argument resolver to be wrapped inside an implementation of ELResolver and exposed to the EL resolution system as if the user had called addELResolver.

javax.faces.application.ApplicationFactory.ApplicationFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.ApplicationWrapper.ApplicationWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.ApplicationWrapper.createComponent(ValueBinding
ValueBinding representing a component value binding expression (typically specified by the component attribute of a custom tag)
componentBinding
,
FacesContext
FacesContext for the current request
context
,
String
Component type to create if the ValueBinding does not return a component instance
componentType
)

See superclass for alternative.

javax.faces.application.ApplicationWrapper.createMethodBinding(String
Method binding expression for which to return a MethodBinding instance
ref
,
Class<?>[]
Parameter signatures that must be compatible with those of the method to be invoked, or a zero-length array or null for a method that takes no parameters
params
)

See superclass for alternative.

javax.faces.application.ApplicationWrapper.createValueBinding(String
Value binding expression for which to return a ValueBinding instance
ref
)

Deprecated as a consequence of ValueBinding being deprecated. See corresponding docs for further information.

javax.faces.application.ApplicationWrapper.evaluateExpressionGet(FacesContext
the Faces context.
context
,
String
the expression.
expression
,
Class<? extends T>
the expected type.
expectedType
)

See superclass for alternative.

javax.faces.application.ConfigurableNavigationHandlerWrapper.ConfigurableNavigationHandlerWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.ResourceHandlerWrapper.ResourceHandlerWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.ResourceWrapper.ResourceWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.StateManager.SerializedView

This class was not marked Serializable in the 1.0 version of the spec. It was also not a static inner class, so it can't be made to be Serializable. Therefore, it is being deprecated in version 1.2 of the spec. The replacement is to use an implementation dependent Object.

Returns:

the component state, or null.
javax.faces.application.StateManager.getComponentStateToSave
(FacesContext
FacesContext for the current request
context
)

the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.

Returns:

the tree structure, or null.
javax.faces.application.StateManager.getTreeStructureToSave
(FacesContext
FacesContext for the current request
context
)

the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.

javax.faces.application.StateManager.restoreComponentState(FacesContext
FacesContext for the current request
context
,
UIViewRoot
UIViewRoot returned by a previous call to restoreTreeStructure()
viewRoot
,
String
the renderKitId used to render this response. Must not be null.
renderKitId
)

the distinction between tree structure and component state is now an implementation detail. The default implementation does nothing.

Returns:

the view root, or null.
javax.faces.application.StateManager.restoreTreeStructure
(FacesContext
FacesContext for the current request
context
,
String
View identifier of the view to be restored
viewId
,
String
the renderKitId used to render this response. Must not be null.
renderKitId
)

the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.

Returns:

the view root, or null.
javax.faces.application.StateManager.restoreView
(FacesContext
FacesContext for the current request
context
,
String
View identifier of the view to be restored
viewId
,
String
the renderKitId used to render this response. Must not be null.
renderKitId
)

Returns:

the serialized view, or null.
javax.faces.application.StateManager.saveSerializedView
(FacesContext
FacesContext for the current request
context
)

this has been replaced by saveView. The default implementation calls saveView and inspects the return. If the return is an Object [], it casts the result to an Object [] wrapping the first and second elements in an instance of SerializedView, which it then returns. Otherwise, it returns null

Returns:

the saved view.
javax.faces.application.StateManager.saveView
(FacesContext
FacesContext for the current request
context
)

javax.faces.application.StateManager.writeState(FacesContext
FacesContext for the current request
context
,
StateManager.SerializedView
the serialized state to be written
state
)

This method has been replaced by writeState(javax.faces.context.FacesContext, java.lang.Object). The default implementation calls the non-deprecated variant of the method passing an Object [] as the second argument, where the first element of the array is the return from getStructure() and the second is the return from getState() on the argument state.

javax.faces.application.StateManagerWrapper.StateManagerWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.application.StateManagerWrapper.saveSerializedView(FacesContext
FacesContext for the current request
context
)

Deprecated as a consequence of StateManager.SerializedView being deprecated. See corresponding docs for further information.

javax.faces.application.StateManagerWrapper.writeState(FacesContext
FacesContext for the current request
context
,
StateManager.SerializedView
the serialized state to be written
state
)

Deprecated as a consequence of StateManager.SerializedView being deprecated. See corresponding docs for further information.

javax.faces.application.ViewHandlerWrapper.ViewHandlerWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.bean.ApplicationScoped

This has been replaced by javax.enterprise.context.ApplicationScoped, which is a CDI build-in scope with similar semantics.

javax.faces.bean.CustomScoped

This has been replaced by CDI custom scopes and javax.enterprise.context.spi.Context. See 2.4.2 and 6.2 of the CDI specification for further details.

javax.faces.bean.ManagedBean

This has been replaced by the Managed Beans specification in general and specifically the dependency injection, scopes and naming from the CDI specification. Note that the eager attribute for application scoped beans is replaced specifically by observing the javax.enterprise.context.Initialized event for javax.enterprise.context.ApplicationScoped. See 6.7.3 of the CDI spec for further details.

javax.faces.bean.ManagedProperty

This has been replaced by javax.faces.annotation.ManagedProperty, which is a CDI build-in bean with similar semantics

javax.faces.bean.NoneScoped

This has been replaced by javax.enterprise.context.Dependent, which is a CDI build-in scope with approximately similar semantics.

javax.faces.bean.ReferencedBean

The referenced-bean concept was used for a design time promise which however did not achieve widespread adoption. There is no direct replacement for this other than using the XML variant in faces-config.xml.

javax.faces.bean.RequestScoped

This has been replaced by javax.enterprise.context.RequestScoped, which is a CDI build-in scope with similar semantics.

javax.faces.bean.SessionScoped

This has been replaced by javax.enterprise.context.SessionScoped, which is a CDI build-in scope with similar semantics.

javax.faces.bean.ViewScoped

This has been replaced by javax.faces.view.ViewScoped. The functionality of this corresponding annotation is identical to this one, but it is implemented as a CDI custom scope.

javax.faces.component.ActionSource.setActionListener(MethodBinding
The new method binding expression
actionListener
)

This has been replaced by addActionListener(javax.faces.event.ActionListener).

Returns:

the validator as a method binding.
javax.faces.component.EditableValueHolder.getValidator
()

getValidators should be used instead.

javax.faces.component.EditableValueHolder.setValidator(MethodBinding
The new MethodBinding instance
validatorBinding
)

Use addValidator instead, obtaining the argument Validator by creating an instance of javax.faces.validator.MethodExpressionValidator.

javax.faces.component.EditableValueHolder.setValueChangeListener(MethodBinding
The new method binding instance
valueChangeMethod
)

Use addValueChangeListener instead, obtaining the argument ValueChangeListener by creating an instance of javax.faces.event.MethodExpressionValueChangeListener.

javax.faces.component.MethodBindingMethodExpressionAdapter

Deprecated as a consequence of MethodBinding being deprecated.

javax.faces.component.MethodBindingValidator.MethodBindingValidator(MethodBinding methodBinding)

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodBindingValidator.getWrapped()

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodBindingValidator.methodBinding

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodBindingValueChangeListener.MethodBindingValueChangeListener(MethodBinding methodBinding)

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodBindingValueChangeListener.getWrapped()

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodBindingValueChangeListener.methodBinding

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodExpressionMethodBindingAdapter.MethodExpressionMethodBindingAdapter(MethodBinding binding)

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodExpressionMethodBindingAdapter.binding

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.MethodExpressionMethodBindingAdapter.getWrapped()

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.UICommand.setAction(MethodBinding
The new MethodBinding expression
action
)

This has been replaced by setActionExpression(javax.el.MethodExpression).

javax.faces.component.UICommand.setActionListener(MethodBinding
The new method binding expression
actionListener
)

This has been replaced by addActionListener(javax.faces.event.ActionListener).

Returns:

the value binding.
javax.faces.component.UIComponent.getValueBinding
(String
Name of the attribute or property for which to retrieve a ValueBinding
name
)

This has been replaced by getValueExpression.

javax.faces.component.UIComponent.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression.

javax.faces.component.UIComponentBase.getValueBinding(String
Name of the attribute or property for which to retrieve a ValueBinding
name
)

This has been replaced by getValueExpression.

javax.faces.component.UIComponentBase.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression.

javax.faces.component.UIData.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression(java.lang.String, javax.el.ValueExpression).

Returns:

the value binding, or null.
javax.faces.component.UIGraphic.getValueBinding
(String
Name of the attribute or property for which to retrieve a ValueBinding
name
)

This has been replaced by getValueExpression(java.lang.String).

javax.faces.component.UIGraphic.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression.

javax.faces.component.UIInput.getValueChangeListener()

Deprecated as a consequence of MethodBinding being deprecated. See corresponding docs for further information.

javax.faces.component.UIInput.setValidator(MethodBinding
The new MethodBinding instance
validatorBinding
)

Use addValidator instead, obtaining the argument Validator by creating an instance of javax.faces.validator.MethodExpressionValidator.

javax.faces.component.UIInput.setValueChangeListener(MethodBinding
the value change listener.
valueChangeListener
)

Use addValueChangeListener instead, obtaining the argument ValueChangeListener by creating an instance of javax.faces.event.MethodExpressionValueChangeListener.

javax.faces.component.UISelectBoolean.getValueBinding(String
Name of the attribute or property for which to retrieve a ValueBinding
name
)

This has been replaced by getValueExpression.

javax.faces.component.UISelectBoolean.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression.

Returns:

the value binding, or null
javax.faces.component.UISelectMany.getValueBinding
(String
Name of the attribute or property for which to retrieve a ValueBinding
name
)

this has been replaced by getValueExpression(java.lang.String).

javax.faces.component.UISelectMany.setValueBinding(String
Name of the attribute or property for which to set a ValueBinding
name
,
ValueBinding
The ValueBinding to set, or null to remove any currently set ValueBinding
binding
)

This has been replaced by setValueExpression(java.lang.String, javax.el.ValueExpression).

javax.faces.component.UIViewAction.setAction(final MethodBinding
The new MethodBinding expression
action
)

javax.faces.component.UIViewAction.setActionListener(final MethodBinding
The new method binding expression
actionListener
)

javax.faces.component.ValueBindingValueExpressionAdapter

Deprecated as a consequence of ValueBinding being deprecated.

javax.faces.component.ValueExpressionValueBindingAdapter.ValueExpressionValueBindingAdapter(ValueBinding binding)

Deprecated as a consequence of ValueBinding being deprecated. See corresponding docs for further information.

javax.faces.component.ValueExpressionValueBindingAdapter.binding

Deprecated as a consequence of ValueBinding being deprecated. See corresponding docs for further information.

javax.faces.component.ValueExpressionValueBindingAdapter.getWrapped()

Deprecated as a consequence of ValueBinding being deprecated. See corresponding docs for further information.

javax.faces.component.visit.VisitContextFactory.VisitContextFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.component.visit.VisitContextWrapper.VisitContextWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.ExceptionHandlerFactory.ExceptionHandlerFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.ExceptionHandlerWrapper.ExceptionHandlerWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.ExternalContextFactory.ExternalContextFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.ExternalContextWrapper.ExternalContextWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.FacesContextFactory.FacesContextFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.FacesContextWrapper.FacesContextWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.FlashFactory.FlashFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.FlashWrapper.FlashWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.PartialViewContextFactory.PartialViewContextFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.PartialViewContextWrapper.PartialViewContextWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.context.ResponseWriterWrapper.ResponseWriterWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.el.VariableResolver

This has been replaced by javax.el.ELResolver when operating with a null base argument.

javax.faces.flow.FlowHandlerFactoryWrapper.FlowHandlerFactoryWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.lifecycle.ClientWindowFactory.ClientWindowFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.lifecycle.ClientWindowWrapper.ClientWindowWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.lifecycle.LifecycleFactory.LifecycleFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.lifecycle.LifecycleWrapper.LifecycleWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.render.RenderKitFactory.RenderKitFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.render.RenderKitWrapper.RenderKitWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.render.RendererWrapper.RendererWrapper()

Use the other constructor taking the implementation being wrapped.

Returns:

the component state portion of the state
javax.faces.render.ResponseStateManager.getComponentStateToRestore
(FacesContext
The FacesContext instance for the current request
context
)

This method has been replaced by getState. The default implementation returns null.

Returns:

the tree structure portion of the state
javax.faces.render.ResponseStateManager.getTreeStructureToRestore
(FacesContext
The FacesContext instance for the current request
context
,
String
View identifier of the view to be restored
viewId
)

This method has been replaced by getState. The default implementation returns null.

javax.faces.render.ResponseStateManager.writeState(FacesContext
The FacesContext instance for the current request
context
,
StateManager.SerializedView
The serialized state information previously saved
state
)

This method has been replaced by writeState(javax.faces.context.FacesContext, java.lang.Object). The default implementation creates a two element Object array with the first element being the return from calling SerializedView#getStructure, and the second being the return from SerializedView#getState. It then passes this Object array to writeState.

javax.faces.view.ViewDeclarationLanguageFactory.ViewDeclarationLanguageFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.view.ViewDeclarationLanguageWrapper.ViewDeclarationLanguageWrapper()

Use the other constructor taking the implementation being wrapped.

javax.faces.view.facelets.FaceletCache.setMemberFactories(FaceletCache.MemberFactory<V>
the MemberFactory instance that will be used to create instances of Facelets.
faceletFactory
,
FaceletCache.MemberFactory<V>
the MemberFactory instance that will be used to create instances of metadata Facelets.
viewMetadataFaceletFactory
)

javax.faces.view.facelets.FaceletCacheFactory.FaceletCacheFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.view.facelets.TagHandlerDelegateFactory.TagHandlerDelegateFactory()

Use the other constructor taking the implementation being wrapped.

javax.faces.webapp.AttributeTag

The Faces implementation must now provide the implementation for this class.

javax.faces.webapp.ConverterTag

This has been partially replaced by ConverterELTag. The remainder of the functionality, namely, the binding facility and the implementation of the createConverter method, is now an implementation detail.

javax.faces.webapp.UIComponentBodyTag

All component tags now implement BodyTag. This class has been replaced by UIComponentELTag.

javax.faces.webapp.UIComponentClassicTagBase.encodeBegin()

No encoding is done during JSP page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.

javax.faces.webapp.UIComponentClassicTagBase.encodeChildren()

No encoding is done during JSP page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.

javax.faces.webapp.UIComponentClassicTagBase.encodeEnd()

No encoding is done during JSP page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.

javax.faces.webapp.UIComponentTag

Use of this class has been replaced with UIComponentELTag, which extends UIComponentClassicTagBase to add properties that use the EL API introduced as part of JSP 2.1.

javax.faces.webapp.UIComponentTag.UIComponentTagAdapter

Deprecated as a consequence of UIComponentTag being deprecated. See corresponding docs for further information.

Returns:

the parent tag
javax.faces.webapp.UIComponentTag.getParentUIComponentTag
(PageContext
PageContext for the current page
context
)

Deprecated as a consequence of UIComponentTag being deprecated. See corresponding docs for further information.

javax.faces.webapp.ValidatorTag

This has been partially replaced by ValidatorELTag. The remainder of the functionality, namely, the binding facility and the implementation of the createValidator method, is now an implementation detail.

Returns:

linked Exception, null if none
javax.resource.ResourceException.getLinkedException
()

J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class..

javax.resource.ResourceException.setLinkedException(Exception
linked Exception
ex
)

J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.

Returns:

next ResourceWarning in the chain; null if none.
javax.resource.cci.ResourceWarning.getLinkedWarning
()

J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.

javax.resource.cci.ResourceWarning.setLinkedWarning(ResourceWarning
ResourceWarning to be added to the chain.
warning
)

J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.

javax.resource.spi.security.GenericCredential

The preferred way to represent generic credential information is via the org.ietf.jgss.GSSCredential interface in J2SE Version 1.4, which provides similar functionality.

Returns:

the javax.servlet.Servlet Servlet with the given name
javax.servlet.ServletContext.getServlet
(String
the servlet name
name
)

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.

Returns:

an Enumeration of javax.servlet.Servlet Servlet names
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.

Returns:

an Enumeration of javax.servlet.Servlet Servlet
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.

javax.servlet.ServletContext.log(Exception
the Exception error
exception
,
String
a String that describes the exception
msg
)

As of Java Servlet API 2.1, use 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.

Returns:

the real path, or null if the translation cannot be performed.
javax.servlet.ServletRequest.getRealPath
(String
the path for which the real path is to be returned.
path
)

As of Version 2.1 of the Java Servlet API, use ServletContext#getRealPath instead.

javax.servlet.ServletRequestWrapper.getRealPath(String
the path for which the real path is to be returned.
path
)

As of Version 2.1 of the Java Servlet API, use ServletContext#getRealPath instead

javax.servlet.SingleThreadModel

As of Java Servlet API 2.4, with no direct replacement.

javax.servlet.UnavailableException.UnavailableException(Servlet
the Servlet instance that is unavailable
servlet
,
String
a String specifying the descriptive message
msg
)

As of Java Servlet API 2.2, use UnavailableException(String) instead.

javax.servlet.UnavailableException.UnavailableException(int
an integer specifying the number of seconds the servlet expects to be unavailable; if zero or negative, indicates that the servlet can't make an estimate
seconds
,
Servlet
the Servlet that is unavailable
servlet
,
String
a String specifying the descriptive message, which can be written to a log file or displayed for the user.
msg
)

As of Java Servlet API 2.2, use UnavailableException(String, int) instead.

Returns:

the Servlet object that is throwing the UnavailableException
javax.servlet.UnavailableException.getServlet
()

As of Java Servlet API 2.2, with no replacement. Returns the servlet that is reporting its unavailability.

Returns:

true if the session ID was conveyed to the server as part of a URL; otherwise, false
javax.servlet.http.HttpServletRequest.isRequestedSessionIdFromUrl
()

As of Version 2.1 of the Java Servlet API, use isRequestedSessionIdFromURL instead.

Returns:

the encoded URL if encoding is needed; the unchanged URL otherwise.
javax.servlet.http.HttpServletResponse.encodeRedirectUrl
(String
the url to be encoded.
url
)

As of version 2.1, use encodeRedirectURL(String url) instead

Returns:

the encoded URL if encoding is needed; the unchanged URL otherwise.
javax.servlet.http.HttpServletResponse.encodeUrl
(String
the url to be encoded.
url
)

As of version 2.1, use encodeURL(String url) instead

javax.servlet.http.HttpServletResponse.setStatus(int
the status code
sc
,
String
the status message
sm
)

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.

javax.servlet.http.HttpServletResponseWrapper.encodeUrl(String
the url to be encoded.
url
)

As of version 2.1, use encodeURL(String url) instead

javax.servlet.http.HttpServletResponseWrapper.setStatus(int
the status code
sc
,
String
the status message
sm
)

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)

Returns:

the HttpSessionContext for this session.
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.

Returns:

the object with the specified name
javax.servlet.http.HttpSession.getValue
(String
a string specifying the name of the object
name
)

As of Version 2.2, this method is replaced by getAttribute.

Returns:

an array of String objects specifying the names of all the objects bound to this session
javax.servlet.http.HttpSession.getValueNames
()

As of Version 2.2, this method is replaced by getAttributeNames

javax.servlet.http.HttpSession.putValue(String
the name to which the object is bound; cannot be null
name
,
Object
the object to be bound; cannot be null
value
)

As of Version 2.2, this method is replaced by setAttribute

javax.servlet.http.HttpSession.removeValue(String
the name of the object to remove from this session
name
)

As of Version 2.2, this method is replaced by removeAttribute

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.

Returns:

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

Returns:

null in all cases
javax.servlet.http.HttpSessionContext.getSession
(String
the id of the session to be returned
sessionId
)

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.

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.

Returns:

A valid instance of an ExpressionEvaluator.
javax.servlet.jsp.JspContext.getExpressionEvaluator
()

As of JSP 2.1, replaced by JspApplicationContext#getExpressionFactory

Returns:

A valid instance of a VariableResolver.
javax.servlet.jsp.JspContext.getVariableResolver
()

As of JSP 2.1, replaced by ELContext#getELResolver, which can be obtained by jspContext.getELContext().getELResolver().

Returns:

the Throwable that caused this JSP exception
javax.servlet.jsp.JspException.getRootCause
()

As of JSP 2.1, replaced by getCause()

Returns:

The result of the expression evaluation.
javax.servlet.jsp.el.Expression.evaluate
(VariableResolver
A VariableResolver instance that can be used at runtime to resolve the name of implicit objects into Objects.
vResolver
)

Deprecated as a consequence of VariableResolver being deprecated. See corresponding docs for further information.

Returns:

The result of the expression evaluation.
javax.servlet.jsp.el.ExpressionEvaluator.evaluate
(String
The expression to be evaluated.
expression
,
Class<T>
The expected type of the result of the evaluation
expectedType
,
VariableResolver
A VariableResolver instance that can be used at runtime to resolve the name of implicit objects into Objects.
vResolver
,
FunctionMapper
A FunctionMapper to resolve functions found in the expression. It can be null, in which case no functions are supported for this invocation.
fMapper
)

Deprecated as a consequence of VariableResolver and FunctionMapper being deprecated. See corresponding docs for further information.

Returns:

The Expression object encapsulating the arguments.
javax.servlet.jsp.el.ExpressionEvaluator.parseExpression
(String
The expression to be evaluated.
expression
,
Class<T>
The expected type of the result of the evaluation
expectedType
,
FunctionMapper
A FunctionMapper to resolve functions found in the expression. It can be null, in which case no functions are supported for this invocation. The ExpressionEvaluator must not hold on to the FunctionMapper reference after returning from parseExpression(). The Expression object returned must invoke the same functions regardless of whether the mappings in the provided FunctionMapper instance change between calling ExpressionEvaluator.parseExpression() and Expression.evaluate().
fMapper
)

Deprecated as a consequence of FunctionMapper and Expression being deprecated. See corresponding docs for further information.

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.