public class SpelExpression extends Object implements Expression
SpelExpression
represents a parsed (valid) expression that is ready to be
evaluated in a specified context. An expression can be evaluated standalone or in a
specified context. During expression evaluation the context may be asked to resolve
references to types, beans, properties, and methods.Constructor and Description |
---|
SpelExpression(String expression,
SpelNodeImpl ast,
SpelParserConfiguration configuration)
Construct an expression, only used by the parser.
|
Modifier and Type | Method and Description |
---|---|
boolean |
compileExpression()
Perform expression compilation.
|
SpelNode |
getAST()
Return the Abstract Syntax Tree for the expression.
|
EvaluationContext |
getEvaluationContext()
Return the default evaluation context that will be used if none is supplied on an evaluation call.
|
String |
getExpressionString()
Return the original string used to create this expression (unmodified).
|
Object |
getValue()
Evaluate this expression in the default standard context.
|
<T> T |
getValue(Class<T> expectedResultType)
Evaluate the expression in the default context.
|
Object |
getValue(EvaluationContext context)
Evaluate this expression in the provided context and return the result
of evaluation.
|
<T> T |
getValue(EvaluationContext context,
Class<T> expectedResultType)
Evaluate the expression in a specified context which can resolve references
to properties, methods, types, etc.
|
Object |
getValue(EvaluationContext context,
Object rootObject)
Evaluate this expression in the provided context and return the result
of evaluation, but use the supplied root context as an override for any
default root object specified in the context.
|
<T> T |
getValue(EvaluationContext context,
Object rootObject,
Class<T> expectedResultType)
Evaluate the expression in a specified context which can resolve references
to properties, methods, types, etc.
|
Object |
getValue(Object rootObject)
Evaluate this expression against the specified root object.
|
<T> T |
getValue(Object rootObject,
Class<T> expectedResultType)
Evaluate the expression in the default context against the specified root
object.
|
Class<?> |
getValueType()
Return the most general type that can be passed to a
Expression.setValue(java.lang.Object, java.lang.Object)
method using the default context. |
Class<?> |
getValueType(EvaluationContext context)
Return the most general type that can be passed to the
Expression.setValue(EvaluationContext, Object) method for the given context. |
Class<?> |
getValueType(EvaluationContext context,
Object rootObject)
Return the most general type that can be passed to the
Expression.setValue(EvaluationContext, Object, Object) method for the given
context. |
Class<?> |
getValueType(Object rootObject)
Return the most general type that can be passed to the
Expression.setValue(Object, Object) method using the default context. |
TypeDescriptor |
getValueTypeDescriptor()
Return the most general type that can be passed to a
Expression.setValue(java.lang.Object, java.lang.Object)
method using the default context. |
TypeDescriptor |
getValueTypeDescriptor(EvaluationContext context)
Return the most general type that can be passed to the
Expression.setValue(EvaluationContext, Object) method for the given context. |
TypeDescriptor |
getValueTypeDescriptor(EvaluationContext context,
Object rootObject)
Return the most general type that can be passed to the
Expression.setValue(EvaluationContext, Object, Object) method for the given
context. |
TypeDescriptor |
getValueTypeDescriptor(Object rootObject)
Return the most general type that can be passed to the
Expression.setValue(Object, Object) method using the default context. |
boolean |
isWritable(EvaluationContext context)
Determine if an expression can be written to, i.e.
|
boolean |
isWritable(EvaluationContext context,
Object rootObject)
Determine if an expression can be written to, i.e.
|
boolean |
isWritable(Object rootObject)
Determine if an expression can be written to, i.e.
|
void |
revertToInterpreted()
Cause an expression to revert to being interpreted if it has been using a compiled
form.
|
void |
setEvaluationContext(EvaluationContext evaluationContext)
Set the evaluation context that will be used if none is specified on an evaluation call.
|
void |
setValue(EvaluationContext context,
Object value)
Set this expression in the provided context to the value provided.
|
void |
setValue(EvaluationContext context,
Object rootObject,
Object value)
Set this expression in the provided context to the value provided.
|
void |
setValue(Object rootObject,
Object value)
Set this expression in the provided context to the value provided.
|
String |
toStringAST()
Produce a string representation of the Abstract Syntax Tree for the expression.
|
public SpelExpression(String expression, SpelNodeImpl ast, SpelParserConfiguration configuration)
public void setEvaluationContext(EvaluationContext evaluationContext)
evaluationContext
- the evaluation context to usepublic EvaluationContext getEvaluationContext()
public String getExpressionString()
Expression
getExpressionString
in interface Expression
@Nullable public Object getValue() throws EvaluationException
Expression
getValue
in interface Expression
EvaluationException
- if there is a problem during evaluation@Nullable public <T> T getValue(@Nullable Class<T> expectedResultType) throws EvaluationException
Expression
getValue
in interface Expression
expectedResultType
- the class the caller would like the result to beEvaluationException
- if there is a problem during evaluation@Nullable public Object getValue(@Nullable Object rootObject) throws EvaluationException
Expression
getValue
in interface Expression
rootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem during evaluation@Nullable public <T> T getValue(@Nullable Object rootObject, @Nullable Class<T> expectedResultType) throws EvaluationException
Expression
getValue
in interface Expression
rootObject
- the root object against which to evaluate the expressionexpectedResultType
- the class the caller would like the result to beEvaluationException
- if there is a problem during evaluation@Nullable public Object getValue(EvaluationContext context) throws EvaluationException
Expression
getValue
in interface Expression
context
- the context in which to evaluate the expressionEvaluationException
- if there is a problem during evaluation@Nullable public <T> T getValue(EvaluationContext context, @Nullable Class<T> expectedResultType) throws EvaluationException
Expression
getValue
in interface Expression
context
- the context in which to evaluate the expressionexpectedResultType
- the class the caller would like the result to beEvaluationException
- if there is a problem during evaluation@Nullable public Object getValue(EvaluationContext context, @Nullable Object rootObject) throws EvaluationException
Expression
getValue
in interface Expression
context
- the context in which to evaluate the expressionrootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem during evaluation@Nullable public <T> T getValue(EvaluationContext context, @Nullable Object rootObject, @Nullable Class<T> expectedResultType) throws EvaluationException
Expression
getValue
in interface Expression
context
- the context in which to evaluate the expressionrootObject
- the root object against which to evaluate the expressionexpectedResultType
- the class the caller would like the result to beEvaluationException
- if there is a problem during evaluation@Nullable public Class<?> getValueType() throws EvaluationException
Expression
Expression.setValue(java.lang.Object, java.lang.Object)
method using the default context.getValueType
in interface Expression
EvaluationException
- if there is a problem determining the type@Nullable public Class<?> getValueType(@Nullable Object rootObject) throws EvaluationException
Expression
Expression.setValue(Object, Object)
method using the default context.getValueType
in interface Expression
rootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem determining the type@Nullable public Class<?> getValueType(EvaluationContext context) throws EvaluationException
Expression
Expression.setValue(EvaluationContext, Object)
method for the given context.getValueType
in interface Expression
context
- the context in which to evaluate the expressionEvaluationException
- if there is a problem determining the type@Nullable public Class<?> getValueType(EvaluationContext context, @Nullable Object rootObject) throws EvaluationException
Expression
Expression.setValue(EvaluationContext, Object, Object)
method for the given
context. The supplied root object overrides any specified in the context.getValueType
in interface Expression
context
- the context in which to evaluate the expressionrootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem determining the type@Nullable public TypeDescriptor getValueTypeDescriptor() throws EvaluationException
Expression
Expression.setValue(java.lang.Object, java.lang.Object)
method using the default context.getValueTypeDescriptor
in interface Expression
EvaluationException
- if there is a problem determining the type@Nullable public TypeDescriptor getValueTypeDescriptor(@Nullable Object rootObject) throws EvaluationException
Expression
Expression.setValue(Object, Object)
method using the default context.getValueTypeDescriptor
in interface Expression
rootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem determining the type@Nullable public TypeDescriptor getValueTypeDescriptor(EvaluationContext context) throws EvaluationException
Expression
Expression.setValue(EvaluationContext, Object)
method for the given context.getValueTypeDescriptor
in interface Expression
context
- the context in which to evaluate the expressionEvaluationException
- if there is a problem determining the type@Nullable public TypeDescriptor getValueTypeDescriptor(EvaluationContext context, @Nullable Object rootObject) throws EvaluationException
Expression
Expression.setValue(EvaluationContext, Object, Object)
method for the given
context. The supplied root object overrides any specified in the context.getValueTypeDescriptor
in interface Expression
context
- the context in which to evaluate the expressionrootObject
- the root object against which to evaluate the expressionEvaluationException
- if there is a problem determining the typepublic boolean isWritable(@Nullable Object rootObject) throws EvaluationException
Expression
isWritable
in interface Expression
rootObject
- the root object against which to evaluate the expressiontrue
if the expression is writable; false
otherwiseEvaluationException
- if there is a problem determining if it is writablepublic boolean isWritable(EvaluationContext context) throws EvaluationException
Expression
isWritable
in interface Expression
context
- the context in which the expression should be checkedtrue
if the expression is writable; false
otherwiseEvaluationException
- if there is a problem determining if it is writablepublic boolean isWritable(EvaluationContext context, @Nullable Object rootObject) throws EvaluationException
Expression
isWritable
in interface Expression
context
- the context in which the expression should be checkedrootObject
- the root object against which to evaluate the expressiontrue
if the expression is writable; false
otherwiseEvaluationException
- if there is a problem determining if it is writablepublic void setValue(@Nullable Object rootObject, @Nullable Object value) throws EvaluationException
Expression
setValue
in interface Expression
rootObject
- the root object against which to evaluate the expressionvalue
- the new valueEvaluationException
- if there is a problem during evaluationpublic void setValue(EvaluationContext context, @Nullable Object value) throws EvaluationException
Expression
setValue
in interface Expression
context
- the context in which to set the value of the expressionvalue
- the new valueEvaluationException
- if there is a problem during evaluationpublic void setValue(EvaluationContext context, @Nullable Object rootObject, @Nullable Object value) throws EvaluationException
Expression
setValue
in interface Expression
context
- the context in which to set the value of the expressionrootObject
- the root object against which to evaluate the expressionvalue
- the new valueEvaluationException
- if there is a problem during evaluationpublic boolean compileExpression()
public void revertToInterpreted()
public SpelNode getAST()
public String toStringAST()