org.mule.runtime.api.el

Interface ExpressionLanguageSession

All Superinterfaces:

AutoCloseable

public interface ExpressionLanguageSession
extends AutoCloseable

Evaluates an expression considering a set of given bindings passed on construction time.

Since:

1.2

Method Summary

Modifier and Type	Method and Description
void	close() Frees any resources used to maintain this context.
TypedValue<?>	evaluate(String expression) Evaluates an expression according to the parameters used during construction and the global bindings.
TypedValue<?>	evaluate(String expression, DataType expectedOutputType) Evaluates an expression according to the parameters used during construction, the global bindings and the DataType of the expected result.
TypedValue<?>	evaluate(String expression, long timeout) Evaluates an expression according to the parameters used during construction and the global bindings.
TypedValue<?>	evaluateLogExpression(String expression) Evaluates an expression according to a given BindingContext and the global one.
Iterator<TypedValue<?>>	split(String expression) Splits using the specified expression.

Method Detail

evaluate

TypedValue<?> evaluate(String expression)
                throws ExpressionExecutionException

Evaluates an expression according to the parameters used during construction and the global bindings.

Parameters:

expression - the EL expression

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - when an error occurs during evaluation

evaluate

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

Evaluates an expression according to the parameters used during construction, the global bindings 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.

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - or during transformation or during transformation

evaluate

TypedValue<?> evaluate(String expression,
                       long timeout)
                throws ExpressionExecutionException

Evaluates an expression according to the parameters used during construction and the global bindings.

Parameters:

expression - the EL expression

timeout - how long to wait for the expression to be evaluated, in milliseconds. If the evaluation takes more than this time, an ExpressionExecutionException will be thrown.

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - when an error occurs during evaluation

evaluateLogExpression

TypedValue<?> evaluateLogExpression(String expression)
                             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

Returns:

the result of the expression plus its type

Throws:

ExpressionExecutionException - when an error occurs during evaluation

split

Iterator<TypedValue<?>> split(String expression)

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

Returns:

an iterator with the elements that were split

close

void close()

Frees any resources used to maintain this context.

Specified by:

close in interface AutoCloseable