org.apache.commons.jexl2
Interface Script

All Known Implementing Classes:
ExpressionImpl

public interface Script

A JEXL Script.

A script is some valid JEXL syntax to be executed with a given set of JexlContext variables.

A script is a group of statements, separated by semicolons.

The statements can be blocks (curly braces containing code), Control statements such as if and while as well as expressions and assignment statements.

Since:
1.1

Method Summary
 Callable<Object> callable(JexlContext context)
          Creates a Callable from this script.
 Callable<Object> callable(JexlContext context, Object... args)
          Creates a Callable from this script.
 Object execute(JexlContext context)
          Executes the script with the variables contained in the supplied JexlContext.
 Object execute(JexlContext context, Object... args)
          Executes the script with the variables contained in the supplied JexlContext and a set of arguments corresponding to the parameters used during parsing.
 String[] getLocalVariables()
          Gets this script local variables.
 String[] getParameters()
          Gets this script parameters.
 String getText()
          Returns the text of this Script.
 Set<List<String>> getVariables()
          Gets this script variables.
 

Method Detail

execute

Object execute(JexlContext context)
Executes the script with the variables contained in the supplied JexlContext.

Parameters:
context - A JexlContext containing variables.
Returns:
The result of this script, usually the result of the last statement.

execute

Object execute(JexlContext context,
               Object... args)
Executes the script with the variables contained in the supplied JexlContext and a set of arguments corresponding to the parameters used during parsing.

Parameters:
context - A JexlContext containing variables.
args - the arguments
Returns:
The result of this script, usually the result of the last statement.
Since:
2.1

getText

String getText()
Returns the text of this Script.

Returns:
The script to be executed.

getParameters

String[] getParameters()
Gets this script parameters.

Returns:
the parameters or null
Since:
2.1

getLocalVariables

String[] getLocalVariables()
Gets this script local variables.

Returns:
the local variables or null
Since:
2.1

getVariables

Set<List<String>> getVariables()
Gets this script variables.

Note that since variables can be in an ant-ish form (ie foo.bar.quux), each variable is returned as a list of strings where each entry is a fragment of the variable ({"foo", "bar", "quux"} in the example.

Returns:
the variables or null
Since:
2.1

callable

Callable<Object> callable(JexlContext context)
Creates a Callable from this script.

This allows to submit it to an executor pool and provides support for asynchronous calls.

The interpreter will handle interruption/cancellation gracefully if needed.

Parameters:
context - the context
Returns:
the callable
Since:
2.1

callable

Callable<Object> callable(JexlContext context,
                          Object... args)
Creates a Callable from this script.

This allows to submit it to an executor pool and provides support for asynchronous calls.

The interpreter will handle interruption/cancellation gracefully if needed.

Parameters:
context - the context
args - the script arguments
Returns:
the callable
Since:
2.1


Copyright © 2001-2011 The Apache Software Foundation. All Rights Reserved.