Deprecated List (JavaServer Faces API (2.2))

Deprecated Classes
Class and Description
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 `ConverterTag.createConverter()` method, is now an implementation detail.
javax.faces.el.MethodBinding This has been replaced by `MethodExpression`.
javax.faces.el.PropertyResolver This has been replaced by `ELResolver`.
javax.faces.view.facelets.ResourceResolver
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`.
javax.faces.webapp.UIComponentBodyTag All component tags now implement `BodyTag`. This class has been replaced by `UIComponentELTag`.
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.ValidatorTag This has been partially replaced by `ValidatorELTag`. The remainder of the functionality, namely, the binding facility and the implementation of the `ValidatorTag.createValidator()` method, is now an implementation detail.
javax.faces.el.ValueBinding This has been replaced by `ValueExpression`.
javax.faces.el.VariableResolver This has been replaced by `ELResolver` when operating with a `null` `base` argument.

Deprecated Exceptions
Exceptions and Description
javax.faces.el.EvaluationException This has been replaced by `ELException`.
javax.faces.el.MethodNotFoundException This has been replaced by `MethodNotFoundException`.
javax.faces.el.PropertyNotFoundException This has been replaced by `PropertyNotFoundException`.
javax.faces.el.ReferenceSyntaxException This has been replaced by `ELException`.

Deprecated Fields
Field and Description
javax.faces.component.UIComponent.bindings
javax.faces.component.UIComponent.CURRENT_COMPONENT
javax.faces.component.UIComponent.CURRENT_COMPOSITE_COMPONENT
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.component.NamingContainer.SEPARATOR_CHAR use `UINamingContainer.getSeparatorChar(javax.faces.context.FacesContext)`

Deprecated Methods
Method and Description
javax.faces.application.Application.createComponent(ValueBinding, FacesContext, String) This has been replaced by `Application.createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String)`.
javax.faces.application.ApplicationWrapper.createComponent(ValueBinding, FacesContext, String) See superclass for alternative.
javax.faces.application.Application.createMethodBinding(String, Class<?>[]) This has been replaced by calling `Application.getExpressionFactory()` then `ExpressionFactory.createMethodExpression(javax.el.ELContext, java.lang.String, java.lang.Class<?>, java.lang.Class<?>[])`.
javax.faces.application.ApplicationWrapper.createMethodBinding(String, Class<?>[]) See superclass for alternative.
javax.faces.application.Application.createValueBinding(String) This has been replaced by calling `Application.getExpressionFactory()` then `ExpressionFactory.createValueExpression(javax.el.ELContext, java.lang.String, java.lang.Class<?>)`.
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.application.ApplicationWrapper.evaluateExpressionGet(FacesContext, String, Class<? extends T>) See superclass for alternative.
javax.faces.component.ActionSource.getAction() This has been replaced by `ActionSource2.getActionExpression()`.
javax.faces.component.UICommand.getAction() This has been replaced by `UICommand.getActionExpression()`.
javax.faces.component.UIViewAction.getAction()
javax.faces.component.ActionSource.getActionListener() Use `ActionSource.getActionListeners()` instead.
javax.faces.component.UICommand.getActionListener() Use `UICommand.getActionListeners()` instead.
javax.faces.component.UIViewAction.getActionListener()
javax.faces.render.ResponseStateManager.getComponentStateToRestore(FacesContext) This method has been replaced by `ResponseStateManager.getState(javax.faces.context.FacesContext, java.lang.String)`. The default implementation returns `null`.
javax.faces.application.StateManager.getComponentStateToSave(FacesContext) the distinction between tree structure and component state is now an implementation detail. The default implementation returns `null`.
javax.faces.application.Application.getPropertyResolver() This has been replaced by `Application.getELResolver()`.
javax.faces.application.ApplicationWrapper.getPropertyResolver() See superclass for alternative.
javax.faces.render.ResponseStateManager.getTreeStructureToRestore(FacesContext, String) This method has been replaced by `ResponseStateManager.getState(javax.faces.context.FacesContext, java.lang.String)`. The default implementation returns `null`.
javax.faces.application.StateManager.getTreeStructureToSave(FacesContext) the distinction between tree structure and component state is now an implementation detail. The default implementation returns `null`.
javax.faces.component.EditableValueHolder.getValidator() `EditableValueHolder.getValidators()` should be used instead.
javax.faces.component.UIInput.getValidator() `UIInput.getValidators()` should be used instead.
javax.faces.component.UIComponent.getValueBinding(String) This has been replaced by `UIComponent.getValueExpression(java.lang.String)`.
javax.faces.component.UIComponentBase.getValueBinding(String) This has been replaced by `UIComponent.getValueExpression(java.lang.String)`.
javax.faces.component.UIGraphic.getValueBinding(String) This has been replaced by `UIGraphic.getValueExpression(java.lang.String)`.
javax.faces.component.UISelectBoolean.getValueBinding(String) This has been replaced by `UISelectBoolean.getValueExpression(java.lang.String)`.
javax.faces.component.UISelectMany.getValueBinding(String) this has been replaced by `UISelectMany.getValueExpression(java.lang.String)`.
javax.faces.component.EditableValueHolder.getValueChangeListener() Use `EditableValueHolder.getValueChangeListeners()` instead.
javax.faces.application.Application.getVariableResolver() This has been replaced by `Application.getELResolver()`.
javax.faces.application.ApplicationWrapper.getVariableResolver() See superclass for alternative.
javax.faces.application.StateManager.restoreComponentState(FacesContext, UIViewRoot, String) the distinction between tree structure and component state is now an implementation detail. The default implementation does nothing.
javax.faces.application.StateManager.restoreTreeStructure(FacesContext, String, String) the distinction between tree structure and component state is now an implementation detail. The default implementation returns `null`.
javax.faces.application.StateManager.restoreView(FacesContext, String, String)
javax.faces.application.StateManager.saveSerializedView(FacesContext) this has been replaced by `StateManager.saveView(javax.faces.context.FacesContext)`. 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 `StateManager.SerializedView`, which it then returns. Otherwise, it returns `null`
javax.faces.application.StateManager.saveView(FacesContext)
javax.faces.component.ActionSource.setAction(MethodBinding) This has been replaced by `ActionSource2.setActionExpression(javax.el.MethodExpression)`.
javax.faces.component.UICommand.setAction(MethodBinding) This has been replaced by `UICommand.setActionExpression(javax.el.MethodExpression)`.
javax.faces.component.UIViewAction.setAction(MethodBinding)
javax.faces.component.ActionSource.setActionListener(MethodBinding) This has been replaced by `ActionSource.addActionListener(javax.faces.event.ActionListener)`.
javax.faces.component.UICommand.setActionListener(MethodBinding) This has been replaced by `UICommand.addActionListener(javax.faces.event.ActionListener)`.
javax.faces.component.UIViewAction.setActionListener(MethodBinding)
javax.faces.application.Application.setPropertyResolver(PropertyResolver) 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 `Application.addELResolver(javax.el.ELResolver)`.
javax.faces.application.ApplicationWrapper.setPropertyResolver(PropertyResolver) See superclass for alternative.
javax.faces.component.EditableValueHolder.setValidator(MethodBinding) Use `EditableValueHolder.addValidator(javax.faces.validator.Validator)` instead, obtaining the argument `Validator` by creating an instance of `MethodExpressionValidator`.
javax.faces.component.UIInput.setValidator(MethodBinding) Use `UIInput.addValidator(javax.faces.validator.Validator)` instead, obtaining the argument `Validator` by creating an instance of `MethodExpressionValidator`.
javax.faces.component.UIComponent.setValueBinding(String, ValueBinding) This has been replaced by `UIComponent.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.UIComponentBase.setValueBinding(String, ValueBinding) This has been replaced by `UIComponent.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.UIData.setValueBinding(String, ValueBinding) This has been replaced by `UIData.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.UIGraphic.setValueBinding(String, ValueBinding) This has been replaced by `UIGraphic.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.UISelectBoolean.setValueBinding(String, ValueBinding) This has been replaced by `UISelectBoolean.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.UISelectMany.setValueBinding(String, ValueBinding) This has been replaced by `UISelectMany.setValueExpression(java.lang.String, javax.el.ValueExpression)`.
javax.faces.component.EditableValueHolder.setValueChangeListener(MethodBinding) Use `EditableValueHolder.addValueChangeListener(javax.faces.event.ValueChangeListener)` instead, obtaining the argument `ValueChangeListener` by creating an instance of `MethodExpressionValueChangeListener`.
javax.faces.component.UIInput.setValueChangeListener(MethodBinding) Use `UIInput.addValueChangeListener(javax.faces.event.ValueChangeListener)` instead, obtaining the argument `ValueChangeListener` by creating an instance of `MethodExpressionValueChangeListener`.
javax.faces.application.Application.setVariableResolver(VariableResolver) 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 `Application.addELResolver(javax.el.ELResolver)`.
javax.faces.application.ApplicationWrapper.setVariableResolver(VariableResolver) See superclass for alternative.
javax.faces.application.StateManager.writeState(FacesContext, StateManager.SerializedView) This method has been replaced by `StateManager.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.render.ResponseStateManager.writeState(FacesContext, StateManager.SerializedView) This method has been replaced by `ResponseStateManager.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 `StateManager.SerializedView.getStructure()`, and the second being the return from `StateManager.SerializedView.getState()`. It then passes this `Object` array to `ResponseStateManager.writeState(javax.faces.context.FacesContext, java.lang.Object)`.

Deprecated API

Contents