|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.el.ELResolver
de.odysseus.el.util.SimpleResolver
public class SimpleResolver
Simple resolver implementation.
This resolver handles root properties (base == null
), which are
stored in a map. Resolving "real" properties (base != null
) is
delegated to a resolver specified at construction time.
Field Summary |
---|
Fields inherited from class javax.el.ELResolver |
---|
RESOLVABLE_AT_DESIGN_TIME, TYPE |
Constructor Summary | |
---|---|
SimpleResolver()
Create a read/write resolver capable of resolving top-level identifiers, array values, list values, map values, resource values and bean properties. |
|
SimpleResolver(boolean readOnly)
Create a resolver capable of resolving top-level identifiers, array values, list values, map values, resource values and bean properties. |
|
SimpleResolver(ELResolver delegate)
Create a read-write resolver capable of resolving top-level identifiers. |
|
SimpleResolver(ELResolver delegate,
boolean readOnly)
Create a resolver capable of resolving top-level identifiers. |
Method Summary | |
---|---|
java.lang.Class<?> |
getCommonPropertyType(ELContext context,
java.lang.Object base)
Returns the most general type that this resolver accepts for the property argument, given a base object. |
java.util.Iterator<java.beans.FeatureDescriptor> |
getFeatureDescriptors(ELContext context,
java.lang.Object base)
Returns information about the set of variables or properties that can be resolved for the given base object. |
java.lang.Class<?> |
getType(ELContext context,
java.lang.Object base,
java.lang.Object property)
For a given base and property, attempts to identify the most general type that is acceptable for an object to be passed as the value parameter in a future call to the ELResolver.setValue(ELContext, Object, Object, Object) method. |
java.lang.Object |
getValue(ELContext context,
java.lang.Object base,
java.lang.Object property)
Attempts to resolve the given property object on the given base object. |
boolean |
isReadOnly(ELContext context,
java.lang.Object base,
java.lang.Object property)
For a given base and property, attempts to determine whether a call to ELResolver.setValue(ELContext, Object, Object, Object) will always fail. |
void |
setValue(ELContext context,
java.lang.Object base,
java.lang.Object property,
java.lang.Object value)
Attempts to set the value of the given property object on the given base object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SimpleResolver(ELResolver delegate, boolean readOnly)
public SimpleResolver(ELResolver delegate)
public SimpleResolver(boolean readOnly)
public SimpleResolver()
Method Detail |
---|
public java.lang.Class<?> getCommonPropertyType(ELContext context, java.lang.Object base)
ELResolver
ArrayELResolver
will accept any int as a property, so the return value would be
Integer.class.
getCommonPropertyType
in class ELResolver
context
- The context of this evaluation.base
- The base object to return the most general property type for, or null to enumerate
the set of top-level variables that this resolver can evaluate.
public java.util.Iterator<java.beans.FeatureDescriptor> getFeatureDescriptors(ELContext context, java.lang.Object base)
ELResolver
ELResolver.getCommonPropertyType(ELContext, Object)
method should be used
instead. Each FeatureDescriptor will contain information about a single variable or property.
In addition to the standard properties, the FeatureDescriptor must have two named attributes
(as set by the setValue method):
ELResolver.TYPE
- The value of this named attribute must be an instance of java.lang.Class
and specify the runtime type of the variable or property.ELResolver.RESOLVABLE_AT_DESIGN_TIME
- The value of this named attribute must be an
instance of java.lang.Boolean and indicates whether it is safe to attempt to resolve this
property at designtime. For instance, it may be unsafe to attempt a resolution at design time
if the ELResolver needs access to a resource that is only available at runtime and no
acceptable simulated value can be provided.
getFeatureDescriptors
in class ELResolver
context
- The context of this evaluation.base
- The base object whose set of valid properties is to be enumerated, or null to
enumerate the set of top-level variables that this resolver can evaluate.
public java.lang.Class<?> getType(ELContext context, java.lang.Object base, java.lang.Object property) throws java.lang.NullPointerException, PropertyNotFoundException, ELException
ELResolver
ELResolver.setValue(ELContext, Object, Object, Object)
method. If this resolver handles the
given (base, property) pair, the propertyResolved property of the ELContext object must be
set to true by the resolver, before returning. If this property is not true after this method
is called, the caller should ignore the return value. This is not always the same as
getValue().getClass(). For example, in the case of an ArrayELResolver
, the getType
method will return the element type of the array, which might be a superclass of the type of
the actual element that is currently in the specified array element.
getType
in class ELResolver
context
- The context of this evaluation.base
- The base object whose property value is to be analyzed, or null to analyze a
top-level variable.property
- The property or variable to return the acceptable type for.
java.lang.NullPointerException
- if context is null
PropertyNotFoundException
- if the given (base, property) pair is handled by this ELResolver but the
specified variable or property does not exist or is not readable.
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.Object getValue(ELContext context, java.lang.Object base, java.lang.Object property) throws java.lang.NullPointerException, PropertyNotFoundException, ELException
ELResolver
getValue
in class ELResolver
context
- The context of this evaluation.base
- The base object whose property value is to be returned, or null to resolve a
top-level variable.property
- The property or variable to be resolved.
java.lang.NullPointerException
- if context is null
PropertyNotFoundException
- if the given (base, property) pair is handled by this ELResolver but the
specified variable or property does not exist or is not readable.
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 boolean isReadOnly(ELContext context, java.lang.Object base, java.lang.Object property) throws java.lang.NullPointerException, PropertyNotFoundException, ELException
ELResolver
ELResolver.setValue(ELContext, Object, Object, Object)
will always fail. If this resolver
handles the given (base, property) pair, the propertyResolved property of the ELContext
object must be set to true by the resolver, before returning. If this property is not true
after this method is called, the caller should ignore the return value.
isReadOnly
in class ELResolver
context
- The context of this evaluation.base
- The base object whose property value is to be analyzed, or null to analyze a
top-level variable.property
- The property or variable to return the read-only status for.
java.lang.NullPointerException
- if context is null
PropertyNotFoundException
- if the given (base, property) pair is handled by this ELResolver but the
specified variable or property does not exist.
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 void setValue(ELContext context, java.lang.Object base, java.lang.Object property, java.lang.Object value) throws java.lang.NullPointerException, PropertyNotFoundException, PropertyNotWritableException, ELException
ELResolver
setValue
in class ELResolver
context
- The context of this evaluation.base
- The base object whose property value is to be set, or null to set a top-level
variable.property
- The property or variable to be set.value
- The value to set the property or variable to.
java.lang.NullPointerException
- if context is null
PropertyNotFoundException
- if the given (base, property) pair is handled by this ELResolver but the
specified variable or property does not exist.
PropertyNotWritableException
- if the given (base, property) pair is handled by this ELResolver but the
specified variable or property is not writable.
ELException
- if an exception was thrown while attempting to set the property or variable. The
thrown exception must be included as the cause property of this exception, if
available.
|
Copyright © 2006-2009 Odysseus Software GmbH. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |