- java.lang.Object
-
- javax.el.ELResolver
-
- javax.el.ResourceBundleELResolver
-
public class ResourceBundleELResolver extends ELResolver
Defines property resolution behavior on instances ofResourceBundle
.This resolver handles base objects of type
java.util.ResourceBundle
. It accepts any object as a property and coerces it to ajava.lang.String
for invokingResourceBundle.getObject(java.lang.String)
.This resolver is read only and will throw a
PropertyNotWritableException
ifsetValue
is called.ELResolver
s are combined together usingCompositeELResolver
s, to define rich semantics for evaluating an expression. See the javadocs forELResolver
for details.- Since:
- JSP 2.1
- See Also:
CompositeELResolver
,ELResolver
,ResourceBundle
-
-
Field Summary
-
Fields inherited from class javax.el.ELResolver
RESOLVABLE_AT_DESIGN_TIME, TYPE
-
-
Constructor Summary
Constructors Constructor and Description ResourceBundleELResolver()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description Class<?>
getCommonPropertyType(ELContext context, Object base)
If the base object is a ResourceBundle, returns the most general type that this resolver accepts for theproperty
argument.Iterator<FeatureDescriptor>
getFeatureDescriptors(ELContext context, Object base)
If the base object is a ResourceBundle, returns anIterator
containing the set of keys available in theResourceBundle
.Class<?>
getType(ELContext context, Object base, Object property)
If the base object is an instance ofResourceBundle
, returnnull
, since the resolver is read only.Object
getValue(ELContext context, Object base, Object property)
If the base object is an instance ofResourceBundle
, the provided property will first be coerced to aString
.boolean
isReadOnly(ELContext context, Object base, Object property)
If the base object is not null and an instanceofResourceBundle
, returntrue
.void
setValue(ELContext context, Object base, Object property, Object value)
If the base object is a ResourceBundle, throw aPropertyNotWritableException
.-
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 is an instance ofResourceBundle
, the provided property will first be coerced to aString
. TheObject
returned bygetObject
on the baseResourceBundle
will be returned. If the base isResourceBundle
, thepropertyResolved
property of theELContext
object must be set totrue
by this resolver, before returning. 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
- The ResourceBundle to analyze.property
- The name of the property to analyze. Will be coerced to aString
.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, thennull
if property isnull
; otherwise theObject
for the given key (property coerced toString
) from theResourceBundle
. If no object for the given key can be found, then theString
"???" + key + "???". - 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 is an instance ofResourceBundle
, returnnull
, since the resolver is read only.If the base is
ResourceBundle
, thepropertyResolved
property of theELContext
object must be set totrue
by this resolver, before returning. 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
- The ResourceBundle to analyze.property
- The name of the property to analyze.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, thennull
; otherwise undefined. - Throws:
NullPointerException
- if context isnull
-
setValue
public void setValue(ELContext context, Object base, Object property, Object value)
If the base object is a ResourceBundle, throw aPropertyNotWritableException
.- Specified by:
setValue
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- The ResourceBundle to be modified. Only bases that are of type ResourceBundle are handled.property
- The String property to use.value
- The value to be set.- Throws:
NullPointerException
- if context isnull
.PropertyNotWritableException
- Always thrown if base is an instance of ReasourceBundle.
-
isReadOnly
public boolean isReadOnly(ELContext context, Object base, Object property)
If the base object is not null and an instanceofResourceBundle
, returntrue
.- Specified by:
isReadOnly
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- The ResourceBundle to be modified. Only bases that are of type ResourceBundle are handled.property
- The String property to use.- Returns:
- If the
propertyResolved
property ofELContext
was set totrue
, thentrue
; otherwise undefined. - Throws:
NullPointerException
- if context isnull
-
getFeatureDescriptors
public Iterator<FeatureDescriptor> getFeatureDescriptors(ELContext context, Object base)
If the base object is a ResourceBundle, returns anIterator
containing the set of keys available in theResourceBundle
. Otherwise, returnsnull
.The
Iterator
returned must contain zero or more instances ofFeatureDescriptor
. Each info object contains information about a key in the ResourceBundle, and is initialized as follows:- displayName - The
String
key- name - Same as displayName property.
- shortDescription - Empty string
- expert -
false
- hidden -
false
- preferred -
In addition, the following named attributes must be set in the returnedtrue
FeatureDescriptor
s:ELResolver.TYPE
-String.class
ELResolver.RESOLVABLE_AT_DESIGN_TIME
-true
- Specified by:
getFeatureDescriptors
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- The bundle whose keys are to be iterated over. Only bases of typeResourceBundle
are handled by this resolver.- Returns:
- An
Iterator
containing zero or more (possibly infinitely more)FeatureDescriptor
objects, each representing a key in this bundle, ornull
if the base object is not a ResourceBundle. - See Also:
FeatureDescriptor
- displayName - The
-
getCommonPropertyType
public Class<?> getCommonPropertyType(ELContext context, Object base)
If the base object is a ResourceBundle, returns the most general type that this resolver accepts for theproperty
argument. Otherwise, returnsnull
.Assuming the base is a
ResourceBundle
, this method will always returnString.class
.- Specified by:
getCommonPropertyType
in classELResolver
- Parameters:
context
- The context of this evaluation.base
- The bundle to analyze. Only bases of typeResourceBundle
are handled by this resolver.- Returns:
null
if base is not aResourceBundle
; otherwiseString.class
.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 22:43:46 Cette version de la page est en cache (à la date du 21/08/2025 22:43:46) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 07/12/2007, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/el/resourcebundleelresolver.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.