org.springframework.cache.interceptor

Class ExpressionEvaluator

java.lang.Object

org.springframework.context.expression.CachedExpressionEvaluator

org.springframework.cache.interceptor.ExpressionEvaluator

class ExpressionEvaluator
extends CachedExpressionEvaluator

Utility class handling the SpEL expression parsing. Meant to be used as a reusable, thread-safe component.

Performs internal caching for performance reasons using AnnotatedElementKey.

Since:

3.1

Author:

Costin Leau, Phillip Webb, Sam Brannen, Stephane Nicoll

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.context.expression.CachedExpressionEvaluator

CachedExpressionEvaluator.ExpressionKey

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression>	conditionCache
private java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression>	keyCache
static java.lang.Object	NO_RESULT Indicate that there is no result variable.
private ParameterNameDiscoverer	paramNameDiscoverer
static java.lang.Object	RESULT_UNAVAILABLE Indicate that the result variable cannot be used at all.
static java.lang.String	RESULT_VARIABLE The name of the variable holding the result object.
private java.util.Map<AnnotatedElementKey,java.lang.reflect.Method>	targetMethodCache
private java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression>	unlessCache

Constructor Summary

Constructors

Constructor and Description
ExpressionEvaluator()

Method Summary

Modifier and Type	Method and Description
(package private) void	clear() Clear all caches.
boolean	condition(java.lang.String conditionExpression, AnnotatedElementKey methodKey, EvaluationContext evalContext)
EvaluationContext	createEvaluationContext(java.util.Collection<? extends Cache> caches, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Object target, java.lang.Class<?> targetClass) Create an EvaluationContext without a return value.
EvaluationContext	createEvaluationContext(java.util.Collection<? extends Cache> caches, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Object target, java.lang.Class<?> targetClass, java.lang.Object result) Create an EvaluationContext.
private java.lang.reflect.Method	getTargetMethod(java.lang.Class<?> targetClass, java.lang.reflect.Method method)
java.lang.Object	key(java.lang.String keyExpression, AnnotatedElementKey methodKey, EvaluationContext evalContext)
boolean	unless(java.lang.String unlessExpression, AnnotatedElementKey methodKey, EvaluationContext evalContext)

Methods inherited from class org.springframework.context.expression.CachedExpressionEvaluator

getExpression, getParser

Methods inherited from class java.lang.Object

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

Field Detail

NO_RESULT

public static final java.lang.Object NO_RESULT

Indicate that there is no result variable.

RESULT_UNAVAILABLE

public static final java.lang.Object RESULT_UNAVAILABLE

Indicate that the result variable cannot be used at all.

RESULT_VARIABLE

public static final java.lang.String RESULT_VARIABLE

The name of the variable holding the result object.

See Also:

Constant Field Values

paramNameDiscoverer

private final ParameterNameDiscoverer paramNameDiscoverer

keyCache

private final java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression> keyCache

conditionCache

private final java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression> conditionCache

unlessCache

private final java.util.Map<CachedExpressionEvaluator.ExpressionKey,Expression> unlessCache

targetMethodCache

private final java.util.Map<AnnotatedElementKey,java.lang.reflect.Method> targetMethodCache

Constructor Detail

ExpressionEvaluator

ExpressionEvaluator()

Method Detail

createEvaluationContext

public EvaluationContext createEvaluationContext(java.util.Collection<? extends Cache> caches,
                                                 java.lang.reflect.Method method,
                                                 java.lang.Object[] args,
                                                 java.lang.Object target,
                                                 java.lang.Class<?> targetClass)

Create an EvaluationContext without a return value.

See Also:

createEvaluationContext(Collection, Method, Object[], Object, Class, Object)

createEvaluationContext

public EvaluationContext createEvaluationContext(java.util.Collection<? extends Cache> caches,
                                                 java.lang.reflect.Method method,
                                                 java.lang.Object[] args,
                                                 java.lang.Object target,
                                                 java.lang.Class<?> targetClass,
                                                 java.lang.Object result)

Create an EvaluationContext.

Parameters:

caches - the current caches

method - the method

args - the method arguments

target - the target object

targetClass - the target class

result - the return value (can be null) or NO_RESULT if there is no return at this time

Returns:

the evaluation context

key

public java.lang.Object key(java.lang.String keyExpression,
                            AnnotatedElementKey methodKey,
                            EvaluationContext evalContext)

condition

public boolean condition(java.lang.String conditionExpression,
                         AnnotatedElementKey methodKey,
                         EvaluationContext evalContext)

unless

public boolean unless(java.lang.String unlessExpression,
                      AnnotatedElementKey methodKey,
                      EvaluationContext evalContext)

clear

void clear()

Clear all caches.

getTargetMethod

private java.lang.reflect.Method getTargetMethod(java.lang.Class<?> targetClass,
                                                 java.lang.reflect.Method method)