Top Deprecated
Oracle's implementation of the JSF 2.3 specification API. 2.3

Deprecated API

No API in this release is deprecated for removal.

Deprecated Item Summary

SinceDeprecated Item and Description

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.ApplicationWrapper.getPropertyResolver()

See superclass for alternative.

javax.faces.application.ApplicationWrapper.getVariableResolver()

See superclass for alternative.

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

See superclass for alternative.

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

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

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.

Returns:

the action.
javax.faces.component.ActionSource.getAction()

This has been replaced by ActionSource2#getActionExpression.

Returns:

the action listener.
javax.faces.component.ActionSource.getActionListener()

Use getActionListeners instead.

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

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

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.

Returns:

the value change listener.
javax.faces.component.EditableValueHolder.getValueChangeListener()

Use getValueChangeListeners 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.NamingContainer.SEPARATOR_CHAR

use UINamingContainer#getSeparatorChar(javax.faces.context.FacesContext)

javax.faces.component.UICommand.getAction()

This has been replaced by getActionExpression.

javax.faces.component.UICommand.getActionListener()

Use getActionListeners instead.

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

javax.faces.component.UIComponent.CURRENT_COMPONENT

javax.faces.component.UIComponent.CURRENT_COMPOSITE_COMPONENT

javax.faces.component.UIComponent.bindings

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.getValidator()

getValidators should be used instead.

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.getAction()

javax.faces.component.UIViewAction.getActionListener()

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

This has been replaced by javax.el.ELException.

javax.faces.el.MethodBinding

This has been replaced by javax.el.MethodExpression.

javax.faces.el.MethodNotFoundException

This has been replaced by javax.el.MethodNotFoundException.

javax.faces.el.PropertyNotFoundException

This has been replaced by javax.el.PropertyNotFoundException.

javax.faces.el.PropertyResolver

This has been replaced by javax.el.ELResolver.

javax.faces.el.ReferenceSyntaxException

This has been replaced by javax.el.ELException.

javax.faces.el.ValueBinding

This has been replaced by javax.el.ValueExpression.

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.validator.Validator.NOT_IN_RANGE_MESSAGE_ID

Use DoubleRangeValidator#NOT_IN_RANGE_MESSAGE_ID or LongRangeValidator#NOT_IN_RANGE_MESSAGE_ID instead.

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

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.