Deprecated API


Contents
Deprecated Classes
javax.faces.webapp.AttributeTag
          The Faces implementation must now provide the implementation for this class. 
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.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 javax.el.MethodExpression. 
javax.faces.el.MethodBinding
          This has been replaced by javax.el.MethodExpression. 
javax.faces.el.PropertyResolver
          This has been replaced by ELResolver. 
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.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.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.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.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 javax.el.ValueExpression. 
javax.faces.el.ValueBinding
          This has been replaced by javax.el.ValueExpression. 
javax.faces.el.VariableResolver
          This has been replaced by ELResolver when operating with a null base argument. 
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 javax.el.ELException. 
javax.faces.el.EvaluationException
          This has been replaced by javax.el.ELException. 
javax.faces.el.MethodNotFoundException
          This has been replaced by javax.el.MethodNotFoundException. 
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.PropertyNotFoundException
          This has been replaced by javax.el.PropertyNotFoundException. 
javax.faces.el.ReferenceSyntaxException
          This has been replaced by javax.el.ELException. 
javax.faces.el.ReferenceSyntaxException
          This has been replaced by javax.el.ELException. 
 

Deprecated Fields
javax.faces.component.UIComponent.bindings
           
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.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) 
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 #createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String). 
javax.faces.application.Application.createComponent(ValueBinding, FacesContext, String)
          This has been replaced by #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.faces.application.Application.createMethodBinding(String, Class[])
          This has been replaced by calling Application.getExpressionFactory() then ExpressionFactory#createMethodExpression. 
javax.faces.application.Application.createValueBinding(String)
          This has been replaced by calling Application.getExpressionFactory() then ExpressionFactory#createValueExpression. 
javax.faces.application.Application.createValueBinding(String)
          This has been replaced by calling Application.getExpressionFactory() then ExpressionFactory#createValueExpression. 
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.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.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.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.UICommand.getAction()
          This has been replaced by UICommand.getActionExpression(). 
javax.faces.component.ActionSource.getAction()
          This has been replaced by ActionSource2.getActionExpression(). 
javax.faces.component.ActionSource.getActionListener()
          Use ActionSource.getActionListeners() instead. 
javax.faces.component.UICommand.getActionListener()
          Use UICommand.getActionListeners() instead. 
javax.faces.component.UICommand.getActionListener()
          Use UICommand.getActionListeners() instead. 
javax.faces.component.ActionSource.getActionListener()
          Use ActionSource.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.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.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.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.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.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.UIInput.getValidator()
          UIInput.getValidators() should be used instead. 
javax.faces.component.EditableValueHolder.getValidator()
          EditableValueHolder.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.UISelectMany.getValueBinding(String)
          this has been replaced by UISelectMany.getValueExpression(java.lang.String). 
javax.faces.component.UISelectBoolean.getValueBinding(String)
          This has been replaced by UISelectBoolean.getValueExpression(java.lang.String). 
javax.faces.component.UIGraphic.getValueBinding(String)
          This has been replaced by UIGraphic.getValueExpression(java.lang.String). 
javax.faces.component.UIComponentBase.getValueBinding(String)
          This has been replaced by UIComponent.getValueExpression(java.lang.String). 
javax.faces.component.UIComponent.getValueBinding(String)
          This has been replaced by UIComponent.getValueExpression(java.lang.String). 
javax.faces.component.EditableValueHolder.getValueChangeListener()
          Use EditableValueHolder.getValueChangeListeners() instead. 
javax.faces.component.EditableValueHolder.getValueChangeListener()
          Use EditableValueHolder.getValueChangeListeners() instead. 
javax.faces.application.Application.getVariableResolver()
          This has been replaced by Application.getELResolver(). 
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.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.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.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 #setActionExpression(javax.el.MethodExpression). 
javax.faces.component.UICommand.setAction(MethodBinding)
          This has been replaced by #setActionExpression(javax.el.MethodExpression). 
javax.faces.component.ActionSource.setAction(MethodBinding)
          This has been replaced by ActionSource2#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.component.UICommand.setActionListener(MethodBinding)
          This has been replaced by UICommand.addActionListener(javax.faces.event.ActionListener). 
javax.faces.component.ActionSource.setActionListener(MethodBinding)
          This has been replaced by ActionSource.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(ELResolver). 
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(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.UIInput.setValidator(MethodBinding)
          Use UIInput.addValidator(javax.faces.validator.Validator) instead, obtaining the argument Validator by creating an instance of MethodExpressionValidator. 
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.UIComponent.setValueBinding(String, ValueBinding)
          This has been replaced by UIComponent.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UIComponentBase.setValueBinding(String, ValueBinding)
          This has been replaced by UIComponent.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UIData.setValueBinding(String, ValueBinding)
          This has been replaced by #setValueExpression(java.lang.String, javax.el.ValueExpression). 
javax.faces.component.UIGraphic.setValueBinding(String, ValueBinding)
          This has been replaced by UIGraphic.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UISelectBoolean.setValueBinding(String, ValueBinding)
          This has been replaced by UISelectBoolean.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UISelectMany.setValueBinding(String, ValueBinding)
          This has been replaced by #setValueExpression(java.lang.String, javax.el.ValueExpression). 
javax.faces.component.UISelectMany.setValueBinding(String, ValueBinding)
          This has been replaced by #setValueExpression(java.lang.String, javax.el.ValueExpression). 
javax.faces.component.UISelectBoolean.setValueBinding(String, ValueBinding)
          This has been replaced by UISelectBoolean.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UIGraphic.setValueBinding(String, ValueBinding)
          This has been replaced by UIGraphic.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UIData.setValueBinding(String, ValueBinding)
          This has been replaced by #setValueExpression(java.lang.String, javax.el.ValueExpression). 
javax.faces.component.UIComponentBase.setValueBinding(String, ValueBinding)
          This has been replaced by UIComponent.setValueExpression(java.lang.String, ValueExpression). 
javax.faces.component.UIComponent.setValueBinding(String, ValueBinding)
          This has been replaced by UIComponent.setValueExpression(java.lang.String, 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.component.UIInput.setValueChangeListener(MethodBinding)
          Use UIInput.addValueChangeListener(javax.faces.event.ValueChangeListener) instead, obtaining the argument ValueChangeListener by creating an instance of MethodExpressionValueChangeListener. 
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.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(ELResolver). 
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(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). 
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). 
 



Copyright 2002-2011 Oracle America Inc, Inc. All Rights Reserved.