org.mule.runtime.core.api.el

Interface ExpressionLanguageAdaptor

All Known Subinterfaces:

ExtendedExpressionLanguageAdaptor

All Known Implementing Classes:

DataWeaveExpressionLanguageAdaptor, ExpressionLanguageAdaptorHandler, MVELExpressionLanguage

public interface ExpressionLanguageAdaptor

Binds Mule Core concepts Event or FlowConstruct and executes the underlying ExpressionLanguage.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
void	addGlobalBindings(org.mule.runtime.api.el.BindingContext bindingContext) Registers the given BindingContext entries as globals.
org.mule.runtime.api.metadata.TypedValue	evaluate(String expression, org.mule.runtime.api.metadata.DataType expectedOutputType, Event event, org.mule.runtime.api.el.BindingContext context) Evaluates an expression according to a given BindingContext and outputs .
org.mule.runtime.api.metadata.TypedValue	evaluate(String expression, org.mule.runtime.api.metadata.DataType expectedOutputType, Event event, FlowConstruct flowConstruct, org.mule.runtime.api.el.BindingContext context, boolean failOnNull) Evaluates an expression according to a given BindingContext, an Event and a FlowConstruct.
org.mule.runtime.api.metadata.TypedValue	evaluate(String expression, Event event, org.mule.runtime.api.el.BindingContext context) Evaluates an expression according to a given BindingContext.
org.mule.runtime.api.metadata.TypedValue	evaluate(String expression, Event event, FlowConstruct flowConstruct, org.mule.runtime.api.el.BindingContext bindingContext) Evaluates an expression according to a given BindingContext, an Event and a FlowConstruct.
Iterator<org.mule.runtime.api.metadata.TypedValue<?>>	split(String expression, Event event, org.mule.runtime.api.el.BindingContext bindingContext) Splits using the specified expression and group it with the batch size.
Iterator<org.mule.runtime.api.metadata.TypedValue<?>>	split(String expression, Event event, FlowConstruct flowConstruct, org.mule.runtime.api.el.BindingContext bindingContext) Splits using the specified expression and group it with the batch size.
org.mule.runtime.api.el.ValidationResult	validate(String expression) Verifies whether an expression is valid or not syntactically.

Method Detail

addGlobalBindings

void addGlobalBindings(org.mule.runtime.api.el.BindingContext bindingContext)

Registers the given BindingContext entries as globals. Notice globals cannot be removed once registered, only overwritten by the registration of a binding with the same identifier. Implementations should be thread safe to avoid race conditions between registration and expression evaluation.

Parameters:

bindingContext - the context to register

evaluate

org.mule.runtime.api.metadata.TypedValue evaluate(String expression,
                                                  Event event,
                                                  FlowConstruct flowConstruct,
                                                  org.mule.runtime.api.el.BindingContext bindingContext)
                                           throws ExpressionRuntimeException

Evaluates an expression according to a given BindingContext, an Event and a FlowConstruct.

Parameters:

expression - the expression to be executed

event - the current event being processed

flowConstruct - the flow where the event is being processed

bindingContext - the bindings to consider

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression

evaluate

org.mule.runtime.api.metadata.TypedValue evaluate(String expression,
                                                  Event event,
                                                  org.mule.runtime.api.el.BindingContext context)
                                           throws ExpressionRuntimeException

Evaluates an expression according to a given BindingContext.

Parameters:

expression - the expression to be executed

event - the current event being processed

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression

evaluate

org.mule.runtime.api.metadata.TypedValue evaluate(String expression,
                                                  org.mule.runtime.api.metadata.DataType expectedOutputType,
                                                  Event event,
                                                  org.mule.runtime.api.el.BindingContext context)
                                           throws ExpressionRuntimeException

Evaluates an expression according to a given BindingContext and outputs .

Parameters:

expression - the expression to be executed

event - the current event being processed

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

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression

evaluate

org.mule.runtime.api.metadata.TypedValue evaluate(String expression,
                                                  org.mule.runtime.api.metadata.DataType expectedOutputType,
                                                  Event event,
                                                  FlowConstruct flowConstruct,
                                                  org.mule.runtime.api.el.BindingContext context,
                                                  boolean failOnNull)
                                           throws ExpressionRuntimeException

Evaluates an expression according to a given BindingContext, an Event and a FlowConstruct.

Parameters:

expression - the expression to be executed

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

event - the current event being processed

flowConstruct - the flow where the event is being processed

context - the bindings to consider

failOnNull - indicates if should fail if the evaluation result is null

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression

validate

org.mule.runtime.api.el.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<org.mule.runtime.api.metadata.TypedValue<?>> split(String expression,
                                                            Event event,
                                                            FlowConstruct flowConstruct,
                                                            org.mule.runtime.api.el.BindingContext bindingContext)
                                                     throws ExpressionRuntimeException

Splits using the specified expression and group it with the batch size. If batch size is less or equals to zero then no batching is done. The expression should return a collection of elements.

Parameters:

expression - the expression to be executed

event - the current event being processed

flowConstruct - the flow where the event is being processed

bindingContext - the bindings to consider

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression

split

Iterator<org.mule.runtime.api.metadata.TypedValue<?>> split(String expression,
                                                            Event event,
                                                            org.mule.runtime.api.el.BindingContext bindingContext)
                                                     throws ExpressionRuntimeException

Splits using the specified expression and group it with the batch size. If batch size is less or equals to zero then no batching is done. The expression should return a collection of elements.

Parameters:

expression - the expression to be executed

event - the current event being processed

bindingContext - the bindings to consider

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException - if a problem occurs evaluating the expression