Groovy Documentation

groovy.util
[Java] Class GroovyScriptEngine

java.lang.Object
  groovy.util.GroovyScriptEngine
All Implemented Interfaces:
ResourceConnector

public class GroovyScriptEngine
extends java.lang.Object

Specific script engine able to reload modified scripts as well as dealing properly with dependent scripts.

Authors:
sam
Marc Palmer
Guillaume Laforge
Jochen Theodorou


Method Summary
java.lang.Object GroovyScriptEngine(java.net.URL[] roots)

java.lang.Object GroovyScriptEngine(java.net.URL[] roots, java.lang.ClassLoader parentClassLoader)

java.lang.Object GroovyScriptEngine(java.lang.String[] urls)

java.lang.Object GroovyScriptEngine(java.lang.String[] urls, java.lang.ClassLoader parentClassLoader)

java.lang.Object GroovyScriptEngine(java.lang.String url)

java.lang.Object GroovyScriptEngine(java.lang.String url, java.lang.ClassLoader parentClassLoader)

java.lang.Object GroovyScriptEngine(ResourceConnector rc)

java.lang.Object GroovyScriptEngine(ResourceConnector rc, java.lang.ClassLoader parentClassLoader)

Script createScript(java.lang.String scriptName, Binding binding)

CompilerConfiguration getConfig()

GroovyClassLoader getGroovyClassLoader()

Returns the GroovyClassLoader associated with this script engine instance.

java.lang.ClassLoader getParentClassLoader()

java.net.URLConnection getResourceConnection(java.lang.String resourceName)

Get a resource connection as a URLConnection to retrieve a script from the ResourceConnector.

protected boolean isSourceNewer(GroovyScriptEngine.ScriptCacheEntry entry)

java.lang.Class loadScriptByName(java.lang.String scriptName)

static void main(java.lang.String[] urls)

Simple testing harness for the GSE.

java.lang.String run(java.lang.String scriptName, java.lang.String argument)

Run a script identified by name with a single argument.

java.lang.Object run(java.lang.String scriptName, Binding binding)

void setConfig(CompilerConfiguration config)

 
Methods inherited from class java.lang.Object
java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#wait(), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()
 

Method Detail

GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.net.URL[] roots)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.net.URL[] roots, java.lang.ClassLoader parentClassLoader)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.lang.String[] urls)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.lang.String[] urls, java.lang.ClassLoader parentClassLoader)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.lang.String url)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(java.lang.String url, java.lang.ClassLoader parentClassLoader)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(ResourceConnector rc)


GroovyScriptEngine

public java.lang.Object GroovyScriptEngine(ResourceConnector rc, java.lang.ClassLoader parentClassLoader)


createScript

public Script createScript(java.lang.String scriptName, Binding binding)


getConfig

public CompilerConfiguration getConfig()


getGroovyClassLoader

public GroovyClassLoader getGroovyClassLoader()
Returns the GroovyClassLoader associated with this script engine instance. Useful if you need to pass the class loader to another library.
Returns:
the GroovyClassLoader


getParentClassLoader

public java.lang.ClassLoader getParentClassLoader()


getResourceConnection

public java.net.URLConnection getResourceConnection(java.lang.String resourceName)
Get a resource connection as a URLConnection to retrieve a script from the ResourceConnector.
throws:
ResourceException
Parameters:
resourceName - name of the resource to be retrieved
Returns:
a URLConnection to the resource


isSourceNewer

protected boolean isSourceNewer(GroovyScriptEngine.ScriptCacheEntry entry)


loadScriptByName

public java.lang.Class loadScriptByName(java.lang.String scriptName)


main

public static void main(java.lang.String[] urls)
Simple testing harness for the GSE. Enter script roots as arguments and then input script names to run them.
throws:
Exception if something goes wrong
Parameters:
urls - an array of URLs


run

public java.lang.String run(java.lang.String scriptName, java.lang.String argument)
Run a script identified by name with a single argument.
throws:
ResourceException if there is a problem accessing the script
throws:
ScriptException if there is a problem parsing the script
Parameters:
scriptName - name of the script to run
argument - a single argument passed as a variable named arg in the binding
Returns:
a toString() representation of the result of the execution of the script


run

public java.lang.Object run(java.lang.String scriptName, Binding binding)


setConfig

public void setConfig(CompilerConfiguration config)


 

Groovy Documentation