Deprecated API

Contents

• Packages
• Interfaces
• Classes
• Exceptions
• Annotation Types
• Fields
• Methods
• Constructors

Packages

Package	Description
jakarta.faces.bean

Interfaces

Interface	Description
com.sun.faces.facelets.FaceletCache.InstanceFactory

Classes

Class	Description
com.sun.faces.application.ViewHandlerImpl	Refer to MultiViewHandler
com.sun.faces.facelets.el.LegacyELContext
com.sun.faces.facelets.el.LegacyMethodBinding
com.sun.faces.facelets.el.LegacyValueBinding
com.sun.faces.facelets.FaceletCache
jakarta.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.
jakarta.faces.el.MethodBinding	This has been replaced by MethodExpression.
jakarta.faces.el.PropertyResolver	This has been replaced by ELResolver.
jakarta.faces.el.ValueBinding	This has been replaced by ValueExpression.
jakarta.faces.el.VariableResolver	This has been replaced by ELResolver when operating with a null base argument.
jakarta.faces.view.facelets.ResourceResolver
jakarta.faces.webapp.AttributeTag	The Faces implementation must now provide the implementation for this class.
jakarta.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.
jakarta.faces.webapp.UIComponentBodyTag	All component tags now implement BodyTag. This class has been replaced by UIComponentELTag.
jakarta.faces.webapp.UIComponentTag	Use of this class has been replaced with UIComponentELTag, which extends UIComponentClassicTagBase to add properties that use the Jakarta Expression Language API introduced as part of Jakarta Server Pages 2.1.
jakarta.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.

Exceptions

Exceptions	Description
jakarta.faces.el.EvaluationException	This has been replaced by ELException.
jakarta.faces.el.MethodNotFoundException	This has been replaced by MethodNotFoundException.
jakarta.faces.el.PropertyNotFoundException	This has been replaced by PropertyNotFoundException.
jakarta.faces.el.ReferenceSyntaxException	This has been replaced by ELException.

Annotation Types

Annotation Type	Description
jakarta.faces.bean.ApplicationScoped	This has been replaced by jakarta.enterprise.context.ApplicationScoped, which is a CDI build-in scope with similar semantics.
jakarta.faces.bean.CustomScoped	This has been replaced by CDI custom scopes and jakarta.enterprise.context.spi.Context. See 2.4.2 and 6.2 of the CDI specification for further details.
jakarta.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 jakarta.enterprise.context.Initialized event for jakarta.enterprise.context.ApplicationScoped. See 6.7.3 of the CDI spec for further details.
jakarta.faces.bean.ManagedProperty	This has been replaced by jakarta.faces.annotation.ManagedProperty, which is a CDI build-in bean with similar semantics
jakarta.faces.bean.NoneScoped	This has been replaced by jakarta.enterprise.context.Dependent, which is a CDI build-in scope with approximately similar semantics.
jakarta.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.
jakarta.faces.bean.RequestScoped	This has been replaced by jakarta.enterprise.context.RequestScoped, which is a CDI build-in scope with similar semantics.
jakarta.faces.bean.SessionScoped	This has been replaced by jakarta.enterprise.context.SessionScoped, which is a CDI build-in scope with similar semantics.
jakarta.faces.bean.ViewScoped	This has been replaced by jakarta.faces.view.ViewScoped. The functionality of this corresponding annotation is identical to this one, but it is implemented as a CDI custom scope.

Fields

Field	Description
jakarta.faces.component.NamingContainer.SEPARATOR_CHAR	use UINamingContainer.getSeparatorChar(jakarta.faces.context.FacesContext)
jakarta.faces.component.UIComponent.bindings
jakarta.faces.component.UIComponent.CURRENT_COMPONENT
jakarta.faces.component.UIComponent.CURRENT_COMPOSITE_COMPONENT
jakarta.faces.validator.Validator.NOT_IN_RANGE_MESSAGE_ID	Use DoubleRangeValidator.NOT_IN_RANGE_MESSAGE_ID or LongRangeValidator.NOT_IN_RANGE_MESSAGE_ID instead.

Methods

Method	Description
com.sun.faces.application.ApplicationImpl.createMethodBinding(String, Class<?>[])
com.sun.faces.application.ApplicationImpl.createValueBinding(String)
com.sun.faces.application.applicationimpl.ExpressionLanguage.createMethodBinding(String, Class<?>[])
com.sun.faces.application.applicationimpl.ExpressionLanguage.createValueBinding(String)
com.sun.faces.application.applicationimpl.ExpressionLanguage.getPropertyResolver()
com.sun.faces.application.applicationimpl.ExpressionLanguage.getVariableResolver()
com.sun.faces.application.applicationimpl.ExpressionLanguage.setPropertyResolver(PropertyResolver)
com.sun.faces.application.applicationimpl.ExpressionLanguage.setVariableResolver(VariableResolver)
com.sun.faces.application.ApplicationImpl.getPropertyResolver()
com.sun.faces.application.ApplicationImpl.getVariableResolver()
com.sun.faces.application.ApplicationImpl.setPropertyResolver(PropertyResolver)
com.sun.faces.application.ApplicationImpl.setVariableResolver(VariableResolver)
com.sun.faces.facelets.tag.composite.BehaviorHolderWrapper.getValueBinding(String)
com.sun.faces.facelets.tag.composite.BehaviorHolderWrapper.setValueBinding(String, ValueBinding)
jakarta.faces.application.Application.createComponent(ValueBinding, FacesContext, String)	This has been replaced by Application.createComponent(jakarta.el.ValueExpression,jakarta.faces.context.FacesContext,java.lang.String).
jakarta.faces.application.Application.createMethodBinding(String, Class<?>[])	This has been replaced by calling Application.getExpressionFactory() then ExpressionFactory.createMethodExpression(jakarta.el.ELContext, java.lang.String, java.lang.Class<?>, java.lang.Class<?>[]).
jakarta.faces.application.Application.createValueBinding(String)	This has been replaced by calling Application.getExpressionFactory() then ExpressionFactory.createValueExpression(jakarta.el.ELContext, java.lang.String, java.lang.Class<?>).
jakarta.faces.application.Application.getPropertyResolver()	This has been replaced by Application.getELResolver().
jakarta.faces.application.Application.getVariableResolver()	This has been replaced by Application.getELResolver().
jakarta.faces.application.Application.setPropertyResolver(PropertyResolver)	The recommended way to affect the execution of the Jakarta Expression Language 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 Jakarta Expression Language resolution system as if the user had called Application.addELResolver(jakarta.el.ELResolver).
jakarta.faces.application.Application.setVariableResolver(VariableResolver)	The recommended way to affect the execution of the Jakarta Expression Language 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 Jakarta Expression Language resolution system as if the user had called Application.addELResolver(jakarta.el.ELResolver).
jakarta.faces.application.ApplicationWrapper.createComponent(ValueBinding, FacesContext, String)	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.createMethodBinding(String, Class<?>[])	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.evaluateExpressionGet(FacesContext, String, Class<? extends T>)	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.getPropertyResolver()	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.getVariableResolver()	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.setPropertyResolver(PropertyResolver)	See superclass for alternative.
jakarta.faces.application.ApplicationWrapper.setVariableResolver(VariableResolver)	See superclass for alternative.
jakarta.faces.application.StateManager.getComponentStateToSave(FacesContext)	the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.
jakarta.faces.application.StateManager.getTreeStructureToSave(FacesContext)	the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.
jakarta.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.
jakarta.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.
jakarta.faces.application.StateManager.restoreView(FacesContext, String, String)
jakarta.faces.application.StateManager.saveSerializedView(FacesContext)	this has been replaced by StateManager.saveView(jakarta.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
jakarta.faces.application.StateManager.saveView(FacesContext)
jakarta.faces.application.StateManager.writeState(FacesContext, StateManager.SerializedView)	This method has been replaced by StateManager.writeState(jakarta.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.
jakarta.faces.component.ActionSource.getAction()	This has been replaced by ActionSource2.getActionExpression().
jakarta.faces.component.ActionSource.getActionListener()	Use ActionSource.getActionListeners() instead.
jakarta.faces.component.ActionSource.setAction(MethodBinding)	This has been replaced by ActionSource2.setActionExpression(jakarta.el.MethodExpression).
jakarta.faces.component.ActionSource.setActionListener(MethodBinding)	This has been replaced by ActionSource.addActionListener(jakarta.faces.event.ActionListener).
jakarta.faces.component.EditableValueHolder.getValidator()	EditableValueHolder.getValidators() should be used instead.
jakarta.faces.component.EditableValueHolder.getValueChangeListener()	Use EditableValueHolder.getValueChangeListeners() instead.
jakarta.faces.component.EditableValueHolder.setValidator(MethodBinding)	Use EditableValueHolder.addValidator(jakarta.faces.validator.Validator) instead, obtaining the argument Validator by creating an instance of MethodExpressionValidator.
jakarta.faces.component.EditableValueHolder.setValueChangeListener(MethodBinding)	Use EditableValueHolder.addValueChangeListener(jakarta.faces.event.ValueChangeListener) instead, obtaining the argument ValueChangeListener by creating an instance of MethodExpressionValueChangeListener.
jakarta.faces.component.UICommand.getAction()	This has been replaced by UICommand.getActionExpression().
jakarta.faces.component.UICommand.getActionListener()	Use UICommand.getActionListeners() instead.
jakarta.faces.component.UICommand.setAction(MethodBinding)	This has been replaced by UICommand.setActionExpression(jakarta.el.MethodExpression).
jakarta.faces.component.UICommand.setActionListener(MethodBinding)	This has been replaced by UICommand.addActionListener(jakarta.faces.event.ActionListener).
jakarta.faces.component.UIComponent.getValueBinding(String)	This has been replaced by UIComponent.getValueExpression(java.lang.String).
jakarta.faces.component.UIComponent.setValueBinding(String, ValueBinding)	This has been replaced by UIComponent.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UIComponentBase.getValueBinding(String)	This has been replaced by UIComponent.getValueExpression(java.lang.String).
jakarta.faces.component.UIComponentBase.setValueBinding(String, ValueBinding)	This has been replaced by UIComponent.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UIData.setValueBinding(String, ValueBinding)	This has been replaced by UIData.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UIGraphic.getValueBinding(String)	This has been replaced by UIGraphic.getValueExpression(java.lang.String).
jakarta.faces.component.UIGraphic.setValueBinding(String, ValueBinding)	This has been replaced by UIGraphic.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UIInput.getValidator()	UIInput.getValidators() should be used instead.
jakarta.faces.component.UIInput.setValidator(MethodBinding)	Use UIInput.addValidator(jakarta.faces.validator.Validator) instead, obtaining the argument Validator by creating an instance of MethodExpressionValidator.
jakarta.faces.component.UIInput.setValueChangeListener(MethodBinding)	Use UIInput.addValueChangeListener(jakarta.faces.event.ValueChangeListener) instead, obtaining the argument ValueChangeListener by creating an instance of MethodExpressionValueChangeListener.
jakarta.faces.component.UISelectBoolean.getValueBinding(String)	This has been replaced by UISelectBoolean.getValueExpression(java.lang.String).
jakarta.faces.component.UISelectBoolean.setValueBinding(String, ValueBinding)	This has been replaced by UISelectBoolean.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UISelectMany.getValueBinding(String)	this has been replaced by UISelectMany.getValueExpression(java.lang.String).
jakarta.faces.component.UISelectMany.setValueBinding(String, ValueBinding)	This has been replaced by UISelectMany.setValueExpression(java.lang.String, jakarta.el.ValueExpression).
jakarta.faces.component.UIViewAction.getAction()
jakarta.faces.component.UIViewAction.getActionListener()
jakarta.faces.component.UIViewAction.setAction(MethodBinding)
jakarta.faces.component.UIViewAction.setActionListener(MethodBinding)
jakarta.faces.render.ResponseStateManager.getComponentStateToRestore(FacesContext)	This method has been replaced by ResponseStateManager.getState(jakarta.faces.context.FacesContext, java.lang.String). The default implementation returns null.
jakarta.faces.render.ResponseStateManager.getTreeStructureToRestore(FacesContext, String)	This method has been replaced by ResponseStateManager.getState(jakarta.faces.context.FacesContext, java.lang.String). The default implementation returns null.
jakarta.faces.render.ResponseStateManager.writeState(FacesContext, StateManager.SerializedView)	This method has been replaced by ResponseStateManager.writeState(jakarta.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(jakarta.faces.context.FacesContext, java.lang.Object).
jakarta.faces.view.facelets.FaceletCache.setMemberFactories(FaceletCache.MemberFactory<V>, FaceletCache.MemberFactory<V>)
jakarta.faces.webapp.UIComponentClassicTagBase.encodeBegin()	No encoding is done during Jakarta Server Pages page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.
jakarta.faces.webapp.UIComponentClassicTagBase.encodeChildren()	No encoding is done during Jakarta Server Pages page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.
jakarta.faces.webapp.UIComponentClassicTagBase.encodeEnd()	No encoding is done during Jakarta Server Pages page execution. Encoding is deferred until the page has completed executing to allow the entire tree to be built before any encoding occurs.
jakarta.faces.webapp.UIComponentClassicTagBase.setupResponseWriter()	ViewHandler.renderView(jakarta.faces.context.FacesContext, jakarta.faces.component.UIViewRoot) is now responsible for setting up the response writer. This method is now a no-op.

Constructors

Constructor	Description
jakarta.faces.application.ApplicationFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.ApplicationWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.ConfigurableNavigationHandlerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.NavigationCaseWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.NavigationHandlerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.ResourceHandlerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.ResourceWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.StateManagerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.application.ViewHandlerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.component.visit.VisitContextFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.component.visit.VisitContextWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.ExceptionHandlerFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.ExceptionHandlerWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.ExternalContextFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.ExternalContextWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.FacesContextFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.FacesContextWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.FlashFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.FlashWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.PartialViewContextFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.PartialViewContextWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.context.ResponseWriterWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.flow.FlowHandlerFactoryWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.lifecycle.ClientWindowFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.lifecycle.ClientWindowWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.lifecycle.LifecycleFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.lifecycle.LifecycleWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.render.RendererWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.render.RenderKitFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.render.RenderKitWrapper()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.view.facelets.FaceletCacheFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.view.facelets.TagHandlerDelegateFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.view.ViewDeclarationLanguageFactory()	Use the other constructor taking the implementation being wrapped.
jakarta.faces.view.ViewDeclarationLanguageWrapper()	Use the other constructor taking the implementation being wrapped.