org.mule.runtime.core.api.el

Interface ExtendedExpressionManager

All Superinterfaces:

ExpressionLanguage, ExpressionManager, MuleExpressionLanguage

@NoImplement
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, CoreEvent event, CoreEvent.Builder eventBuilder, ComponentLocation componentLocation, TypedValue value) Deprecated. Mutation via expressions is deprecated.
TypedValue	evaluate(String expression, CoreEvent event, CoreEvent.Builder eventBuilder, ComponentLocation componentLocation) Deprecated. Mutation via expressions is deprecated.
String	parse(String expression, CoreEvent event, ComponentLocation componentLocation) 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, parseLogTemplate, 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, evaluateLogExpression, split, validate

Method Detail

evaluate

@Deprecated
TypedValue evaluate(String expression,
                                CoreEvent event,
                                CoreEvent.Builder eventBuilder,
                                ComponentLocation componentLocation)
                         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 CoreEvent or InternalMessage mutation performed within the expression to be maintained post-evaluation via the use of a result CoreEvent.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.

componentLocation - the location of the component where the event is being processed

Returns:

the result of execution of the expression.

Throws:

ExpressionRuntimeException

enrich

@Deprecated
void enrich(String expression,
                        CoreEvent event,
                        CoreEvent.Builder eventBuilder,
                        ComponentLocation componentLocation,
                        TypedValue value)

Deprecated. Mutation via expressions is deprecated.

Enriches an event using a typed value.

This version of enrich allows CoreEvent or InternalMessage mutation performed within the expression to be maintained post-evaluation via the use of a result CoreEvent.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.

componentLocation - the location of the component where the event is being processed

value - The typed value used for enrichment

parse

@Deprecated
String parse(String expression,
                         CoreEvent event,
                         ComponentLocation componentLocation)
                  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 #evaluate(String, CoreEvent, FlowConstruct, BindingContext).

This version of evaluate performs expression evaulation on an immutable event. Any CoreEvent 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

componentLocation - the location of the component 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.