Overview | Package | Class | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

## Deprecated API

Contents

- Deprecated Classes
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods

Deprecated Classes
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.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
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
javax.faces.component.UIComponent.bindings
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
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.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.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.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.ActionSource.getActionListener() Use `ActionSource.getActionListeners()` instead.
javax.faces.component.UICommand.getActionListener() Use `UICommand.getActionListeners()` instead.
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.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.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.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 return `null`
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.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.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.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.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)`.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

Copyright © 2002-2009 Sun Microsystems, Inc. All Rights Reserved.