Spring Context 6.1.4 · org.springframework.context.expression.StandardBeanExpressionResolver

Standard implementation of the org.springframework.beans.factory.config.BeanExpressionResolver interface, parsing and evaluating Spring EL using Spring's expression module.

All beans in the containing BeanFactory are made available as predefined variables with their common bean name, including standard context beans such as "environment", "systemProperties" and "systemEnvironment".

Field Summary

Modifier and Type	Field and Description
private final ParserContext	beanExpressionParserContext
public static final String	DEFAULT_EXPRESSION_PREFIX Default expression prefix: "#{".
public static final String	DEFAULT_EXPRESSION_SUFFIX Default expression suffix: "}".
private final Map<BeanExpressionContext, StandardEvaluationContext>	evaluationCache
private final Map<String, Expression>	expressionCache
private ExpressionParser	expressionParser
private String	expressionPrefix
private String	expressionSuffix
public static final String	MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME System property to configure the maximum length for SpEL expressions: spring.context.expression.maxLength.

Constructor Summary

Access	Constructor and Description
public	StandardBeanExpressionResolver() Create a new `StandardBeanExpressionResolver` with default settings.
public	StandardBeanExpressionResolver(ClassLoader the factory's bean class loader beanClassLoader) Create a new `StandardBeanExpressionResolver` with the given bean class loader, using it as the basis for expression compilation.

Method Summary

Modifier and Type	Method and Description
protected void	customizeEvaluationContext(StandardEvaluationContext evalContext) Template method for customizing the expression evaluation context.
public Object	evaluate(String the value to evaluate as an expression value, BeanExpressionContext the bean expression context to use when evaluating the expression beanExpressionContext) Implements org.springframework.beans.factory.config.BeanExpressionResolver.evaluate. Evaluate the given value as an expression, if applicable; return the value as-is otherwise.
private static int	retrieveMaxExpressionLength()
public void	setExpressionParser(ExpressionParser expressionParser) Specify the EL parser to use for expression parsing.
public void	setExpressionPrefix(String expressionPrefix) Set the prefix that an expression string starts with.
public void	setExpressionSuffix(String expressionSuffix) Set the suffix that an expression string ends with.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

beanExpressionParserContext	back to summary
private final ParserContext beanExpressionParserContext

DEFAULT_EXPRESSION_PREFIX	back to summary
public static final String DEFAULT_EXPRESSION_PREFIX Default expression prefix: "#{".

DEFAULT_EXPRESSION_SUFFIX	back to summary
public static final String DEFAULT_EXPRESSION_SUFFIX Default expression suffix: "}".

evaluationCache	back to summary
private final Map<BeanExpressionContext, StandardEvaluationContext> evaluationCache

expressionCache	back to summary
private final Map<String, Expression> expressionCache

expressionParser	back to summary
private ExpressionParser expressionParser

expressionPrefix	back to summary
private String expressionPrefix

expressionSuffix	back to summary
private String expressionSuffix

MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME back to summary

MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME	back to summary
public static final String MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME System property to configure the maximum length for SpEL expressions: spring.context.expression.maxLength. Can also be configured via the `SpringProperties` mechanism. Since 6.1.3 See Also `SpelParserConfiguration#getMaximumExpressionLength()`

public static final String MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME

System property to configure the maximum length for SpEL expressions: spring.context.expression.maxLength.

Can also be configured via the SpringProperties mechanism.

Since: 6.1.3
See Also: SpelParserConfiguration#getMaximumExpressionLength()

Constructor Detail

StandardBeanExpressionResolver back to summary

StandardBeanExpressionResolver	back to summary
public StandardBeanExpressionResolver() Create a new `StandardBeanExpressionResolver` with default settings. As of Spring Framework 6.1.3, the maximum SpEL expression length can be configured via the `MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME` property.

public StandardBeanExpressionResolver()

Create a new StandardBeanExpressionResolver with default settings.

As of Spring Framework 6.1.3, the maximum SpEL expression length can be configured via the MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME property.

StandardBeanExpressionResolver back to summary

StandardBeanExpressionResolver	back to summary
public StandardBeanExpressionResolver(ClassLoader beanClassLoader) Create a new `StandardBeanExpressionResolver` with the given bean class loader, using it as the basis for expression compilation. As of Spring Framework 6.1.3, the maximum SpEL expression length can be configured via the `MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME` property. Parameters beanClassLoader:ClassLoader the factory's bean class loader

public StandardBeanExpressionResolver(ClassLoader beanClassLoader)

Create a new StandardBeanExpressionResolver with the given bean class loader, using it as the basis for expression compilation.

As of Spring Framework 6.1.3, the maximum SpEL expression length can be configured via the MAX_SPEL_EXPRESSION_LENGTH_PROPERTY_NAME property.

Parameters

beanClassLoader:ClassLoader: the factory's bean class loader

Method Detail

customizeEvaluationContext	back to summary
protected void customizeEvaluationContext(StandardEvaluationContext evalContext) Template method for customizing the expression evaluation context. The default implementation is empty.

customizeEvaluationContext

back to summary

protected void customizeEvaluationContext(StandardEvaluationContext evalContext)

Template method for customizing the expression evaluation context.

The default implementation is empty.

evaluate	back to summary
public Object evaluate(String value, BeanExpressionContext beanExpressionContext) throws BeansException Implements org.springframework.beans.factory.config.BeanExpressionResolver.evaluate. Doc from org.springframework.beans.factory.config.BeanExpressionResolver.evaluate. Evaluate the given value as an expression, if applicable; return the value as-is otherwise. Parameters value:String the value to evaluate as an expression beanExpressionContext:BeanExpressionContext the bean expression context to use when evaluating the expression Returns:Object the resolved value (potentially the given value as-is) Annotations @Override @Nullable Exceptions BeansException: if evaluation failed

evaluate

back to summary

public Object evaluate(String value, BeanExpressionContext beanExpressionContext) throws BeansException

Implements org.springframework.beans.factory.config.BeanExpressionResolver.evaluate.

Doc from org.springframework.beans.factory.config.BeanExpressionResolver.evaluate.

Evaluate the given value as an expression, if applicable; return the value as-is otherwise.

Parameters

value:String: the value to evaluate as an expression
beanExpressionContext:BeanExpressionContext: the bean expression context to use when evaluating the expression

Returns:Object

the resolved value (potentially the given value as-is)

Annotations

@Override
@Nullable

Exceptions

BeansException:: if evaluation failed

retrieveMaxExpressionLength	back to summary
private static int retrieveMaxExpressionLength()

setExpressionParser back to summary

setExpressionParser	back to summary
public void setExpressionParser(ExpressionParser expressionParser) Specify the EL parser to use for expression parsing. Default is a `org.springframework.expression.spel.standard.SpelExpressionParser`, compatible with standard Unified EL style expression syntax.

public void setExpressionParser(ExpressionParser expressionParser)

Specify the EL parser to use for expression parsing.

Default is a org.springframework.expression.spel.standard.SpelExpressionParser, compatible with standard Unified EL style expression syntax.

setExpressionPrefix back to summary

setExpressionPrefix	back to summary
public void setExpressionPrefix(String expressionPrefix) Set the prefix that an expression string starts with. The default is "#{". See Also `DEFAULT_EXPRESSION_PREFIX`

public void setExpressionPrefix(String expressionPrefix)

Set the prefix that an expression string starts with. The default is "#{".

See Also: DEFAULT_EXPRESSION_PREFIX

setExpressionSuffix back to summary

setExpressionSuffix	back to summary
public void setExpressionSuffix(String expressionSuffix) Set the suffix that an expression string ends with. The default is "}". See Also `DEFAULT_EXPRESSION_SUFFIX`

public void setExpressionSuffix(String expressionSuffix)

Set the suffix that an expression string ends with. The default is "}".

See Also: DEFAULT_EXPRESSION_SUFFIX