org.mule.runtime.core.api.el

Interface ExtendedExpressionManager

All Superinterfaces:

org.mule.runtime.api.el.ExpressionLanguage, ExpressionManager, org.mule.runtime.api.el.MuleExpressionLanguage

All Known Implementing Classes:

DefaultExpressionManager

public interface ExtendedExpressionManager
extends ExpressionManager

Extends the ExpressionManager supporting mutating operations and the propagation of more variables.

Only meant to distinguish the Mule 3 inherited behaviour from the current approach.

Since:

4.0

Field Summary

Fields inherited from interface org.mule.runtime.core.api.el.ExpressionManager

DEFAULT_EXPRESSION_POSTFIX, DEFAULT_EXPRESSION_PREFIX

Method Summary

Modifier and Type	Method and Description
void	enrich(String expression, Event event, Event.Builder eventBuilder, FlowConstruct flowConstruct, org.mule.runtime.api.metadata.TypedValue value) Deprecated. Mutation via expressions is deprecated.
org.mule.runtime.api.metadata.TypedValue	evaluate(String expression, Event event, Event.Builder eventBuilder, FlowConstruct flowConstruct) Deprecated. Mutation via expressions is deprecated.
String	parse(String expression, Event event, FlowConstruct flowConstruct) Deprecated. Parsing of expressions is deprecated. Use standard evaluation instead.

Methods inherited from interface org.mule.runtime.core.api.el.ExpressionManager

evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, evaluate, evaluateBoolean, evaluateBoolean, split, split

Methods inherited from interface org.mule.runtime.api.el.MuleExpressionLanguage

isExpression, isValid

Methods inherited from interface org.mule.runtime.api.el.ExpressionLanguage

addGlobalBindings, evaluate, evaluate, split, validate

Method Detail

evaluate

@Deprecated
org.mule.runtime.api.metadata.TypedValue evaluate(String expression,
                                                              Event event,
                                                              Event.Builder eventBuilder,
                                                              FlowConstruct flowConstruct)
                                                       throws ExpressionRuntimeException

Deprecated. Mutation via expressions is deprecated.

Execute the expression returning the result. The expression will be executed with MuleEvent context, meaning the expression language implementation should provided access to the message.

This version of evaluate allows Event or InternalMessage mutation performed within the expression to be maintained post-evaluation via the use of a result Event.Builder which should be created from the original event before being passed and then used to construct the post-evaluation event.

Parameters:

expression - the expression to be executed

event - the current event being processed

eventBuilder - event builder instance used to mutate the current message or event.

flowConstruct - the flow where the event is being processed

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException

enrich

@Deprecated
void enrich(String expression,
                        Event event,
                        Event.Builder eventBuilder,
                        FlowConstruct flowConstruct,
                        org.mule.runtime.api.metadata.TypedValue value)

Deprecated. Mutation via expressions is deprecated.

Enriches an event using a typed value.

This version of enrich allows Event or InternalMessage mutation performed within the expression to be maintained post-evaluation via the use of a result Event.Builder which should be created from the original event before being passed and then used to construct the post-evaluation event.

Parameters:

expression - a single expression i.e. header://foo that defines how the message should be enriched

event - The event to be enriched

eventBuilder - event builder instance used to mutate the current message or event.

flowConstruct - the flow where the event is being processed

value - The typed value used for enrichment

parse

@Deprecated
String parse(String expression,
                         Event event,
                         FlowConstruct flowConstruct)
                  throws ExpressionRuntimeException

Deprecated. Parsing of expressions is deprecated. Use standard evaluation instead.

Evaluates expressions in a given string. This method will iterate through each expression and evaluate it. If a user needs to evaluate a single expression they can use ExpressionManager.evaluate(String, Event, FlowConstruct, BindingContext).

This version of evaluate performs expression evaulation on an immutable event. Any Event or InternalMessage mutation performed within the expression will impact within the context of expression evaluation but will not mutated the event parameter.

Parameters:

expression - one or more expressions ebedded in a literal string i.e. "Value is #[mel:xpath://foo] other value is #[mel:header:foo]."

event - The current event being processed

flowConstruct - the flow where the event is being processed

Returns:

the result of the evaluation

Throws:

ExpressionRuntimeException - if the expression is invalid, or a null is found for the expression and 'failIfNull is set to true.