org.mule.el.mvel

Class MVELExpressionLanguage

java.lang.Object

org.mule.el.mvel.MVELExpressionLanguage

All Implemented Interfaces:

ExpressionLanguage, Initialisable

Direct Known Subclasses:

MVELExpressionLanguageWrapper

public class MVELExpressionLanguage
extends Object
implements ExpressionLanguage, Initialisable

Expression language that uses MVEL (http://mvel.codehaus.org/).

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,String>	aliases
protected boolean	autoResolveVariables
protected MvelEnricherDataTypePropagator	dataTypePropagator
protected MvelDataTypeResolver	dataTypeResolver
protected MVELExpressionExecutor	expressionExecutor
protected org.mule.mvel2.integration.VariableResolverFactory	globalContext
protected Map<String,org.mule.mvel2.ast.Function>	globalFunctions
protected String	globalFunctionsFile
protected String	globalFunctionsString
protected Map<String,Class<?>>	imports
protected MuleContext	muleContext
protected org.mule.mvel2.ParserConfiguration	parserConfiguration
protected org.mule.mvel2.integration.VariableResolverFactory	staticContext

Fields inherited from interface org.mule.api.lifecycle.Initialisable

PHASE_NAME

Constructor Summary

Constructors

Constructor and Description
MVELExpressionLanguage(MuleContext muleContext)

Method Summary

Methods

Modifier and Type	Method and Description
void	addAlias(String name, String expression)
void	addGlobalFunction(String name, org.mule.mvel2.ast.Function function)
void	addImport(String name, Class<?> clazz)
protected static void	configureParserConfiguration(org.mule.mvel2.ParserConfiguration parserConfiguration, Map<String,Class<?>> imports)
protected MVELExpressionLanguageContext	createExpressionLanguageContext()
static org.mule.mvel2.ParserConfiguration	createParserConfiguration(Map<String,Class<?>> imports)
protected void	createStaticContext()
protected org.mule.mvel2.integration.VariableResolverFactory	createVariableVariableResolverFactory(MuleEvent event)
protected org.mule.mvel2.integration.VariableResolverFactory	createVariableVariableResolverFactory(MuleMessage message) Deprecated.
void	enrich(String expression, MuleMessage message, TypedValue typedValue) Enriches a message
<T> T	evaluate(String expression) Execute the expression returning the result.
<T> T	evaluate(String expression, Map<String,Object> vars) Execute the expression returning the result.
<T> T	evaluate(String expression, MuleEvent event) Execute the expression returning the result.
<T> T	evaluate(String expression, MuleEvent event, Map<String,Object> vars) Execute the expression returning the result.
<T> T	evaluate(String expression, MuleMessage message) Deprecated.
<T> T	evaluate(String expression, MuleMessage message, Map<String,Object> vars) Deprecated.
protected <T> T	evaluateInternal(String expression, MVELExpressionLanguageContext variableResolverFactory)
TypedValue	evaluateTyped(String expression, MuleMessage message)
Map<String,String>	getAliases()
Map<String,org.mule.mvel2.ast.Function>	getGlobalFunctions()
org.mule.mvel2.ParserConfiguration	getParserConfiguration()
void	initialise() Method used to perform any initialisation work.
boolean	isValid(String expression) Validates the expression returning true is the expression is valid, false otherwise..
protected void	loadGlobalFunctions()
void	setAliases(Map<String,String> aliases)
void	setAutoResolveVariables(boolean autoResolveVariables)
void	setDataTypeResolver(MvelDataTypeResolver dataTypeResolver)
void	setGlobalFunctionsFile(String globalFunctionsFile)
void	setGlobalFunctionsString(String globalFunctionsString)
void	setImports(Map<String,Class<?>> imports)
void	validate(String expression) Validates the expression returning.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

parserConfiguration

protected org.mule.mvel2.ParserConfiguration parserConfiguration

muleContext

protected MuleContext muleContext

expressionExecutor

protected MVELExpressionExecutor expressionExecutor

staticContext

protected org.mule.mvel2.integration.VariableResolverFactory staticContext

globalContext

protected org.mule.mvel2.integration.VariableResolverFactory globalContext

globalFunctionsString

protected String globalFunctionsString

globalFunctionsFile

protected String globalFunctionsFile

globalFunctions

protected Map<String,org.mule.mvel2.ast.Function> globalFunctions

aliases

protected Map<String,String> aliases

imports

protected Map<String,Class<?>> imports

autoResolveVariables

protected boolean autoResolveVariables

dataTypeResolver

protected MvelDataTypeResolver dataTypeResolver

dataTypePropagator

protected MvelEnricherDataTypePropagator dataTypePropagator

Constructor Detail

MVELExpressionLanguage

public MVELExpressionLanguage(MuleContext muleContext)

Method Detail

initialise

public void initialise()
                throws InitialisationException

Description copied from interface: Initialisable

Method used to perform any initialisation work. If a fatal error occurs during initialisation an InitialisationException should be thrown, causing the Mule instance to shutdown. If the error is recoverable, say by retrying to connect, a RecoverableException should be thrown. There is no guarantee that by throwing a Recoverable exception that the Mule instance will not shut down.

Specified by:

initialise in interface Initialisable

Throws:

InitialisationException - if a fatal error occurs causing the Mule instance to shutdown

RecoverableException - if an error occurs that can be recovered from

createStaticContext

protected void createStaticContext()

loadGlobalFunctions

protected void loadGlobalFunctions()
                            throws InitialisationException

Throws:

InitialisationException

evaluate

public <T> T evaluate(String expression)

Description copied from interface: ExpressionLanguage

Execute the expression returning the result. The expression will be executed by the expression language implementation without making any event or message context available.

Specified by:

evaluate in interface ExpressionLanguage

Type Parameters:

T - the return type expected

Parameters:

expression - the expression to be executed

Returns:

the result of execution of the expression.

evaluate

public <T> T evaluate(String expression,
             Map<String,Object> vars)

Description copied from interface: ExpressionLanguage

Execute the expression returning the result. The expression will be executed by the expression language implementation without making any event or message context available. A Map of variables can be provided that will be able to the expression when executed. Variable provided in the map will only be available if there are no conflicts with context variables provided by the expression language implementation.

Specified by:

evaluate in interface ExpressionLanguage

Type Parameters:

T - the return type expected

Parameters:

expression - the expression to be executed

vars - a map of expression variables

Returns:

the result of execution of the expression.

evaluate

public <T> T evaluate(String expression,
             MuleEvent event)

Description copied from interface: ExpressionLanguage

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.

Specified by:

evaluate in interface ExpressionLanguage

Type Parameters:

T - the return type expected

Parameters:

expression - the expression to be executed

event - the current event being processed

Returns:

the result of execution of the expression.

evaluate

public <T> T evaluate(String expression,
             MuleEvent event,
             Map<String,Object> vars)

Description copied from interface: ExpressionLanguage

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. A Map of variables can be provided that will be able to the expression when executed. Variable provided in the map will only be available if there are no conflict with context variables provided by the expression language implementation.

Specified by:

evaluate in interface ExpressionLanguage

Type Parameters:

T - the return type expected

Parameters:

expression - the expression to be executed

event - the current event being processed

vars - a map of expression variables

Returns:

the result of execution of the expression.

evaluate

@Deprecated
public <T> T evaluate(String expression,
                        MuleMessage message)

Deprecated.

Description copied from interface: ExpressionLanguage

Required to provide gradual migration to use of MuleEvent signatures

Specified by:

evaluate in interface ExpressionLanguage

See Also:

ExpressionLanguage.evaluate(String, MuleEvent)

evaluate

@Deprecated
public <T> T evaluate(String expression,
                        MuleMessage message,
                        Map<String,Object> vars)

Deprecated.

Description copied from interface: ExpressionLanguage

Required to provide gradual migration to use of MuleEvent signatures

Specified by:

evaluate in interface ExpressionLanguage

See Also:

ExpressionLanguage.evaluate(String, MuleEvent)

enrich

public void enrich(String expression,
          MuleMessage message,
          TypedValue typedValue)

Description copied from interface: ExpressionLanguage

Enriches a message

Specified by:

enrich in interface ExpressionLanguage

Parameters:

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

message - The message to be enriched

typedValue - The typed value used for enrichment

evaluateTyped

public TypedValue evaluateTyped(String expression,
                       MuleMessage message)

Specified by:

evaluateTyped in interface ExpressionLanguage

evaluateInternal

protected <T> T evaluateInternal(String expression,
                     MVELExpressionLanguageContext variableResolverFactory)

isValid

public boolean isValid(String expression)

Description copied from interface: ExpressionLanguage

Validates the expression returning true is the expression is valid, false otherwise.. All implementors should should validate expression syntactically. Semantic validation is optional.

Specified by:

isValid in interface ExpressionLanguage

Returns:

validate

public void validate(String expression)
              throws InvalidExpressionException

Description copied from interface: ExpressionLanguage

Validates the expression returning. An InvalidExpressionException will be thrown is the All implementors should should validate expression syntactically. Semantic validation is optional.

Specified by:

validate in interface ExpressionLanguage

Throws:

InvalidExpressionException

createExpressionLanguageContext

protected MVELExpressionLanguageContext createExpressionLanguageContext()

createParserConfiguration

public static org.mule.mvel2.ParserConfiguration createParserConfiguration(Map<String,Class<?>> imports)

configureParserConfiguration

protected static void configureParserConfiguration(org.mule.mvel2.ParserConfiguration parserConfiguration,
                                Map<String,Class<?>> imports)

setGlobalFunctionsString

public void setGlobalFunctionsString(String globalFunctionsString)

setAliases

public void setAliases(Map<String,String> aliases)

setImports

public void setImports(Map<String,Class<?>> imports)

setAutoResolveVariables

public void setAutoResolveVariables(boolean autoResolveVariables)

setDataTypeResolver

public void setDataTypeResolver(MvelDataTypeResolver dataTypeResolver)

addGlobalFunction

public void addGlobalFunction(String name,
                     org.mule.mvel2.ast.Function function)

addImport

public void addImport(String name,
             Class<?> clazz)

addAlias

public void addAlias(String name,
            String expression)

setGlobalFunctionsFile

public void setGlobalFunctionsFile(String globalFunctionsFile)

createVariableVariableResolverFactory

protected org.mule.mvel2.integration.VariableResolverFactory createVariableVariableResolverFactory(MuleEvent event)

createVariableVariableResolverFactory

@Deprecated
protected org.mule.mvel2.integration.VariableResolverFactory createVariableVariableResolverFactory(MuleMessage message)

Deprecated.

getAliases

public Map<String,String> getAliases()

getGlobalFunctions

public Map<String,org.mule.mvel2.ast.Function> getGlobalFunctions()

getParserConfiguration

public org.mule.mvel2.ParserConfiguration getParserConfiguration()