Deprecated API

Contents

• Packages
• Interfaces
• Classes
• Exceptions
• Fields
• Methods

Deprecated Packages

Package	Description
javax.faces.bean

Deprecated Interfaces

Interface	Description
javax.resource.spi.security.GenericCredential	The preferred way to represent generic credential information is via the org.ietf.jgss.GSSCredential interface in J2SE Version 1.4, which provides similar functionality.
javax.servlet.jsp.el.FunctionMapper	As of JSP 2.1, replaced by FunctionMapper
javax.servlet.jsp.el.VariableResolver	As of JSP 2.1, replaced by ELResolver
javax.xml.bind.Validator	since JAXB 2.0

Deprecated Classes

Class	Description
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.el.MethodBinding	This has been replaced by MethodExpression.
javax.faces.el.PropertyResolver	This has been replaced by ELResolver.
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.
javax.faces.view.facelets.ResourceResolver
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.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.servlet.jsp.el.Expression	As of JSP 2.1, replaced by ValueExpression
javax.servlet.jsp.el.ExpressionEvaluator	As of JSP 2.1, replaced by ExpressionFactory

Deprecated Exceptions

Exceptions	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.
javax.servlet.jsp.el.ELException	As of JSP 2.1, replaced by ELException
javax.servlet.jsp.el.ELParseException	As of JSP 2.1, replaced by ELException

Deprecated Fields

Field	Description
javax.faces.component.NamingContainer.SEPARATOR_CHAR	use UINamingContainer.getSeparatorChar(javax.faces.context.FacesContext)
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.persistence.Persistence.PERSISTENCE_PROVIDER
javax.persistence.Persistence.providers

Deprecated Methods

Method	Description
javax.ejb.EJBContext.getCallerIdentity()	Use Principal getCallerPrincipal() instead.
javax.ejb.EJBContext.getEnvironment()	Use the JNDI naming context java:comp/env to access enterprise bean's environment.
javax.ejb.EJBContext.isCallerInRole(Identity)	Use boolean isCallerInRole(String roleName) instead.
javax.el.MethodExpression.isParmetersProvided()
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.application.Application.getPropertyResolver()	This has been replaced by Application.getELResolver().
javax.faces.application.Application.getVariableResolver()	This has been replaced by Application.getELResolver().
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.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.createComponent(ValueBinding, FacesContext, String)	See superclass for alternative.
javax.faces.application.ApplicationWrapper.createMethodBinding(String, Class<?>[])	See superclass for alternative.
javax.faces.application.ApplicationWrapper.evaluateExpressionGet(FacesContext, String, Class<? extends T>)	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)	See superclass for alternative.
javax.faces.application.ApplicationWrapper.setVariableResolver(VariableResolver)	See superclass for alternative.
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.getTreeStructureToSave(FacesContext)	the distinction between tree structure and component state is now an implementation detail. The default implementation returns null.
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.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.component.ActionSource.getAction()	This has been replaced by ActionSource2.getActionExpression().
javax.faces.component.ActionSource.getActionListener()	Use ActionSource.getActionListeners() instead.
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.EditableValueHolder.getValidator()	EditableValueHolder.getValidators() should be used instead.
javax.faces.component.EditableValueHolder.getValueChangeListener()	Use EditableValueHolder.getValueChangeListeners() instead.
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.EditableValueHolder.setValueChangeListener(MethodBinding)	Use EditableValueHolder.addValueChangeListener(javax.faces.event.ValueChangeListener) instead, obtaining the argument ValueChangeListener by creating an instance of MethodExpressionValueChangeListener.
javax.faces.component.UICommand.getAction()	This has been replaced by UICommand.getActionExpression().
javax.faces.component.UICommand.getActionListener()	Use UICommand.getActionListeners() instead.
javax.faces.component.UICommand.setAction(MethodBinding)	This has been replaced by UICommand.setActionExpression(javax.el.MethodExpression).
javax.faces.component.UICommand.setActionListener(MethodBinding)	This has been replaced by UICommand.addActionListener(javax.faces.event.ActionListener).
javax.faces.component.UIComponent.getValueBinding(String)	This has been replaced by UIComponent.getValueExpression(java.lang.String).
javax.faces.component.UIComponent.setValueBinding(String, ValueBinding)	This has been replaced by UIComponent.setValueExpression(java.lang.String, javax.el.ValueExpression).
javax.faces.component.UIComponentBase.getValueBinding(String)	This has been replaced by UIComponent.getValueExpression(java.lang.String).
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.getValueBinding(String)	This has been replaced by UIGraphic.getValueExpression(java.lang.String).
javax.faces.component.UIGraphic.setValueBinding(String, ValueBinding)	This has been replaced by UIGraphic.setValueExpression(java.lang.String, javax.el.ValueExpression).
javax.faces.component.UIInput.getValidator()	UIInput.getValidators() should be used instead.
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.setValueChangeListener(MethodBinding)	Use UIInput.addValueChangeListener(javax.faces.event.ValueChangeListener) instead, obtaining the argument ValueChangeListener by creating an instance of MethodExpressionValueChangeListener.
javax.faces.component.UISelectBoolean.getValueBinding(String)	This has been replaced by UISelectBoolean.getValueExpression(java.lang.String).
javax.faces.component.UISelectBoolean.setValueBinding(String, ValueBinding)	This has been replaced by UISelectBoolean.setValueExpression(java.lang.String, javax.el.ValueExpression).
javax.faces.component.UISelectMany.getValueBinding(String)	this has been replaced by UISelectMany.getValueExpression(java.lang.String).
javax.faces.component.UISelectMany.setValueBinding(String, ValueBinding)	This has been replaced by UISelectMany.setValueExpression(java.lang.String, javax.el.ValueExpression).
javax.faces.component.UIViewAction.getAction()
javax.faces.component.UIViewAction.getActionListener()
javax.faces.component.UIViewAction.setAction(MethodBinding)
javax.faces.component.UIViewAction.setActionListener(MethodBinding)
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.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.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.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.resource.cci.ResourceWarning.getLinkedWarning()	J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.
javax.resource.cci.ResourceWarning.setLinkedWarning(ResourceWarning)	J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.
javax.resource.ResourceException.getLinkedException()	J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class..
javax.resource.ResourceException.setLinkedException(Exception)	J2SE release 1.4 supports a chained exception facility that allows any throwable to know about another throwable, if any, that caused it to get thrown. Refer to getCause and initCause methods of the java.lang.Throwable class.
javax.servlet.http.HttpServletResponse.setStatus(int, String)	As of version 2.1, due to ambiguous meaning of the message parameter. To set a status code use setStatus(int), to send an error with a description use sendError(int, String). Sets the status code and message for this response.
javax.servlet.http.HttpServletResponseWrapper.encodeRedirectUrl(String)	As of version 2.1, use HttpServletResponseWrapper.encodeRedirectURL(String url) instead
javax.servlet.http.HttpServletResponseWrapper.encodeUrl(String)	As of version 2.1, use HttpServletResponseWrapper.encodeURL(String url) instead
javax.servlet.http.HttpServletResponseWrapper.setStatus(int, String)	As of version 2.1, due to ambiguous meaning of the message parameter. To set a status code use HttpServletResponseWrapper.setStatus(int), to send an error with a description use HttpServletResponseWrapper.sendError(int, String)
javax.servlet.http.HttpSession.getSessionContext()	As of Version 2.1, this method is deprecated and has no replacement. It will be removed in a future version of the Java Servlet API.
javax.servlet.http.HttpSession.getValue(String)	As of Version 2.2, this method is replaced by HttpSession.getAttribute(java.lang.String).
javax.servlet.http.HttpSession.getValueNames()	As of Version 2.2, this method is replaced by HttpSession.getAttributeNames()
javax.servlet.http.HttpSession.putValue(String, Object)	As of Version 2.2, this method is replaced by HttpSession.setAttribute(java.lang.String, java.lang.Object)
javax.servlet.http.HttpSession.removeValue(String)	As of Version 2.2, this method is replaced by HttpSession.removeAttribute(java.lang.String)
javax.servlet.http.HttpSessionContext.getSession(String)	As of Java Servlet API 2.1 with no replacement. This method must return null and will be removed in a future version of this API.
javax.servlet.jsp.JspContext.getExpressionEvaluator()	As of JSP 2.1, replaced by JspApplicationContext.getExpressionFactory()
javax.servlet.jsp.JspContext.getVariableResolver()	As of JSP 2.1, replaced by ELContext.getELResolver(), which can be obtained by jspContext.getELContext().getELResolver().
javax.servlet.jsp.JspException.getRootCause()	As of JSP 2.1, replaced by Throwable.getCause()
javax.servlet.ServletRequest.getRealPath(String)	As of Version 2.1 of the Java Servlet API, use ServletContext.getRealPath(java.lang.String) instead.
javax.servlet.ServletRequestWrapper.getRealPath(String)	As of Version 2.1 of the Java Servlet API, use ServletContext.getRealPath(java.lang.String) instead
javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.addNode(String)	since 1.1 - replaced by ConstraintValidatorContext.ConstraintViolationBuilder.addPropertyNode(String), ConstraintValidatorContext.ConstraintViolationBuilder.addBeanNode() and ConstraintValidatorContext.ConstraintViolationBuilder.addParameterNode(int)
javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext.addNode(String)	since 1.1 - replaced by ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext.addPropertyNode(String) and ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderCustomizableContext.addBeanNode()
javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext.addNode(String)	since 1.1 - replaced by ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext.addPropertyNode(String) and ConstraintValidatorContext.ConstraintViolationBuilder.NodeBuilderDefinedContext.addBeanNode()
javax.validation.ConstraintValidatorContext.ConstraintViolationBuilder.NodeContextBuilder.addNode(String)	since 1.1 - replaced by ConstraintValidatorContext.ConstraintViolationBuilder.NodeContextBuilder.addPropertyNode(String) and ConstraintValidatorContext.ConstraintViolationBuilder.NodeContextBuilder.addBeanNode()
javax.xml.bind.JAXBContext.createValidator()	since JAXB2.0
javax.xml.bind.Unmarshaller.isValidating()	since JAXB2.0, please see Unmarshaller.getSchema()
javax.xml.bind.Unmarshaller.setValidating(boolean)	since JAXB2.0, please see Unmarshaller.setSchema(javax.xml.validation.Schema)
javax.xml.bind.Validator.getEventHandler()	since JAXB2.0
javax.xml.bind.Validator.getProperty(String)	since JAXB2.0
javax.xml.bind.Validator.setEventHandler(ValidationEventHandler)	since JAXB2.0
javax.xml.bind.Validator.setProperty(String, Object)	since JAXB2.0
javax.xml.bind.Validator.validate(Object)	since JAXB2.0
javax.xml.bind.Validator.validateRoot(Object)	since JAXB2.0