Deprecated API
Contents
-
InterfaceDescriptionAs of Java(tm) Servlet API 2.1 for security reasons, with no replacement. This interface will be removed in a future version of this API.As of JSP 2.1, replaced by
FunctionMapper
As of JSP 2.1, replaced byELResolver
As of Java Servlet API 2.4, with no direct replacement.since JAXB 2.0
-
ClassDescriptionThis 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 beSerializable
. Therefore, it is being deprecated in version 1.2 of the spec. The replacement is to use an implementation dependentObject
.This has been replaced byMethodExpression
.This has been replaced byELResolver
.This has been replaced byValueExpression
.The Faces implementation must now provide the implementation for this class.This has been partially replaced byConverterELTag
. The remainder of the functionality, namely, the binding facility and the implementation of theConverterTag.createConverter()
method, is now an implementation detail.All component tags now implementBodyTag
. This class has been replaced byUIComponentELTag
.Use of this class has been replaced withUIComponentELTag
, which extendsUIComponentClassicTagBase
to add properties that use the Jakarta Expression Language API introduced as part of Jakarta Server Pages 2.1.This has been partially replaced byValidatorELTag
. The remainder of the functionality, namely, the binding facility and the implementation of theValidatorTag.createValidator()
method, is now an implementation detail.As of Java(tm) Servlet API 2.3. These methods were only useful with the default encoding and have been moved to the request interfaces.As of JSP 2.1, replaced byValueExpression
As of JSP 2.1, replaced byExpressionFactory
- Usejakarta.xml.soap.SOAPFactory
for creating SOAPElements.
-
ExceptionsDescriptionThis has been replaced by
ELException
.This has been replaced byMethodNotFoundException
.This has been replaced byPropertyNotFoundException
.This has been replaced byELException
.As of JSP 2.1, replaced byELException
As of JSP 2.1, replaced byELException
-
Annotation InterfaceDescriptionThis has been replaced by
jakarta.enterprise.context.ApplicationScoped
, which is a CDI build-in scope with similar semantics.This has been replaced by CDI custom scopes andjakarta.enterprise.context.spi.Context
. See 2.4.2 and 6.2 of the CDI specification for further details.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 thejakarta.enterprise.context.Initialized
event forjakarta.enterprise.context.ApplicationScoped
. See 6.7.3 of the CDI spec for further details.This has been replaced byjakarta.faces.annotation.ManagedProperty
, which is a CDI build-in bean with similar semanticsThis has been replaced byjakarta.enterprise.context.Dependent
, which is a CDI build-in scope with approximately similar semantics.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.This has been replaced byjakarta.enterprise.context.RequestScoped
, which is a CDI build-in scope with similar semantics.This has been replaced byjakarta.enterprise.context.SessionScoped
, which is a CDI build-in scope with similar semantics.This has been replaced byjakarta.faces.view.ViewScoped
. The functionality of this corresponding annotation is identical to this one, but it is implemented as a CDI custom scope.As of JSR-181 2.0 with no replacement.
-
FieldDescriptionTODO: Either change TCK reference to PERSISTENCE_PROVIDER field to expect "jakarta.persistence.spi.PersistenceProvider" or remove PERSISTENCE_PROVIDER field and also update TCK signature tests.As of Java JSP API 1.2, use BodyTag.EVAL_BODY_BUFFERED or IterationTag.EVAL_BODY_AGAIN.
-
MethodDescriptionAs inconsistent with
hashCode()
contract, useisMimeTypeEqual(String)
instead.This has been replaced byApplication.createComponent(jakarta.el.ValueExpression,jakarta.faces.context.FacesContext,java.lang.String)
.This has been replaced by callingApplication.getExpressionFactory()
thenExpressionFactory.createMethodExpression(jakarta.el.ELContext, java.lang.String, java.lang.Class<?>, java.lang.Class<?>[])
.This has been replaced by callingApplication.getExpressionFactory()
thenExpressionFactory.createValueExpression(jakarta.el.ELContext, java.lang.String, java.lang.Class<?>)
.This has been replaced byApplication.getELResolver()
.This has been replaced byApplication.getELResolver()
.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 argumentresolver
to be wrapped inside an implementation ofELResolver
and exposed to the Jakarta Expression Language resolution system as if the user had calledApplication.addELResolver(jakarta.el.ELResolver)
.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 argumentresolver
to be wrapped inside an implementation ofELResolver
and exposed to the Jakarta Expression Language resolution system as if the user had calledApplication.addELResolver(jakarta.el.ELResolver)
.See superclass for alternative.See superclass for alternative.See superclass for alternative.See superclass for alternative.See superclass for alternative.See superclass for alternative.See superclass for alternative.the distinction between tree structure and component state is now an implementation detail. The default implementation returnsnull
.the distinction between tree structure and component state is now an implementation detail. The default implementation returnsnull
.the distinction between tree structure and component state is now an implementation detail. The default implementation does nothing.the distinction between tree structure and component state is now an implementation detail. The default implementation returnsnull
.this has been replaced byStateManager.saveView(jakarta.faces.context.FacesContext)
. The default implementation callssaveView
and inspects the return. If the return is anObject []
, it casts the result to anObject []
wrapping the first and second elements in an instance ofStateManager.SerializedView
, which it then returns. Otherwise, it returnsnull
This method has been replaced byStateManager.writeState(jakarta.faces.context.FacesContext,java.lang.Object)
. The default implementation calls the non-deprecated variant of the method passing anObject []
as the second argument, where the first element of the array is the return fromgetStructure()
and the second is the return fromgetState()
on the argumentstate
.This has been replaced byActionSource2.getActionExpression()
.UseActionSource.getActionListeners()
instead.This has been replaced byActionSource2.setActionExpression(jakarta.el.MethodExpression)
.This has been replaced byActionSource.addActionListener(jakarta.faces.event.ActionListener)
.EditableValueHolder.getValidators()
should be used instead.UseEditableValueHolder.getValueChangeListeners()
instead.UseEditableValueHolder.addValidator(jakarta.faces.validator.Validator)
instead, obtaining the argumentValidator
by creating an instance ofMethodExpressionValidator
.UseEditableValueHolder.addValueChangeListener(jakarta.faces.event.ValueChangeListener)
instead, obtaining the argumentValueChangeListener
by creating an instance ofMethodExpressionValueChangeListener
.This has been replaced byUICommand.getActionExpression()
.UseUICommand.getActionListeners()
instead.This has been replaced byUICommand.setActionExpression(jakarta.el.MethodExpression)
.This has been replaced byUICommand.addActionListener(jakarta.faces.event.ActionListener)
.This has been replaced byUIComponent.getValueExpression(java.lang.String)
.This has been replaced byUIComponent.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.This has been replaced byUIComponent.getValueExpression(java.lang.String)
.This has been replaced byUIComponent.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.This has been replaced byUIData.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.This has been replaced byUIGraphic.getValueExpression(java.lang.String)
.This has been replaced byUIGraphic.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.UIInput.getValidators()
should be used instead.UseUIInput.addValidator(jakarta.faces.validator.Validator)
instead, obtaining the argumentValidator
by creating an instance ofMethodExpressionValidator
.UseUIInput.addValueChangeListener(jakarta.faces.event.ValueChangeListener)
instead, obtaining the argumentValueChangeListener
by creating an instance ofMethodExpressionValueChangeListener
.This has been replaced byUISelectBoolean.getValueExpression(java.lang.String)
.This has been replaced byUISelectBoolean.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.this has been replaced byUISelectMany.getValueExpression(java.lang.String)
.This has been replaced byUISelectMany.setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.This method has been replaced byResponseStateManager.getState(jakarta.faces.context.FacesContext, java.lang.String)
. The default implementation returnsnull
.This method has been replaced byResponseStateManager.getState(jakarta.faces.context.FacesContext, java.lang.String)
. The default implementation returnsnull
.This method has been replaced byResponseStateManager.writeState(jakarta.faces.context.FacesContext,java.lang.Object)
. The default implementation creates a two elementObject
array with the first element being the return from callingStateManager.SerializedView.getStructure()
, and the second being the return fromStateManager.SerializedView.getState()
. It then passes thisObject
array toResponseStateManager.writeState(jakarta.faces.context.FacesContext, java.lang.Object)
.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.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.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.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.As of JSR-181 2.0 with no replacement.Java™ 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 togetCause
andinitCause
methods of thejava.lang.Throwable
class.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 togetCause
andinitCause
methods of thejava.lang.Throwable
class.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 togetCause
andinitCause
methods of thejava.lang.Throwable
class..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 togetCause
andinitCause
methods of thejava.lang.Throwable
class.As of Version 2.1 of the Java Servlet API, useHttpServletRequest.isRequestedSessionIdFromURL()
instead.As of Version 4.0 of the Java Servlet API, useHttpServletRequestWrapper.isRequestedSessionIdFromURL()
instead.As of version 2.1, use encodeRedirectURL(String url) insteadAs of version 2.1, use encodeURL(String url) insteadAs of version 2.1, due to ambiguous meaning of the message parameter. To set a status code usesetStatus(int)
, to send an error with a description usesendError(int, String)
. Sets the status code and message for this response.As of version 2.1, useHttpServletResponseWrapper.encodeRedirectURL(String url)
insteadAs of version 2.1, useHttpServletResponseWrapper.encodeURL(String url)
insteadAs of version 2.1, due to ambiguous meaning of the message parameter. To set a status code useHttpServletResponseWrapper.setStatus(int)
, to send an error with a description useHttpServletResponseWrapper.sendError(int, String)
As of Version 2.1, this method is deprecated and has no replacement. It will be removed in a future version of Jakarta Servlets.As of Version 2.2, this method is replaced byHttpSession.getAttribute(java.lang.String)
.As of Version 2.2, this method is replaced byHttpSession.getAttributeNames()
As of Version 2.2, this method is replaced byHttpSession.setAttribute(java.lang.String, java.lang.Object)
As of Version 2.2, this method is replaced byHttpSession.removeAttribute(java.lang.String)
As of Java Servlet API 2.1 with no replacement. This method must return an emptyEnumeration
and will be removed in a future version of this API.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.As of JSP 2.1, replaced byJspApplicationContext.getExpressionFactory()
As of JSP 2.1, replaced byELContext.getELResolver()
, which can be obtained byjspContext.getELContext().getELResolver()
.As of JSP 2.1, replaced byThrowable.getCause()
As of Java Servlet API 2.1, with no direct replacement.This method was originally defined to retrieve a servlet from a
ServletContext
. In this version, this method always returnsnull
and remains only to preserve binary compatibility. This method will be permanently removed in a future version of Jakarta Servlets.In lieu of this method, servlets can share information using the
ServletContext
class and can perform shared business logic by invoking methods on common non-servlet classes.As of Java Servlet API 2.1, with no replacement.This method was originally defined to return an
Enumeration
of all the servlet names known to this context. In this version, this method always returns an emptyEnumeration
and remains only to preserve binary compatibility. This method will be permanently removed in a future version of Jakarta Servlets.As of Java Servlet API 2.0, with no replacement.This method was originally defined to return an
Enumeration
of all the servlets known to this servlet context. In this version, this method always returns an empty enumeration and remains only to preserve binary compatibility. This method will be permanently removed in a future version of Jakarta Servlets.As of Java Servlet API 2.1, useServletContext.log(String message, Throwable throwable)
instead.This method was originally defined to write an exception's stack trace and an explanatory error message to the servlet log file.
As of Version 2.1 of the Java Servlet API, useServletContext.getRealPath(java.lang.String)
instead.As of Version 2.1 of the Java Servlet API, useServletContext.getRealPath(java.lang.String)
insteadAs of Java Servlet API 2.2, with no replacement. Returns the servlet that is reporting its unavailability.The format of the toString() method is subject to change in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(CacheControl.class).toString(value) instead if you rely on the format of this method.This method will be removed in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(CacheControl.class).fromString(value) instead.The format of the toString() method is subject to change in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(Cookie.class).toString(value) instead if you rely on the format of this method.This method will be removed in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(Cookie.class).fromString(value) instead.The format of the toString() method is subject to change in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(EntityTag.class).toString(value) instead if you rely on the format of this method.This method will be removed in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(EntityTag.class).fromString(value) instead.The format of the toString() method is subject to change in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(NewCookie.class).toString(value) instead if you rely on the format of this method.This method will be removed in a future version. Please use RuntimeDelegate.getInstance().createHeaderDelegate(NewCookie.class).fromString(value) instead.since JAXB2.0since JAXB2.0, please seeUnmarshaller.getSchema()
since JAXB2.0, please seeUnmarshaller.setSchema(javax.xml.validation.Schema)
since JAXB2.0since JAXB2.0since JAXB2.0since JAXB2.0since JAXB2.0since JAXB2.0Use jakarta.xml.soap.SOAPFactory.createElement(jakarta.xml.soap.Name) insteadUse jakarta.xml.soap.SOAPFactory.createElement(String localName) insteadUse jakarta.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) instead
-
ConstructorDescriptionUse the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.Use the other constructor taking the implementation being wrapped.As of Java Servlet API 2.2, use
UnavailableException(String, int)
instead.As of Java Servlet API 2.2, useUnavailableException(String)
instead.
-
Annotation Interface ElementDescriptionAs of JSR-181 2.0 with no replacement.
org.ietf.jgss.GSSCredential
interface in J2SE Version 1.4, which provides similar functionality.