org.springframework.expression.spel.support

Class StandardEvaluationContext

java.lang.Object

org.springframework.expression.spel.support.StandardEvaluationContext

All Implemented Interfaces:

EvaluationContext

Direct Known Subclasses:

MethodBasedEvaluationContext

public class StandardEvaluationContext
extends java.lang.Object
implements EvaluationContext

Provides a default EvaluationContext implementation.

To resolve properties/methods/fields this context uses a reflection mechanism.

Since:

3.0

Author:

Andy Clement, Juergen Hoeller, Sam Brannen

Field Summary

Fields

Modifier and Type	Field and Description
private BeanResolver	beanResolver
private java.util.List<ConstructorResolver>	constructorResolvers
private java.util.List<MethodResolver>	methodResolvers
private OperatorOverloader	operatorOverloader
private java.util.List<PropertyAccessor>	propertyAccessors
private ReflectiveMethodResolver	reflectiveMethodResolver
private TypedValue	rootObject
private TypeComparator	typeComparator
private TypeConverter	typeConverter
private TypeLocator	typeLocator
private java.util.Map<java.lang.String,java.lang.Object>	variables

Constructor Summary

Constructors

Constructor and Description
StandardEvaluationContext()
StandardEvaluationContext(java.lang.Object rootObject)

Method Summary

Modifier and Type	Method and Description
void	addConstructorResolver(ConstructorResolver resolver)
void	addMethodResolver(MethodResolver resolver)
void	addPropertyAccessor(PropertyAccessor accessor)
private void	ensureConstructorResolversInitialized()
private void	ensureMethodResolversInitialized()
private void	ensurePropertyAccessorsInitialized()
BeanResolver	getBeanResolver() Return a bean resolver that can look up beans by name.
java.util.List<ConstructorResolver>	getConstructorResolvers() Return a list of resolvers that will be asked in turn to locate a constructor.
java.util.List<MethodResolver>	getMethodResolvers() Return a list of resolvers that will be asked in turn to locate a method.
OperatorOverloader	getOperatorOverloader() Return an operator overloader that may support mathematical operations between more than the standard set of types.
java.util.List<PropertyAccessor>	getPropertyAccessors() Return a list of accessors that will be asked in turn to read/write a property.
TypedValue	getRootObject() Return the default root context object against which unqualified properties/methods/etc should be resolved.
TypeComparator	getTypeComparator() Return a type comparator for comparing pairs of objects for equality.
TypeConverter	getTypeConverter() Return a type converter that can convert (or coerce) a value from one type to another.
TypeLocator	getTypeLocator() Return a type locator that can be used to find types, either by short or fully qualified name.
private void	initializeConstructorResolvers()
private void	initializeMethodResolvers()
private void	initializePropertyAccessors()
java.lang.Object	lookupVariable(java.lang.String name) Look up a named variable within this evaluation context.
void	registerFunction(java.lang.String name, java.lang.reflect.Method method)
void	registerMethodFilter(java.lang.Class<?> type, MethodFilter filter) Register a MethodFilter which will be called during method resolution for the specified type.
boolean	removeConstructorResolver(ConstructorResolver resolver)
boolean	removeMethodResolver(MethodResolver methodResolver)
boolean	removePropertyAccessor(PropertyAccessor accessor)
void	setBeanResolver(BeanResolver beanResolver)
void	setConstructorResolvers(java.util.List<ConstructorResolver> constructorResolvers)
void	setMethodResolvers(java.util.List<MethodResolver> methodResolvers)
void	setOperatorOverloader(OperatorOverloader operatorOverloader)
void	setPropertyAccessors(java.util.List<PropertyAccessor> propertyAccessors)
void	setRootObject(java.lang.Object rootObject)
void	setRootObject(java.lang.Object rootObject, TypeDescriptor typeDescriptor)
void	setTypeComparator(TypeComparator typeComparator)
void	setTypeConverter(TypeConverter typeConverter)
void	setTypeLocator(TypeLocator typeLocator)
void	setVariable(java.lang.String name, java.lang.Object value) Set a named variable within this evaluation context to a specified value.
void	setVariables(java.util.Map<java.lang.String,java.lang.Object> variables)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

rootObject

private TypedValue rootObject

constructorResolvers

private java.util.List<ConstructorResolver> constructorResolvers

methodResolvers

private java.util.List<MethodResolver> methodResolvers

beanResolver

private BeanResolver beanResolver

reflectiveMethodResolver

private ReflectiveMethodResolver reflectiveMethodResolver

propertyAccessors

private java.util.List<PropertyAccessor> propertyAccessors

typeLocator

private TypeLocator typeLocator

typeConverter

private TypeConverter typeConverter

typeComparator

private TypeComparator typeComparator

operatorOverloader

private OperatorOverloader operatorOverloader

variables

private final java.util.Map<java.lang.String,java.lang.Object> variables

Constructor Detail

StandardEvaluationContext

public StandardEvaluationContext()

StandardEvaluationContext

public StandardEvaluationContext(java.lang.Object rootObject)

Method Detail

setRootObject

public void setRootObject(java.lang.Object rootObject,
                          TypeDescriptor typeDescriptor)

setRootObject

public void setRootObject(java.lang.Object rootObject)

getRootObject

public TypedValue getRootObject()

Description copied from interface: EvaluationContext

Return the default root context object against which unqualified properties/methods/etc should be resolved. This can be overridden when evaluating an expression.

Specified by:

getRootObject in interface EvaluationContext

addConstructorResolver

public void addConstructorResolver(ConstructorResolver resolver)

removeConstructorResolver

public boolean removeConstructorResolver(ConstructorResolver resolver)

setConstructorResolvers

public void setConstructorResolvers(java.util.List<ConstructorResolver> constructorResolvers)

getConstructorResolvers

public java.util.List<ConstructorResolver> getConstructorResolvers()

Description copied from interface: EvaluationContext

Return a list of resolvers that will be asked in turn to locate a constructor.

Specified by:

getConstructorResolvers in interface EvaluationContext

addMethodResolver

public void addMethodResolver(MethodResolver resolver)

removeMethodResolver

public boolean removeMethodResolver(MethodResolver methodResolver)

setMethodResolvers

public void setMethodResolvers(java.util.List<MethodResolver> methodResolvers)

getMethodResolvers

public java.util.List<MethodResolver> getMethodResolvers()

Description copied from interface: EvaluationContext

Return a list of resolvers that will be asked in turn to locate a method.

Specified by:

getMethodResolvers in interface EvaluationContext

setBeanResolver

public void setBeanResolver(BeanResolver beanResolver)

getBeanResolver

public BeanResolver getBeanResolver()

Description copied from interface: EvaluationContext

Return a bean resolver that can look up beans by name.

Specified by:

getBeanResolver in interface EvaluationContext

addPropertyAccessor

public void addPropertyAccessor(PropertyAccessor accessor)

removePropertyAccessor

public boolean removePropertyAccessor(PropertyAccessor accessor)

setPropertyAccessors

public void setPropertyAccessors(java.util.List<PropertyAccessor> propertyAccessors)

getPropertyAccessors

public java.util.List<PropertyAccessor> getPropertyAccessors()

Description copied from interface: EvaluationContext

Return a list of accessors that will be asked in turn to read/write a property.

Specified by:

getPropertyAccessors in interface EvaluationContext

setTypeLocator

public void setTypeLocator(TypeLocator typeLocator)

getTypeLocator

public TypeLocator getTypeLocator()

Description copied from interface: EvaluationContext

Return a type locator that can be used to find types, either by short or fully qualified name.

Specified by:

getTypeLocator in interface EvaluationContext

setTypeConverter

public void setTypeConverter(TypeConverter typeConverter)

getTypeConverter

public TypeConverter getTypeConverter()

Description copied from interface: EvaluationContext

Return a type converter that can convert (or coerce) a value from one type to another.

Specified by:

getTypeConverter in interface EvaluationContext

setTypeComparator

public void setTypeComparator(TypeComparator typeComparator)

getTypeComparator

public TypeComparator getTypeComparator()

Description copied from interface: EvaluationContext

Return a type comparator for comparing pairs of objects for equality.

Specified by:

getTypeComparator in interface EvaluationContext

setOperatorOverloader

public void setOperatorOverloader(OperatorOverloader operatorOverloader)

getOperatorOverloader

public OperatorOverloader getOperatorOverloader()

Description copied from interface: EvaluationContext

Return an operator overloader that may support mathematical operations between more than the standard set of types.

Specified by:

getOperatorOverloader in interface EvaluationContext

setVariable

public void setVariable(java.lang.String name,
                        java.lang.Object value)

Description copied from interface: EvaluationContext

Set a named variable within this evaluation context to a specified value.

Specified by:

setVariable in interface EvaluationContext

Parameters:

name - variable to set

value - value to be placed in the variable

setVariables

public void setVariables(java.util.Map<java.lang.String,java.lang.Object> variables)

registerFunction

public void registerFunction(java.lang.String name,
                             java.lang.reflect.Method method)

lookupVariable

public java.lang.Object lookupVariable(java.lang.String name)

Description copied from interface: EvaluationContext

Look up a named variable within this evaluation context.

Specified by:

lookupVariable in interface EvaluationContext

Parameters:

name - variable to lookup

Returns:

the value of the variable

registerMethodFilter

public void registerMethodFilter(java.lang.Class<?> type,
                                 MethodFilter filter)
                          throws java.lang.IllegalStateException

Register a MethodFilter which will be called during method resolution for the specified type.

The MethodFilter may remove methods and/or sort the methods which will then be used by SpEL as the candidates to look through for a match.

Parameters:

type - the type for which the filter should be called

filter - a MethodFilter, or null to unregister a filter for the type

Throws:

java.lang.IllegalStateException - if the ReflectiveMethodResolver is not in use

ensurePropertyAccessorsInitialized

private void ensurePropertyAccessorsInitialized()

initializePropertyAccessors

private void initializePropertyAccessors()

ensureMethodResolversInitialized

private void ensureMethodResolversInitialized()

initializeMethodResolvers

private void initializeMethodResolvers()

ensureConstructorResolversInitialized

private void ensureConstructorResolversInitialized()

initializeConstructorResolvers

private void initializeConstructorResolvers()