- java.lang.Object
-
- javax.el.ELResolver
-
- javax.servlet.jsp.el.ImplicitObjectELResolver
-
public class ImplicitObjectELResolver extends ELResolver
Defines variable resolution behavior for the EL implicit objects defined in the JSP specification.The following variables are resolved by this
ELResolver
, as per the JSP specification:pageContext
- thePageContext
object.pageScope
- aMap
that maps page-scoped attribute names to their values.requestScope
- aMap
that maps request-scoped attribute names to their values.sessionScope
- aMap
that maps session-scoped attribute names to their values.applicationScope
- aMap
that maps application-scoped attribute names to their values.param
- aMap
that maps parameter names to a single String parameter value (obtained by callingServletRequest.getParameter(String name)).
paramValues
- aMap
that maps parameter names to aString[]
of all values for that parameter (obtained by callingServletRequest.getParameterValues(String name))
.header
- aMap
that maps header names to a single String header value (obtained by callingHttpServletRequest.getHeader(String name))
.headerValues
- aMap
that maps header names to aString[]
of all values for that header (obtained by callingHttpServletRequest.getHeaders(String))
.cookie
- aMap
that maps cookie names to a singleCookie
object. Cookies are retrieved according to the semantics ofHttpServletRequest.getCookies()
. If the same name is shared by multiple cookies, an implementation must use the first one encountered in the array ofCookie
objects returned by thegetCookies()
method. However, users of the cookie implicit object must be aware that the ordering of cookies is currently unspecified in the servlet specification.initParam
- aMap
that maps context initialization parameter names to their String parameter value (obtained by callingServletContext.getInitParameter(String name))
.
- Since:
- JSP 2.1
- See Also:
ELResolver
-
-
Field Summary
-
Fields inherited from class javax.el.ELResolver
RESOLVABLE_AT_DESIGN_TIME, TYPE
-
-
Constructor Summary
Constructors Constructor and Description ImplicitObjectELResolver()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description Class<String>
getCommonPropertyType(ELContext context, Object base)
If the base object isnull
, returnsString.class
.Iterator<FeatureDescriptor>
getFeatureDescriptors(ELContext context, Object base)
If the base object isnull
, and the property matches the name of a JSP implicit object, returns anIterator
containingFeatureDescriptor
objects with information about each JSP implicit object resolved by this resolver.Class
getType(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returnsnull
to indicate that no types are ever accepted tosetValue()
.Object
getValue(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returns the implicit object.boolean
isReadOnly(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returnstrue
to indicate that implicit objects cannot be overwritten.void
setValue(ELContext context, Object base, Object property, Object val)
If the base object isnull
, and the property matches the name of a JSP implicit object, throwsPropertyNotWritableException
to indicate that implicit objects cannot be overwritten.-
Methods inherited from class javax.el.ELResolver
convertToType, invoke
-
-
-
-
Method Detail
-
getValue
public Object getValue(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returns the implicit object.The
propertyResolved
property of theELContext
object must be set totrue
by this resolver before returning if an implicit object is matched. If this property is nottrue
after this method is called, the caller should ignore the return value.- Specified by:
getValue
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in an immediate return.property
- The name of the implicit object to resolve.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, then the implicit object; otherwise undefined. - Throws:
NullPointerException
- if context isnull
ELException
- if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.
-
getType
public Class getType(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returnsnull
to indicate that no types are ever accepted tosetValue()
.The
propertyResolved
property of theELContext
object must be set totrue
by this resolver before returning if an implicit object is matched. If this property is nottrue
after this method is called, the caller should ignore the return value.- Specified by:
getType
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in an immediate return.property
- The name of the implicit object to resolve.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, thennull
; otherwise undefined. - Throws:
NullPointerException
- if context isnull
ELException
- if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.
-
setValue
public void setValue(ELContext context, Object base, Object property, Object val)
If the base object isnull
, and the property matches the name of a JSP implicit object, throwsPropertyNotWritableException
to indicate that implicit objects cannot be overwritten.The
propertyResolved
property of theELContext
object must be set totrue
by this resolver before returning if an implicit object is matched. If this property is nottrue
after this method is called, the caller should ignore the return value.- Specified by:
setValue
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in an immediate return.property
- The name of the implicit object.val
- The value to be associated with the implicit object.- Throws:
NullPointerException
- if context isnull
.PropertyNotWritableException
- always thrown, if the implicit object name is recognized by this resolver.ELException
- if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.
-
isReadOnly
public boolean isReadOnly(ELContext context, Object base, Object property)
If the base object isnull
, and the property matches the name of a JSP implicit object, returnstrue
to indicate that implicit objects cannot be overwritten.The
propertyResolved
property of theELContext
object must be set totrue
by this resolver before returning if an implicit object is matched. If this property is nottrue
after this method is called, the caller should ignore the return value.- Specified by:
isReadOnly
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in an immediate return.property
- The name of the implicit object.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, thentrue
; otherwise undefined. - Throws:
NullPointerException
- if context isnull
.ELException
- if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.
-
getFeatureDescriptors
public Iterator<FeatureDescriptor> getFeatureDescriptors(ELContext context, Object base)
If the base object isnull
, and the property matches the name of a JSP implicit object, returns anIterator
containingFeatureDescriptor
objects with information about each JSP implicit object resolved by this resolver. Otherwise, returnsnull
.The
Iterator
returned must contain one instance ofFeatureDescriptor
for each of the EL implicit objects defined by the JSP spec. Each info object contains information about a single implicit object, and is initialized as follows:- displayName - The name of the implicit object.
- name - Same as displayName property.
- shortDescription - A suitable description for the implicit object. Will vary by implementation.
- expert -
false
- hidden -
false
- preferred -
In addition, the following named attributes must be set in the returnedtrue
FeatureDescriptor
s:ELResolver.TYPE
- The runtime type of the implicit object.ELResolver.RESOLVABLE_AT_DESIGN_TIME
-true
.- Specified by:
getFeatureDescriptors
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in anull
return value.- Returns:
- An
Iterator
containing oneFeatureDescriptor
object for each implicit object, ornull
ifbase
is notnull
. - See Also:
FeatureDescriptor
-
getCommonPropertyType
public Class<String> getCommonPropertyType(ELContext context, Object base)
If the base object isnull
, returnsString.class
. Otherwise, returnsnull
.- Specified by:
getCommonPropertyType
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- Onlynull
is handled by this resolver. Other values will result in anull
return value.- Returns:
null
if base is notnull
; otherwiseString.class
.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/servlet/jsp/el/ImplicitObjectELResolver.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.