Class StandardEvaluationContext
java.lang.Object
org.springframework.expression.spel.support.StandardEvaluationContext
- All Implemented Interfaces:
EvaluationContext
- Direct Known Subclasses:
MethodBasedEvaluationContext
A powerful and highly configurable
EvaluationContext
implementation.
This context uses standard implementations of all applicable strategies,
based on reflection to resolve properties, methods and fields.
For a simpler builder-style context variant for data-binding purposes,
consider using SimpleEvaluationContext
instead which allows for
opting into several SpEL features as needed by specific evaluation cases.
- Since:
- 3.0
- Author:
- Andy Clement, Juergen Hoeller, Sam Brannen
- See Also:
-
Constructor Summary
ConstructorDescriptionCreate aStandardEvaluationContext
with a null root object.StandardEvaluationContext
(Object rootObject) Create aStandardEvaluationContext
with the given root object. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addConstructorResolver
(ConstructorResolver resolver) void
addMethodResolver
(MethodResolver resolver) void
addPropertyAccessor
(PropertyAccessor accessor) Return a bean resolver that can look up beans by name.Return a list of resolvers that will be asked in turn to locate a constructor.Return a list of resolvers that will be asked in turn to locate a method.Return an operator overloader that may support mathematical operations between more than the standard set of types.Return a list of accessors that will be asked in turn to read/write a property.Return the default root context object against which unqualified properties/methods/etc should be resolved.Return a type comparator for comparing pairs of objects for equality.Return a type converter that can convert (or coerce) a value from one type to another.Return a type locator that can be used to find types, either by short or fully qualified name.lookupVariable
(String name) Look up a named variable within this evaluation context.void
registerFunction
(String name, Method method) void
registerMethodFilter
(Class<?> type, MethodFilter filter) Register aMethodFilter
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
(List<ConstructorResolver> constructorResolvers) void
setMethodResolvers
(List<MethodResolver> methodResolvers) void
setOperatorOverloader
(OperatorOverloader operatorOverloader) void
setPropertyAccessors
(List<PropertyAccessor> propertyAccessors) void
setRootObject
(Object rootObject) void
setRootObject
(Object rootObject, TypeDescriptor typeDescriptor) void
setTypeComparator
(TypeComparator typeComparator) void
setTypeConverter
(TypeConverter typeConverter) void
setTypeLocator
(TypeLocator typeLocator) void
setVariable
(String name, Object value) Set a named variable within this evaluation context to a specified value.void
setVariables
(Map<String, Object> variables)
-
Constructor Details
-
StandardEvaluationContext
public StandardEvaluationContext()Create aStandardEvaluationContext
with a null root object. -
StandardEvaluationContext
Create aStandardEvaluationContext
with the given root object.- Parameters:
rootObject
- the root object to use- See Also:
-
-
Method Details
-
setRootObject
-
setRootObject
-
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 interfaceEvaluationContext
-
setPropertyAccessors
-
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 interfaceEvaluationContext
-
addPropertyAccessor
-
removePropertyAccessor
-
setConstructorResolvers
-
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 interfaceEvaluationContext
-
addConstructorResolver
-
removeConstructorResolver
-
setMethodResolvers
-
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 interfaceEvaluationContext
-
addMethodResolver
-
removeMethodResolver
-
setBeanResolver
-
getBeanResolver
Description copied from interface:EvaluationContext
Return a bean resolver that can look up beans by name.- Specified by:
getBeanResolver
in interfaceEvaluationContext
-
setTypeLocator
-
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 interfaceEvaluationContext
-
setTypeConverter
-
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 interfaceEvaluationContext
-
setTypeComparator
-
getTypeComparator
Description copied from interface:EvaluationContext
Return a type comparator for comparing pairs of objects for equality.- Specified by:
getTypeComparator
in interfaceEvaluationContext
-
setOperatorOverloader
-
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 interfaceEvaluationContext
-
setVariable
Description copied from interface:EvaluationContext
Set a named variable within this evaluation context to a specified value.- Specified by:
setVariable
in interfaceEvaluationContext
- Parameters:
name
- the name of the variable to setvalue
- the value to be placed in the variable
-
setVariables
-
registerFunction
-
lookupVariable
Description copied from interface:EvaluationContext
Look up a named variable within this evaluation context.- Specified by:
lookupVariable
in interfaceEvaluationContext
- Parameters:
name
- variable to lookup- Returns:
- the value of the variable, or
null
if not found
-
registerMethodFilter
Register aMethodFilter
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 calledfilter
- aMethodFilter
, ornull
to unregister a filter for the type- Throws:
IllegalStateException
- if theReflectiveMethodResolver
is not in use
-