public class ResourceBundleELResolver extends ELResolver
ResourceBundle
.
This resolver handles base objects of type java.util.ResourceBundle
. It accepts any object as a property
and coerces it to a java.lang.String
for invoking
ResourceBundle.getObject(java.lang.String)
.
This resolver is read only and will throw a PropertyNotWritableException
if setValue
is called.
ELResolver
s are combined together using CompositeELResolver
s, to define rich semantics for
evaluating an expression. See the javadocs for ELResolver
for details.
CompositeELResolver
,
ELResolver
,
ResourceBundle
RESOLVABLE_AT_DESIGN_TIME, TYPE
Constructor and Description |
---|
ResourceBundleELResolver() |
Modifier and Type | Method and Description |
---|---|
java.lang.Class<?> |
getCommonPropertyType(ELContext context,
java.lang.Object base)
If the base object is a ResourceBundle, returns the most general type that this resolver accepts for the
property argument. |
java.util.Iterator<java.beans.FeatureDescriptor> |
getFeatureDescriptors(ELContext context,
java.lang.Object base)
Deprecated.
This method will be removed without replacement in EL 6.0
|
java.lang.Class<?> |
getType(ELContext context,
java.lang.Object base,
java.lang.Object property)
If the base object is an instance of
ResourceBundle , return null , since the resolver is
read only. |
java.lang.Object |
getValue(ELContext context,
java.lang.Object base,
java.lang.Object property)
If the base object is an instance of
ResourceBundle , the provided property will first be coerced to a
String . |
boolean |
isReadOnly(ELContext context,
java.lang.Object base,
java.lang.Object property)
If the base object is not null and an
instanceof ResourceBundle , return true . |
void |
setValue(ELContext context,
java.lang.Object base,
java.lang.Object property,
java.lang.Object value)
If the base object is a ResourceBundle, throw a
PropertyNotWritableException . |
convertToType, invoke
public java.lang.Object getValue(ELContext context, java.lang.Object base, java.lang.Object property)
ResourceBundle
, the provided property will first be coerced to a
String
. The Object
returned by getObject
on the base
ResourceBundle
will be returned.
If the base is ResourceBundle
, the propertyResolved
property of the ELContext
object must be set to true
by this resolver, before returning. If this property is not true
after this method is called, the caller should ignore the return value.
getValue
in class ELResolver
context
- The context of this evaluation.base
- The ResourceBundle to analyze.property
- The name of the property to analyze. Will be coerced to a String
.propertyResolved
property of ELContext
was set to true
, then
null
if property is null
; otherwise the Object
for the given key (property
coerced to String
) from the ResourceBundle
. If no object for the given key can be found,
then the String
"???" + key + "???".java.lang.NullPointerException
- if context is null
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.public java.lang.Class<?> getType(ELContext context, java.lang.Object base, java.lang.Object property)
ResourceBundle
, return null
, since the resolver is
read only.
If the base is ResourceBundle
, the propertyResolved
property of the ELContext
object must be set to true
by this resolver, before returning. If this property is not true
after this method is called, the caller should ignore the return value.
getType
in class ELResolver
context
- The context of this evaluation.base
- The ResourceBundle to analyze.property
- The name of the property to analyze.propertyResolved
property of ELContext
was set to true
, then
null
; otherwise undefined.java.lang.NullPointerException
- if context is null
public void setValue(ELContext context, java.lang.Object base, java.lang.Object property, java.lang.Object value)
PropertyNotWritableException
.setValue
in class ELResolver
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.java.lang.NullPointerException
- if context is null
.PropertyNotWritableException
- Always thrown if base is an instance of ReasourceBundle.public boolean isReadOnly(ELContext context, java.lang.Object base, java.lang.Object property)
instanceof
ResourceBundle
, return true
.isReadOnly
in class ELResolver
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.propertyResolved
property of ELContext
was set to true
, then
true
; otherwise undefined.java.lang.NullPointerException
- if context is null
@Deprecated public java.util.Iterator<java.beans.FeatureDescriptor> getFeatureDescriptors(ELContext context, java.lang.Object base)
Iterator
containing the set of keys available in the
ResourceBundle
. Otherwise, returns null
.
The Iterator
returned must contain zero or more instances of FeatureDescriptor
. Each
info object contains information about a key in the ResourceBundle, and is initialized as follows:
String
key
false
false
true
FeatureDescriptor
s:
ELResolver.TYPE
- String.class
ELResolver.RESOLVABLE_AT_DESIGN_TIME
- true
getFeatureDescriptors
in class ELResolver
context
- The context of this evaluation.base
- The bundle whose keys are to be iterated over. Only bases of type ResourceBundle
are handled
by this resolver.Iterator
containing zero or more (possibly infinitely more) FeatureDescriptor
objects, each representing a key in this bundle, or null
if the base object is not a ResourceBundle.FeatureDescriptor
public java.lang.Class<?> getCommonPropertyType(ELContext context, java.lang.Object base)
property
argument. Otherwise, returns null
.
Assuming the base is a ResourceBundle
, this method will always return String.class
.
getCommonPropertyType
in class ELResolver
context
- The context of this evaluation.base
- The bundle to analyze. Only bases of type ResourceBundle
are handled by this resolver.null
if base is not a ResourceBundle
; otherwise String.class
.