AviatorEvaluator (aviator 4.1.1 API)

java.lang.Object
- com.googlecode.aviator.AviatorEvaluator

public final class AviatorEvaluator
extends Object

Avaitor Expression evaluator

Author:: dennis

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BYTECODE_VER` Deprecated.
`static int`	`COMPILE` Optimized for compile speed
`static int`	`EVAL` Optimized for execute speed,this is the default option
`static Map<String,Object>`	`FUNC_MAP` Deprecated. please use instance's field.
`static Map<OperatorType,AviatorFunction>`	`OPS_MAP` Deprecated. please use instance's field.
`static String`	`VERSION` Aviator version

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`addFunction(AviatorFunction function)` Add an aviator function,it's not thread-safe.
`static void`	`addFunctionLoader(FunctionLoader loader)` Adds a function loader.
`static void`	`addOpFunction(OperatorType opType, AviatorFunction function)` Add an operator aviator function,it's not thread-safe.
`static void`	`clearExpressionCache()` Clear all cached compiled expression
`static Expression`	`compile(String expression)` Compile a text expression to Expression Object without caching
`static Expression`	`compile(String expression, boolean cached)` Compile a text expression to Expression object
`static boolean`	`containsFunction(String name)` Check if the function is existed in aviator
`static void`	`defineFunction(String name, String expression)` Define a function by name and expression.
`static void`	`defineFunction(String name, String expression, Map<String,Object> env)` Define a function by name and expression with the execution env.
`static Object`	`exec(String expression, Object... values)` Deprecated.
`static Object`	`execute(String expression)` Execute a text expression without caching and env map.
`static Object`	`execute(String expression, Map<String,Object> env)` Execute a text expression without caching
`static Object`	`execute(String expression, Map<String,Object> env, boolean cached)` Execute a text expression with environment
`static AviatorClassLoader`	`getAviatorClassLoader()` Returns classloader
`static AviatorClassLoader`	`getAviatorClassLoader(boolean cached)` Returns classloader
`static Expression`	`getCachedExpression(String expression)` Returns a compiled expression in cache
`static AviatorFunction`	`getFunction(String name)` Retrieve an aviator function by name,throw exception if not found or null.It's not thread-safe.
`static AviatorEvaluatorInstance`	`getInstance()` Get the default evaluator instance
`static MathContext`	`getMathContext()` Deprecated. Please use `getOption(Options)`
`static AviatorFunction`	`getOpFunction(OperatorType opType)` Retrieve an operator aviator function by op type, return null if not found.It's not thread-safe.
`static <T> T`	`getOption(Options opt)` Deprecated.
`static OutputStream`	`getTraceOutputStream()` Get current trace output stream,default is System.out
`static void`	`invalidateCache(String expression)` Invalidate expression cache
`static AviatorEvaluatorInstance`	`newInstance()` Create a aviator evaluator instance.
`static AviatorFunction`	`removeFunction(AviatorFunction function)` Remove a aviator function
`static AviatorFunction`	`removeFunction(String name)` Remove an aviator function by name,it's not thread-safe.
`static void`	`removeFunctionLoader(FunctionLoader loader)` Removes a function loader.
`static AviatorFunction`	`removeOpFunction(OperatorType opType)` Remove an operator aviator function by op type, it's not thread-safe.
`static void`	`setAviatorClassLoader(AviatorClassLoader aviatorClassLoader)` Deprecated.
`static void`	`setBYTECODE_VER(int nversion)`
`static void`	`setMathContext(MathContext mathContext)` Deprecated. please use `setOption(Options, Object)`
`static void`	`setOptimize(int value)` Deprecated. please use `setOption(Options, Object)`
`static void`	`setOption(Options opt, Object val)` Adds a evaluator option
`static void`	`setTrace(boolean t)` Deprecated. please use `setOption(Options, Object)`
`static void`	`setTraceOutputStream(OutputStream traceOutputStream)` Set trace output stream

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - COMPILE
```
public static final int COMPILE
```
    Optimized for compile speed
    
    See Also:
    Constant Field Values
  - EVAL
```
public static final int EVAL
```
    Optimized for execute speed,this is the default option
    
    See Also:
    Constant Field Values
  - VERSION
```
public static final String VERSION
```
    Aviator version
    
    See Also:
    Constant Field Values
  - FUNC_MAP
```
@Deprecated
public static final Map<String,Object> FUNC_MAP
```
    Deprecated. please use instance's field.
    
    The global evaluator's functions map.
    
    See Also:
    AviatorEvaluatorInstance.getFuncMap()
  - OPS_MAP
```
@Deprecated
public static final Map<OperatorType,AviatorFunction> OPS_MAP
```
    Deprecated. please use instance's field.
    
    The global evaluator's operators map.
    
    See Also:
    AviatorEvaluatorInstance.getOpsMap()
  - BYTECODE_VER
```
@Deprecated
public static int BYTECODE_VER
```
    Deprecated.
    
    The global evaluator's byte code version.
    
    See Also:
    AviatorEvaluatorInstance.getBytecodeVersion()
- Method Detail
  - newInstance
```
public static AviatorEvaluatorInstance newInstance()
```
    Create a aviator evaluator instance.
    
    Returns:
  - getInstance
```
public static AviatorEvaluatorInstance getInstance()
```
    Get the default evaluator instance
    
    Returns:
    Since:
    
    4.0.0
  - addFunctionLoader
```
public static void addFunctionLoader(FunctionLoader loader)
```
    Adds a function loader.
    
    Parameters:
    loader -
    Since:
    
    4.0.0
    
    See Also:
    FunctionLoader
  - removeFunctionLoader
```
public static void removeFunctionLoader(FunctionLoader loader)
```
    Removes a function loader.
    
    Parameters:
    loader -
    Since:
    
    4.0.0
    
    See Also:
    FunctionLoader
  - setTrace
```
@Deprecated
public static void setTrace(boolean t)
```
    Deprecated. please use setOption(Options, Object)
    
    Configure whether to trace code generation
    
    Parameters:
    t - true is to trace,default is false.
  - setOption
```
public static void setOption(Options opt,
             Object val)
```
    Adds a evaluator option
    
    Parameters:
    opt -
    val -
    Since:
    
    2.3.4
    
    See Also:
    Options
  - getOption
```
@Deprecated
public static <T> T getOption(Options opt)
```
    Deprecated.
    
    Returns the current evaluator option value, returns null if missing.
    
    Parameters:
    opt -
    
    Returns:
  - getTraceOutputStream
```
public static OutputStream getTraceOutputStream()
```
    Get current trace output stream,default is System.out
    
    Returns:
  - getMathContext
```
@Deprecated
public static MathContext getMathContext()
```
    Deprecated. Please use getOption(Options)
    
    Returns current math context for decimal.
    
    Returns:
    Since:
    
    2.3.0
  - setMathContext
```
@Deprecated
public static void setMathContext(MathContext mathContext)
```
    Deprecated. please use setOption(Options, Object)
    
    Set math context for decimal.
    
    Parameters:
    mathContext -
    Since:
    
    2.3.0
  - setTraceOutputStream
```
public static void setTraceOutputStream(OutputStream traceOutputStream)
```
    Set trace output stream
    
    Parameters:
    traceOutputStream -
  - setOptimize
```
@Deprecated
public static void setOptimize(int value)
```
    Deprecated. please use setOption(Options, Object)
    
    set optimize level,default AviatorEvaluator.EVAL
    
    Parameters:
    value -
    See Also:
    COMPILE, EVAL
  - setBYTECODE_VER
```
public static void setBYTECODE_VER(int nversion)
```
  - clearExpressionCache
```
public static void clearExpressionCache()
```
    Clear all cached compiled expression
  - getAviatorClassLoader
```
public static AviatorClassLoader getAviatorClassLoader()
```
    Returns classloader
    
    Returns:
  - getAviatorClassLoader
```
public static AviatorClassLoader getAviatorClassLoader(boolean cached)
```
    Returns classloader
    
    Returns:
  - addFunction
```
public static void addFunction(AviatorFunction function)
```
    Add an aviator function,it's not thread-safe.
    
    Parameters:
    function -
  - defineFunction
```
public static void defineFunction(String name,
                  String expression)
```
    Define a function by name and expression.
    
    Parameters:
    name - the function name
    expression - the expression to be executed and it's result must be a function.
    Since:
    
    4.0.0
  - defineFunction
```
public static void defineFunction(String name,
                  String expression,
                  Map<String,Object> env)
```
    Define a function by name and expression with the execution env.
    
    Parameters:
    name - the function name
    expression - the expression to be executed and it's result must be a function.
    env - the expression execution env
    Since:
    
    4.0.0
  - removeFunction
```
public static AviatorFunction removeFunction(String name)
```
    Remove an aviator function by name,it's not thread-safe.
    
    Parameters:
    name -
    
    Returns:
  - getFunction
```
public static AviatorFunction getFunction(String name)
```
    Retrieve an aviator function by name,throw exception if not found or null.It's not thread-safe.
    
    Parameters:
    name -
    
    Returns:
  - addOpFunction
```
public static void addOpFunction(OperatorType opType,
                 AviatorFunction function)
```
    Add an operator aviator function,it's not thread-safe.
    
    Parameters:
    function -
  - getOpFunction
```
public static AviatorFunction getOpFunction(OperatorType opType)
```
    Retrieve an operator aviator function by op type, return null if not found.It's not thread-safe.
    
    Parameters:
    opType -
    
    Returns:
    Since:
    
    3.3
  - removeOpFunction
```
public static AviatorFunction removeOpFunction(OperatorType opType)
```
    Remove an operator aviator function by op type, it's not thread-safe.
    
    Parameters:
    opType -
    
    Returns:
    Since:
    
    3.3
  - containsFunction
```
public static boolean containsFunction(String name)
```
    Check if the function is existed in aviator
    
    Parameters:
    name -
    
    Returns:
  - removeFunction
```
public static AviatorFunction removeFunction(AviatorFunction function)
```
    Remove a aviator function
    
    Parameters:
    function -
    
    Returns:
  - setAviatorClassLoader
```
@Deprecated
public static void setAviatorClassLoader(AviatorClassLoader aviatorClassLoader)
```
    Deprecated.
    
    Configure user defined classloader
    
    Parameters:
    aviatorClassLoader -
  - getCachedExpression
```
public static Expression getCachedExpression(String expression)
```
    Returns a compiled expression in cache
    
    Parameters:
    expression -
    
    Returns:
  - compile
```
public static Expression compile(String expression,
                 boolean cached)
```
    Compile a text expression to Expression object
    
    Parameters:
    expression - text expression
    cached - Whether to cache the compiled result,make true to cache it.
    
    Returns:
  - compile
```
public static Expression compile(String expression)
```
    Compile a text expression to Expression Object without caching
    
    Parameters:
    expression -
    
    Returns:
  - exec
```
@Deprecated
public static Object exec(String expression,
                     Object... values)
```
    Deprecated.
    
    Execute a text expression with values that are variables order in the expression.It only runs in EVAL mode,and it will cache the compiled expression. It's deprecated, please use execute(String, Map) instead.
    
    Parameters:
    expression -
    values -
    
    Returns:
  - execute
```
public static Object execute(String expression,
             Map<String,Object> env,
             boolean cached)
```
    Execute a text expression with environment
    
    Parameters:
    expression - text expression
    env - Binding variable environment
    cached - Whether to cache the compiled result,make true to cache it.
  - execute
```
public static Object execute(String expression,
             Map<String,Object> env)
```
    Execute a text expression without caching
    
    Parameters:
    expression -
    env -
    
    Returns:
  - invalidateCache
```
public static void invalidateCache(String expression)
```
    Invalidate expression cache
    
    Parameters:
    expression -
  - execute
```
public static Object execute(String expression)
```
    Execute a text expression without caching and env map.
    
    Parameters:
    expression -
    
    Returns:

Class AviatorEvaluator

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

COMPILE

EVAL

VERSION

FUNC_MAP

OPS_MAP

BYTECODE_VER

Method Detail

newInstance

getInstance

addFunctionLoader

removeFunctionLoader

setTrace

setOption

getOption

getTraceOutputStream

getMathContext

setMathContext

setTraceOutputStream

setOptimize

setBYTECODE_VER

clearExpressionCache

getAviatorClassLoader

getAviatorClassLoader

addFunction

defineFunction

defineFunction

removeFunction

getFunction

addOpFunction

getOpFunction

removeOpFunction

containsFunction

removeFunction

setAviatorClassLoader

getCachedExpression

compile

compile

exec

execute

execute

invalidateCache

execute