org.mule.runtime.api.el

Interface ExpressionLanguage

All Known Subinterfaces:

ExpressionManager, ExtendedExpressionManager, MuleExpressionLanguage

public interface ExpressionLanguage

Evaluates an expression considering a set of given bindings and a set of global ones.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
void	addGlobalBindings(BindingContext bindingContext) Includes the bindings in a given BindingContext as global ones, that should not change often and should be considered for all subsequent operations.
TypedValue<?>	evaluate(String expression, BindingContext context) Evaluates an expression according to a given BindingContext and the global one.
TypedValue<?>	evaluate(String expression, DataType expectedOutputType, BindingContext context) Evaluates an expression according to a given BindingContext, the global one and the DataType of the expected result.
TypedValue<?>	evaluateLogExpression(String expression, BindingContext context) Evaluates an expression according to a given BindingContext and the global one.
Iterator<TypedValue<?>>	split(String expression, BindingContext context) Splits using the specified expression.
ValidationResult	validate(String expression) Verifies whether an expression is valid or not syntactically.

Method Detail

addGlobalBindings

void addGlobalBindings(BindingContext bindingContext)

Includes the bindings in a given BindingContext as global ones, that should not change often and should be considered for all subsequent operations.

Parameters:

bindingContext - the context containing the bindings to add

evaluate

TypedValue<?> evaluate(String expression,
                       BindingContext context)
                throws ExpressionExecutionException

Evaluates an expression according to a given BindingContext and the global one.

Parameters:

expression - the EL expression

context - the current dynamic binding context to consider

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - when an error occurs during evaluation

evaluate

TypedValue<?> evaluate(String expression,
                       DataType expectedOutputType,
                       BindingContext context)
                throws ExpressionExecutionException

Evaluates an expression according to a given BindingContext, the global one and the DataType of the expected result.

Parameters:

expression - the EL expression

expectedOutputType - the expected output type so that automatic conversion can be performed for the resulting value type.

context - the current dynamic binding context to consider

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - or during transformation or during transformation

evaluateLogExpression

TypedValue<?> evaluateLogExpression(String expression,
                                    BindingContext context)
                             throws ExpressionExecutionException

Evaluates an expression according to a given BindingContext and the global one. The evaluation of this script will do a best effort to avoid failing when the result value can not be represented in the corresponding format.

Parameters:

expression - the EL expression

context - the current dynamic binding context to consider

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - when an error occurs during evaluation

validate

ValidationResult validate(String expression)

Verifies whether an expression is valid or not syntactically.

Parameters:

expression - to be validated

Returns:

a ValidationResult indicating whether the validation was successful or not

split

Iterator<TypedValue<?>> split(String expression,
                              BindingContext context)

Splits using the specified expression. The expression should return a collection of elements or an object. In case of the object it will iterate through the entries

Parameters:

expression - the expression to be used to split

context - the current dynamic binding context to consider

Returns:

an iterator with the elements that were split