org.apache.tinkerpop.gremlin.groovy.jsr223

Class GremlinGroovyScriptEngine

java.lang.Object

GroovyScriptEngineImpl

org.apache.tinkerpop.gremlin.groovy.jsr223.GremlinGroovyScriptEngine

All Implemented Interfaces:

AutoCloseable, ScriptEngine, GremlinScriptEngine

public class GremlinGroovyScriptEngine
extends GroovyScriptEngineImpl
implements AutoCloseable, GremlinScriptEngine

Provides methods to compile and evaluate Gremlin scripts. Compiled scripts are stored in a managed cache to cut down on compilation times of future evaluations of the same script. This ScriptEngine implementation is heavily adapted from the GroovyScriptEngineImpl to include some additional functionality.

Author:

Marko A. Rodriguez (http://markorodriguez.com), Stephen Mallette (http://stephen.genoprime.com)

See Also:

GremlinExecutor

Field Summary

Fields

Modifier and Type	Field and Description
static String	COLLECTED_BOUND_VARS_MAP_VARNAME Name of variable that holds local variables to be globally bound if "interpreter mode" is enabled with InterpreterModeGroovyCustomizer.
static ThreadLocal<Map<String,Object>>	COMPILE_OPTIONS
static String	COMPILE_OPTIONS_VAR_TYPES An "internal" key for sandboxing the script engine - technically not for public use.
static String	KEY_REFERENCE_TYPE The attribute key (passed as a binding on the context) for how to cache scripts.
static String	REFERENCE_TYPE_HARD A value to the KEY_REFERENCE_TYPE that makes the evaluated script available in the cache for the life of the JVM.
static String	REFERENCE_TYPE_PHANTOM A value to the KEY_REFERENCE_TYPE that immediately garbage collects the script after evaluation.
static String	REFERENCE_TYPE_SOFT A value to the KEY_REFERENCE_TYPE that retains the script until memory is "low" and therefore should be reclaimed before an OutOfMemoryError occurs.
static String	REFERENCE_TYPE_WEAK A value to the KEY_REFERENCE_TYPE that marks the script as one that can be garbage collected even when memory is abundant.

Fields inherited from interface org.apache.tinkerpop.gremlin.jsr223.GremlinScriptEngine

HIDDEN_G

Fields inherited from interface javax.script.ScriptEngine

ARGV, ENGINE, ENGINE_VERSION, FILENAME, LANGUAGE, LANGUAGE_VERSION, NAME

Constructor Summary

Constructors

Constructor and Description
GremlinGroovyScriptEngine() Creates a new instance using no Customizer.
GremlinGroovyScriptEngine(Customizer... customizers)

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. As of release 3.2.4, not replaced as this class will not implement AutoCloseable in the future.
CompiledScript	compile(Reader reader)
CompiledScript	compile(String scriptSource)
Bindings	createBindings() Create bindings to be used by this ScriptEngine.
Traversal.Admin	eval(Bytecode bytecode, Bindings bindings, String traversalSource) Evaluates Traversal Bytecode with the specified Bindings.
Object	eval(Reader reader, ScriptContext context)
Object	eval(String script, ScriptContext context)
double	getClassCacheAverageLoadPenalty() Gets the average time spent compiling new scripts.
long	getClassCacheEstimatedSize() Gets the estimated size of the class cache for compiled scripts.
long	getClassCacheEvictionCount() Gets the number of times a script compiled to a class has been evicted from the cache.
long	getClassCacheEvictionWeight() Gets the sum of the weights of evicted entries from the class cache.
long	getClassCacheHitCount() Gets the number of times cache look up for a compiled script returned a cached value.
double	getClassCacheHitRate() Gets the hit rate of the class cache.
long	getClassCacheLoadCount() Gets the total number of times the cache lookup method attempted to compile new scripts.
long	getClassCacheLoadFailureCount() Gets the total number of times the cache lookup method failed to compile a new script.
double	getClassCacheLoadFailureRate() Gets the ratio of script compilation attempts that failed.
long	getClassCacheLoadSuccessCount() Gets the total number of times the cache lookup method succeeded to compile a new script.
long	getClassCacheLongRunCompilationCount() Gets the number of compilations that extended beyond the expectedCompilationTime.
long	getClassCacheMissCount() Gets the total number of times the cache lookup method returned a newly compiled script.
double	getClassCacheMissRate() Gets the ratio of script compilation attempts that were misses.
long	getClassCacheRequestCount() Gets the total number of times the cache lookup method returned a cached or uncached value.
long	getClassCacheTotalLoadTime() Gets the total number of nanoseconds that the cache spent compiling scripts.
GremlinScriptEngineFactory	getFactory()
<T> T	getInterface(Class<T> clazz)
<T> T	getInterface(Object thiz, Class<T> clazz)
protected ClassLoader	getParentLoader()
Set	getPlugins() Get the list of loaded plugins.
protected ScriptContext	getScriptContext(Bindings nn) Creates the ScriptContext using a GremlinScriptContext which avoids a significant amount of additional object creation on script evaluation.
Object	invokeFunction(String name, Object... args)
Object	invokeMethod(Object thiz, String name, Object... args)
void	reset() Resets the entire GremlinGroovyScriptEngine by clearing script caches, recreating the classloader, clearing bindings.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.tinkerpop.gremlin.jsr223.GremlinScriptEngine

eval, eval, eval

Methods inherited from interface javax.script.ScriptEngine

eval, eval, eval, eval, get, getBindings, getContext, put, setBindings, setContext

Field Detail

COMPILE_OPTIONS_VAR_TYPES

public static final String COMPILE_OPTIONS_VAR_TYPES

An "internal" key for sandboxing the script engine - technically not for public use.

See Also:

Constant Field Values

KEY_REFERENCE_TYPE

public static final String KEY_REFERENCE_TYPE

The attribute key (passed as a binding on the context) for how to cache scripts. The value must be one of the following:

• REFERENCE_TYPE_HARD
• REFERENCE_TYPE_SOFT
• REFERENCE_TYPE_WEAK
• REFERENCE_TYPE_PHANTOM

See Also:

Constant Field Values

REFERENCE_TYPE_PHANTOM

public static final String REFERENCE_TYPE_PHANTOM

A value to the KEY_REFERENCE_TYPE that immediately garbage collects the script after evaluation.

See Also:

Constant Field Values

REFERENCE_TYPE_WEAK

public static final String REFERENCE_TYPE_WEAK

A value to the KEY_REFERENCE_TYPE that marks the script as one that can be garbage collected even when memory is abundant.

See Also:

Constant Field Values

REFERENCE_TYPE_SOFT

public static final String REFERENCE_TYPE_SOFT

A value to the KEY_REFERENCE_TYPE that retains the script until memory is "low" and therefore should be reclaimed before an OutOfMemoryError occurs.

See Also:

Constant Field Values

REFERENCE_TYPE_HARD

public static final String REFERENCE_TYPE_HARD

A value to the KEY_REFERENCE_TYPE that makes the evaluated script available in the cache for the life of the JVM.

See Also:

Constant Field Values

COLLECTED_BOUND_VARS_MAP_VARNAME

public static final String COLLECTED_BOUND_VARS_MAP_VARNAME

Name of variable that holds local variables to be globally bound if "interpreter mode" is enabled with InterpreterModeGroovyCustomizer.

See Also:

Constant Field Values

COMPILE_OPTIONS

public static final ThreadLocal<Map<String,Object>> COMPILE_OPTIONS

Constructor Detail

GremlinGroovyScriptEngine

public GremlinGroovyScriptEngine()

Creates a new instance using no Customizer.

GremlinGroovyScriptEngine

public GremlinGroovyScriptEngine(Customizer... customizers)

Method Detail

getPlugins

public Set getPlugins()

Get the list of loaded plugins.

eval

public Traversal.Admin eval(Bytecode bytecode,
                            Bindings bindings,
                            String traversalSource)
                     throws ScriptException

Description copied from interface: GremlinScriptEngine

Evaluates Traversal Bytecode with the specified Bindings. These Bindings supplied to this method will be merged with global engine bindings and override them where keys match.

Specified by:

eval in interface GremlinScriptEngine

Throws:

ScriptException

close

@Deprecated
public void close()
                       throws Exception

Deprecated. As of release 3.2.4, not replaced as this class will not implement AutoCloseable in the future.

Specified by:

close in interface AutoCloseable

Throws:

Exception

reset

public void reset()

Resets the entire GremlinGroovyScriptEngine by clearing script caches, recreating the classloader, clearing bindings.

getScriptContext

protected ScriptContext getScriptContext(Bindings nn)

Creates the ScriptContext using a GremlinScriptContext which avoids a significant amount of additional object creation on script evaluation.

eval

public Object eval(Reader reader,
                   ScriptContext context)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

eval

public Object eval(String script,
                   ScriptContext context)
            throws ScriptException

Specified by:

eval in interface ScriptEngine

Throws:

ScriptException

createBindings

public Bindings createBindings()

Create bindings to be used by this ScriptEngine. In this case, SimpleBindings are returned.

Specified by:

createBindings in interface ScriptEngine

getFactory

public GremlinScriptEngineFactory getFactory()

Specified by:

getFactory in interface ScriptEngine

Specified by:

getFactory in interface GremlinScriptEngine

compile

public CompiledScript compile(String scriptSource)
                       throws ScriptException

Throws:

ScriptException

compile

public CompiledScript compile(Reader reader)
                       throws ScriptException

Throws:

ScriptException

invokeFunction

public Object invokeFunction(String name,
                             Object... args)
                      throws ScriptException,
                             NoSuchMethodException

Throws:

ScriptException

NoSuchMethodException

invokeMethod

public Object invokeMethod(Object thiz,
                           String name,
                           Object... args)
                    throws ScriptException,
                           NoSuchMethodException

Throws:

ScriptException

NoSuchMethodException

getInterface

public <T> T getInterface(Class<T> clazz)

getInterface

public <T> T getInterface(Object thiz,
                          Class<T> clazz)

getClassCacheLongRunCompilationCount

public long getClassCacheLongRunCompilationCount()

Gets the number of compilations that extended beyond the expectedCompilationTime.

getClassCacheEstimatedSize

public long getClassCacheEstimatedSize()

Gets the estimated size of the class cache for compiled scripts.

getClassCacheAverageLoadPenalty

public double getClassCacheAverageLoadPenalty()

Gets the average time spent compiling new scripts.

getClassCacheEvictionCount

public long getClassCacheEvictionCount()

Gets the number of times a script compiled to a class has been evicted from the cache.

getClassCacheEvictionWeight

public long getClassCacheEvictionWeight()

Gets the sum of the weights of evicted entries from the class cache.

getClassCacheHitCount

public long getClassCacheHitCount()

Gets the number of times cache look up for a compiled script returned a cached value.

getClassCacheHitRate

public double getClassCacheHitRate()

Gets the hit rate of the class cache.

getClassCacheLoadCount

public long getClassCacheLoadCount()

Gets the total number of times the cache lookup method attempted to compile new scripts.

getClassCacheLoadFailureCount

public long getClassCacheLoadFailureCount()

Gets the total number of times the cache lookup method failed to compile a new script.

getClassCacheLoadFailureRate

public double getClassCacheLoadFailureRate()

Gets the ratio of script compilation attempts that failed.

getClassCacheLoadSuccessCount

public long getClassCacheLoadSuccessCount()

Gets the total number of times the cache lookup method succeeded to compile a new script.

getClassCacheMissCount

public long getClassCacheMissCount()

Gets the total number of times the cache lookup method returned a newly compiled script.

getClassCacheMissRate

public double getClassCacheMissRate()

Gets the ratio of script compilation attempts that were misses.

getClassCacheRequestCount

public long getClassCacheRequestCount()

Gets the total number of times the cache lookup method returned a cached or uncached value.

getClassCacheTotalLoadTime

public long getClassCacheTotalLoadTime()

Gets the total number of nanoseconds that the cache spent compiling scripts.

getParentLoader

protected ClassLoader getParentLoader()