public class ExpressionEvaluator extends ScriptEvaluator implements IExpressionEvaluator
IExpressionEvaluator
is implemented by creating and compiling a temporary
compilation unit defining one class with one static method with one RETURN statement.
A number of "convenience constructors" exist that execute the set-up steps described for IExpressionEvaluator
instantly.
If the parameter and return types of the expression are known at compile time, then a "fast"
expression evaluator can be instantiated through
createFastExpressionEvaluator(String, Class, String[], ClassLoader)
. Expression
evaluation is faster than through ScriptEvaluator.evaluate(Object[])
, because it is not done through
reflection but through direct method invocation.
Example:
public interface Foo { int bar(int a, int b); } ... Foo f = (Foo) ExpressionEvaluator.createFastExpressionEvaluator( "a + b", // expression to evaluate Foo.class, // interface that describes the expression's signature new String[] { "a", "b" }, // the parameters' names (ClassLoader) null // Use current thread's context class loader ); System.out.println("1 + 2 = " + f.bar(1, 2)); // Evaluate the expressionNotice: The
interfaceToImplement
must either be declared public
,
or with package scope in the root package (i.e. "no" package).
On my system (Intel P4, 2 GHz, MS Windows XP, JDK 1.4.1), expression "x + 1" evaluates as follows:
Server JVM | Client JVM | |
---|---|---|
Normal EE | 23.7 ns | 64.0 ns |
Fast EE | 31.2 ns | 42.2 ns |
optionalOverrideMethod, optionalReturnTypes, optionalStaticMethod
ANY_TYPE
DEFAULT_CLASS_NAME
BOOT_CLASS_LOADER, SYSTEM_PROPERTY_SOURCE_DEBUGGING_DIR, SYSTEM_PROPERTY_SOURCE_DEBUGGING_ENABLE
Constructor and Description |
---|
ExpressionEvaluator() |
ExpressionEvaluator(Scanner scanner,
String className,
Class optionalExtendedType,
Class[] implementedTypes,
boolean staticMethod,
Class expressionType,
String methodName,
String[] parameterNames,
Class[] parameterTypes,
Class[] thrownExceptions,
ClassLoader optionalParentClassLoader)
Equivalent to
|
ExpressionEvaluator(String expression,
Class expressionType,
String[] parameterNames,
Class[] parameterTypes)
Equivalent to
|
ExpressionEvaluator(String expression,
Class expressionType,
String[] parameterNames,
Class[] parameterTypes,
Class[] thrownExceptions,
Class optionalExtendedType,
Class[] implementedTypes,
ClassLoader optionalParentClassLoader)
Equivalent to
|
ExpressionEvaluator(String expression,
Class expressionType,
String[] parameterNames,
Class[] parameterTypes,
Class[] thrownExceptions,
ClassLoader optionalParentClassLoader)
Equivalent to
|
Modifier and Type | Method and Description |
---|---|
static Object |
createFastExpressionEvaluator(Scanner scanner,
String[] optionalDefaultImports,
String className,
Class optionalExtendedType,
Class interfaceToImplement,
String[] parameterNames,
ClassLoader optionalParentClassLoader)
Deprecated.
|
static Object |
createFastExpressionEvaluator(Scanner scanner,
String className,
Class optionalExtendedType,
Class interfaceToImplement,
String[] parameterNames,
ClassLoader optionalParentClassLoader)
Deprecated.
|
static Object |
createFastExpressionEvaluator(String expression,
Class interfaceToImplement,
String[] parameterNames,
ClassLoader optionalParentClassLoader)
Deprecated.
|
protected Class |
getDefaultReturnType() |
static String[] |
guessParameterNames(Scanner scanner)
Guess the names of the parameters used in the given expression.
|
protected List<Java.BlockStatement> |
makeStatements(int idx,
Parser parser)
Fills the given
block by parsing statements until EOF and adding them to the block. |
void |
setExpressionType(Class expressionType)
Define the type of the expression.
|
void |
setExpressionTypes(Class[] expressionTypes)
Same as
IExpressionEvaluator.setExpressionType(Class) , but for multiple expressions. |
void |
setReturnType(Class returnType)
Deprecated.
setExpressionType(Class) should be called instead. |
void |
setReturnTypes(Class[] returnTypes)
Deprecated.
setExpressionTypes(Class[]) should be called instead. |
cook, cook, cook, cook, cook, cook, cook, createFastEvaluator, createFastEvaluator, createFastEvaluator, createFastScriptEvaluator, createFastScriptEvaluator, createFastScriptEvaluator, createFastScriptEvaluator, createInstance, evaluate, evaluate, getMethod, getMethod, makeMethodDeclaration, setMethodName, setMethodNames, setOverrideMethod, setOverrideMethod, setParameters, setParameters, setStaticMethod, setStaticMethod, setThrownExceptions, setThrownExceptions
addPackageMemberClassDeclaration, compileToClass, createFastClassBodyEvaluator, createFastClassBodyEvaluator, getClazz, makeCompilationUnit, setClassName, setDefaultImports, setExtendedClass, setExtendedType, setImplementedInterfaces, setImplementedTypes
assertNotCooked, classesToTypes, classToType, compileToClassLoader, cook, cook, equals, getClassLoader, hashCode, main, setCompileErrorHandler, setDebuggingInformation, setParentClassLoader, setWarningHandler
cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, readString
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
createFastEvaluator, createFastEvaluator, evaluate
cook, cook, cook, cook, evaluate, getMethod, getMethod, setMethodName, setMethodNames, setOverrideMethod, setOverrideMethod, setParameters, setParameters, setStaticMethod, setStaticMethod, setThrownExceptions, setThrownExceptions
createInstance, getClazz, setClassName, setDefaultImports, setExtendedClass, setExtendedType, setImplementedInterfaces, setImplementedTypes
cook, cook, cook, cook, cook, cook, cook, cook, cookFile, cookFile, cookFile, cookFile, setCompileErrorHandler, setDebuggingInformation, setParentClassLoader, setWarningHandler
public ExpressionEvaluator(String expression, Class expressionType, String[] parameterNames, Class[] parameterTypes) throws CompileException
ExpressionEvaluator ee = new ExpressionEvaluator(); ee.setExpressionType(expressionType); ee.setParameters(parameterNames, parameterTypes); ee.cook(expression);
public ExpressionEvaluator(String expression, Class expressionType, String[] parameterNames, Class[] parameterTypes, Class[] thrownExceptions, ClassLoader optionalParentClassLoader) throws CompileException
ExpressionEvaluator ee = new ExpressionEvaluator(); ee.setExpressionType(expressionType); ee.setParameters(parameterNames, parameterTypes); ee.setThrownExceptions(thrownExceptions); ee.setParentClassLoader(optionalParentClassLoader); ee.cook(expression);
public ExpressionEvaluator(String expression, Class expressionType, String[] parameterNames, Class[] parameterTypes, Class[] thrownExceptions, Class optionalExtendedType, Class[] implementedTypes, ClassLoader optionalParentClassLoader) throws CompileException
ExpressionEvaluator ee = new ExpressionEvaluator(); ee.setExpressionType(expressionType); ee.setParameters(parameterNames, parameterTypes); ee.setThrownExceptions(thrownExceptions); ee.setExtendedType(optionalExtendedType); ee.setImplementedTypes(implementedTypes); ee.setParentClassLoader(optionalParentClassLoader); ee.cook(expression);
CompileException
ExpressionEvaluator()
,
setExpressionType(Class)
,
ScriptEvaluator.setParameters(String[], Class[])
,
ScriptEvaluator.setThrownExceptions(Class[])
,
ClassBodyEvaluator.setExtendedClass(Class)
,
ClassBodyEvaluator.setImplementedInterfaces(Class[])
,
SimpleCompiler.setParentClassLoader(ClassLoader)
,
Cookable.cook(String)
public ExpressionEvaluator(Scanner scanner, String className, Class optionalExtendedType, Class[] implementedTypes, boolean staticMethod, Class expressionType, String methodName, String[] parameterNames, Class[] parameterTypes, Class[] thrownExceptions, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ExpressionEvaluator ee = new ExpressionEvaluator(); ee.setClassName(className); ee.setExtendedType(optionalExtendedType); ee.setImplementedTypes(implementedTypes); ee.setStaticMethod(staticMethod); ee.setExpressionType(expressionType); ee.setMethodName(methodName); ee.setParameters(parameterNames, parameterTypes); ee.setThrownExceptions(thrownExceptions); ee.setParentClassLoader(optionalParentClassLoader); ee.cook(scanner);
CompileException
IOException
IExpressionEvaluator
,
IClassBodyEvaluator.setClassName(String)
,
IClassBodyEvaluator.setExtendedClass(Class)
,
IClassBodyEvaluator.setImplementedInterfaces(Class[])
,
IScriptEvaluator.setStaticMethod(boolean)
,
IExpressionEvaluator.setExpressionType(Class)
,
IScriptEvaluator.setMethodName(String)
,
IScriptEvaluator.setParameters(String[], Class[])
,
IScriptEvaluator.setThrownExceptions(Class[])
,
ICookable.setParentClassLoader(ClassLoader)
,
ICookable.cook(Reader)
public ExpressionEvaluator()
public void setExpressionType(Class expressionType)
IExpressionEvaluator
IExpressionEvaluator.ANY_TYPE
allows the expression
to return any type (primitive or reference).
If expressionType
is Void.TYPE
, then the expression must be an
invocation of a void
method.
Defaults to IExpressionEvaluator.ANY_TYPE
.
setExpressionType
in interface IExpressionEvaluator
public void setExpressionTypes(Class[] expressionTypes)
IExpressionEvaluator
IExpressionEvaluator.setExpressionType(Class)
, but for multiple expressions.setExpressionTypes
in interface IExpressionEvaluator
@Deprecated public final void setReturnType(Class returnType)
setExpressionType(Class)
should be called instead.ScriptEvaluator
setReturnType
in interface IExpressionEvaluator
setReturnType
in interface IScriptEvaluator
setReturnType
in class ScriptEvaluator
returnType
- The method's return type; null
means the "default return type", which is the type
returned by ScriptEvaluator.getDefaultReturnType()
(void.class
for ScriptEvaluator
and Object.class
for ExpressionEvaluator
)ScriptEvaluator.getDefaultReturnType()
,
getDefaultReturnType()
@Deprecated public final void setReturnTypes(Class[] returnTypes)
setExpressionTypes(Class[])
should be called instead.ScriptEvaluator
setReturnTypes
in interface IExpressionEvaluator
setReturnTypes
in interface IScriptEvaluator
setReturnTypes
in class ScriptEvaluator
returnTypes
- The methods' return types; null
elements mean the "default return type", which is the
type returned by ScriptEvaluator.getDefaultReturnType()
(void.class
for ScriptEvaluator
and Object.class
for ExpressionEvaluator
)ScriptEvaluator.getDefaultReturnType()
,
getDefaultReturnType()
protected Class getDefaultReturnType()
getDefaultReturnType
in class ScriptEvaluator
void.class
ScriptEvaluator.setReturnTypes(Class[])
protected List<Java.BlockStatement> makeStatements(int idx, Parser parser) throws CompileException, IOException
ScriptEvaluator
block
by parsing statements until EOF and adding them to the block.makeStatements
in class ScriptEvaluator
CompileException
IOException
@Deprecated public static Object createFastExpressionEvaluator(String expression, Class interfaceToImplement, String[] parameterNames, ClassLoader optionalParentClassLoader) throws CompileException
ScriptEvaluator.createFastEvaluator(String, Class, String[])
instead:IExpressionEvaluator
ee =CompilerFactoryFactory
.getDefaultCompilerFactory
().newExpressionEvaluator
(); ee.setParentClassLoader(optionalParentClassLoader); return ee.createFastEvaluator
(expression, interfaceToImplement, parameterNames);
CompileException
@Deprecated public static Object createFastExpressionEvaluator(Scanner scanner, String className, Class optionalExtendedType, Class interfaceToImplement, String[] parameterNames, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ScriptEvaluator.createFastEvaluator(Reader, Class, String[])
insteadIExpressionEvaluator
, and is hence only available in this
implementation of org.codehaus.commons.compiler
. To be independent from this particular
implementation, try to switch to ScriptEvaluator.createFastEvaluator(Reader, Class, String[])
.CompileException
IOException
@Deprecated public static Object createFastExpressionEvaluator(Scanner scanner, String[] optionalDefaultImports, String className, Class optionalExtendedType, Class interfaceToImplement, String[] parameterNames, ClassLoader optionalParentClassLoader) throws CompileException, IOException
ScriptEvaluator.createFastEvaluator(Reader, Class, String[])
insteadIExpressionEvaluator
, and is hence only available in this
implementation of org.codehaus.commons.compiler
. To be independent from this particular
implementation, try to switch to ScriptEvaluator.createFastEvaluator(Reader, Class, String[])
.CompileException
IOException
public static String[] guessParameterNames(Scanner scanner) throws CompileException, IOException
CompileException
IOException
Scanner.Scanner(String, Reader)
Copyright © 2001–2016. All rights reserved.