de.ipcon.tools

Class GroovyScript

java.lang.Object

de.ipcon.tools.AbstractScript

de.ipcon.tools.GroovyScript

Direct Known Subclasses:

PaintGroovyScript

public class GroovyScript
extends AbstractScript

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	GroovyScript.Function
static class	GroovyScript.HGB

Field Summary

Fields inherited from class de.ipcon.tools.AbstractScript

RM_DEFAULT, RM_RESULT, RM_SCRIPT, SL_BEANSHELL, SL_DEFAULT, SL_GROOVY, STR_VALUES_FALSE, STR_VALUES_TRUE

Constructor Summary

Constructors

Constructor and Description
GroovyScript(java.lang.String _source, boolean _precompile)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl, java.util.Map _initialvars)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl, java.util.Map _initialvars, java.util.List<ScriptImport> _defaultImports)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl, java.util.Map _initialvars, java.util.List<ScriptImport> _defaultImports, java.lang.String _baseClassName)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl, java.util.Map _initialvars, java.util.List<ScriptImport> _defaultImports, java.lang.String _baseClassName, GroovyScript.HGB _binding)
GroovyScript(java.lang.String _source, boolean _precompile, GroovyScript _parent, java.lang.ClassLoader _cl, java.util.Map _initialvars, java.util.List<ScriptImport> _defaultImports, java.lang.String _baseClassName, GroovyScript.HGB _binding, java.lang.String _scriptname)

Method Summary

Modifier and Type	Method and Description
boolean	asBool(java.lang.Object o, boolean nullValue)
static boolean	asBoolStatic(java.lang.Object o, boolean nullValue)
java.lang.Object	boolConverter(java.lang.Object o, java.lang.Object nullValue)
void	clear() Frees all variables of this script after script has been executed to prevent them from being held "forever" even if they are no longer used.
void	close()
void	compileNT(int _lineOffset, java.lang.String errorTip)
static boolean	compilesToSame(java.lang.String sourceA, java.lang.String sourceB) Checks if the two given pieces of source code will result in the same actual script, that is not only differ in things like comments or whitespace.
ScriptFunctionI	createFunction(java.lang.String src, java.lang.String[] parmNames, java.lang.Class[] parmTypes, java.lang.Class returnType)
ScriptFunctionI	createFunction(java.lang.String src, java.lang.String[] parmNames, java.lang.Class[] parmTypes, java.lang.Class returnType, java.lang.String _scriptName)
ScriptFunctionI	createFunction(java.lang.String src, java.lang.String[] parmNames, java.lang.Class[] parmTypes, java.lang.Class returnType, java.lang.String _scriptName, java.lang.String _functionName)
ScriptFunctionI	createFunction(java.lang.String src, java.lang.String[] parmNames, java.lang.Class[] parmTypes, java.lang.Class returnType, java.lang.String _scriptName, java.lang.String _functionName, int _lineOffset)
ScriptFunctionI	createFunction(java.lang.String src, java.lang.String[] parmNames, java.lang.Class[] parmTypes, java.lang.Class returnType, java.lang.String _scriptName, java.lang.String _functionName, int _lineOffset, java.lang.Object _delegate)
void	createScript()
boolean	evalAsBoolNT(java.lang.String s, boolean nullValue, int _lineOffset, java.lang.String errorTip)
java.lang.Object	evalNT(java.lang.String s, java.lang.Object nullValue, int _lineOffset, java.lang.String errorTip)
java.lang.Object	evalNT(java.lang.String s, java.lang.Object nullValue, int _lineOffset, java.lang.String errorTip, java.util.function.BiFunction typeConverter)
GroovyScript.HGB	getBinding()
org.codehaus.groovy.control.CompilerConfiguration	getCompilerConf()
groovy.lang.Script	getEvalScript(java.lang.String s)
groovy.lang.Script	getEvalScript(java.lang.String s, java.lang.String name)
java.lang.String	getLanguage()
int	getLineOffset()
java.lang.Object	getNT(java.lang.String name, java.lang.Object exValue)
GroovyScript	getParent()
groovy.lang.Script	getScript()
groovy.lang.GroovyShell	getShell()
java.lang.String	getSource()
boolean	hasSource()
void	initShellInstance(java.lang.ClassLoader cl, java.util.List<ScriptImport> imports, java.lang.String baseClassName)
static boolean	isActualScript(java.lang.String _str) Checks if the given text, supposed to be script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments.
static boolean	isActualScriptNT(java.lang.String _str) Checks if the given text, supposed to be script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments.
static boolean	isActualScriptNT(java.lang.String _str, boolean _errorValue)
static boolean	isActualScriptNT(java.lang.String _str, boolean _errorValue, boolean _logException)
static boolean	isActualScriptTR(java.lang.String _src) Checks if the given text, supposed to be syntactically valid script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments.
static boolean	isActualScriptTR(java.lang.String _src, java.lang.String _msg)
static boolean	isValidVarName(java.lang.Object o) Checks if the passed Object is a valid variable name for Groovy.
int	nextFunctionCounter()
int	nextScriptCounter()
static java.lang.String	replaceCustomLogicalOperators(java.lang.String scriptCode) Replaces our custom logical operators (for hassle-free usage in XML, avoiding a CDATA block just for that) in the given string with standard Groovy logical operators.
java.lang.Object	runAsObjectNT(java.lang.Object nullValue, int _lineOffset, java.lang.String errorTip) This method is called *NT ("no throw") but actually does throw a GroovyScriptException should the script throw an exception while running.
void	setBinding(GroovyScript.HGB $16)
void	setCompilerConf(org.codehaus.groovy.control.CompilerConfiguration $15)
void	setLineOffset(int $12)
void	setNT(java.lang.String name, java.lang.Object value, boolean local)
void	setParent(GroovyScript $13)
void	setPrecompile(boolean _b)
void	setScript(groovy.lang.Script $17)
void	setShell(groovy.lang.GroovyShell $14)
void	setSource(java.lang.String $11)

Methods inherited from class de.ipcon.tools.AbstractScript

asString, compileNT, compileNT, evalAsBoolNT, evalAsBoolNT, evalAsBoolNT, evalAsStringNT, evalAsStringNT, evalAsStringNT, evalAsStringNT, evalNT, evalNT, evalNT, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInstance, getInterrupt, getJavaSyntaxImports, getJavaSyntaxImports, getNT, isScriptException, runAsBoolNT, runAsBoolNT, runAsBoolNT, runAsBoolNT, runAsObjectNT, runAsObjectNT, runAsObjectNT, runAsStringNT, runAsStringNT, runAsStringNT, runAsStringNT, runNT, runNT, runNT, setInterrupt, setNT, setNT, setNT, setNT, setNT, setNT, setNT, setNT, setNT, setNT, setNT, setNT

Methods inherited from class java.lang.Object

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

Constructor Detail

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl,
                    java.util.Map _initialvars)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl,
                    java.util.Map _initialvars,
                    java.util.List<ScriptImport> _defaultImports)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl,
                    java.util.Map _initialvars,
                    java.util.List<ScriptImport> _defaultImports,
                    java.lang.String _baseClassName)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl,
                    java.util.Map _initialvars,
                    java.util.List<ScriptImport> _defaultImports,
                    java.lang.String _baseClassName,
                    GroovyScript.HGB _binding)

GroovyScript

public GroovyScript(java.lang.String _source,
                    boolean _precompile,
                    GroovyScript _parent,
                    java.lang.ClassLoader _cl,
                    java.util.Map _initialvars,
                    java.util.List<ScriptImport> _defaultImports,
                    java.lang.String _baseClassName,
                    GroovyScript.HGB _binding,
                    java.lang.String _scriptname)

Method Detail

replaceCustomLogicalOperators

public static java.lang.String replaceCustomLogicalOperators(java.lang.String scriptCode)

Replaces our custom logical operators (for hassle-free usage in XML, avoiding a CDATA block just for that) in the given string with standard Groovy logical operators.

This method transforms custom logical operators "@and" and "@or" into "&&" and "||" respectively. It is particularly useful for converting Groovy script strings coming from XML that contain non-standard logical syntax for avoiding a CDATA block into a format that is compatible with Groovy's standard logical operators.

Example Usage:

 
 String groovyScript = "true @and false @or true";
 String convertedScript = replaceCustomLogicalOperators(groovyScript);
 System.out.println(convertedScript); // Output: true && false || true
 
 

Parameters:

scriptCode - the input string containing custom logical operators

Returns:

a new string with the custom logical operators replaced by standard Groovy logical operators or null if the input string was null

setPrecompile

public void setPrecompile(boolean _b)

Specified by:

setPrecompile in class AbstractScript

hasSource

public boolean hasSource()

Specified by:

hasSource in class AbstractScript

getLanguage

public java.lang.String getLanguage()

Specified by:

getLanguage in class AbstractScript

nextScriptCounter

public int nextScriptCounter()

nextFunctionCounter

public int nextFunctionCounter()

initShellInstance

public void initShellInstance(java.lang.ClassLoader cl,
                              java.util.List<ScriptImport> imports,
                              java.lang.String baseClassName)

getNT

public java.lang.Object getNT(java.lang.String name,
                              java.lang.Object exValue)

Specified by:

getNT in class AbstractScript

setNT

public void setNT(java.lang.String name,
                  java.lang.Object value,
                  boolean local)

Specified by:

setNT in class AbstractScript

runAsObjectNT

public java.lang.Object runAsObjectNT(java.lang.Object nullValue,
                                      int _lineOffset,
                                      java.lang.String errorTip)

This method is called *NT ("no throw") but actually does throw a GroovyScriptException should the script throw an exception while running.

Specified by:

runAsObjectNT in class AbstractScript

Throws:

GroovyScriptException - if the script throws an exception while running

getEvalScript

public groovy.lang.Script getEvalScript(java.lang.String s)

getEvalScript

public groovy.lang.Script getEvalScript(java.lang.String s,
                                        java.lang.String name)

evalNT

public java.lang.Object evalNT(java.lang.String s,
                               java.lang.Object nullValue,
                               int _lineOffset,
                               java.lang.String errorTip)

Specified by:

evalNT in class AbstractScript

evalNT

public java.lang.Object evalNT(java.lang.String s,
                               java.lang.Object nullValue,
                               int _lineOffset,
                               java.lang.String errorTip,
                               java.util.function.BiFunction typeConverter)

evalAsBoolNT

public boolean evalAsBoolNT(java.lang.String s,
                            boolean nullValue,
                            int _lineOffset,
                            java.lang.String errorTip)

Overrides:

evalAsBoolNT in class AbstractScript

boolConverter

public java.lang.Object boolConverter(java.lang.Object o,
                                      java.lang.Object nullValue)

compileNT

public void compileNT(int _lineOffset,
                      java.lang.String errorTip)

Specified by:

compileNT in class AbstractScript

close

public void close()

Overrides:

close in class AbstractScript

clear

public void clear()

Description copied from class: AbstractScript

Frees all variables of this script after script has been executed to prevent them from being held "forever" even if they are no longer used.

Specified by:

clear in class AbstractScript

createScript

public void createScript()

createFunction

public ScriptFunctionI createFunction(java.lang.String src,
                                      java.lang.String[] parmNames,
                                      java.lang.Class[] parmTypes,
                                      java.lang.Class returnType)

Specified by:

createFunction in class AbstractScript

createFunction

public ScriptFunctionI createFunction(java.lang.String src,
                                      java.lang.String[] parmNames,
                                      java.lang.Class[] parmTypes,
                                      java.lang.Class returnType,
                                      java.lang.String _scriptName)

createFunction

public ScriptFunctionI createFunction(java.lang.String src,
                                      java.lang.String[] parmNames,
                                      java.lang.Class[] parmTypes,
                                      java.lang.Class returnType,
                                      java.lang.String _scriptName,
                                      java.lang.String _functionName)

Specified by:

createFunction in class AbstractScript

createFunction

public ScriptFunctionI createFunction(java.lang.String src,
                                      java.lang.String[] parmNames,
                                      java.lang.Class[] parmTypes,
                                      java.lang.Class returnType,
                                      java.lang.String _scriptName,
                                      java.lang.String _functionName,
                                      int _lineOffset)

Specified by:

createFunction in class AbstractScript

createFunction

public ScriptFunctionI createFunction(java.lang.String src,
                                      java.lang.String[] parmNames,
                                      java.lang.Class[] parmTypes,
                                      java.lang.Class returnType,
                                      java.lang.String _scriptName,
                                      java.lang.String _functionName,
                                      int _lineOffset,
                                      java.lang.Object _delegate)

Specified by:

createFunction in class AbstractScript

isActualScript

public static boolean isActualScript(java.lang.String _str)
                              throws groovyjarjarantlr.RecognitionException,
                                     groovyjarjarantlr.TokenStreamException

Checks if the given text, supposed to be script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments. Test is performed via actual GroovyRecognizer (and not just custom regexps or similar), so should be very reliable. Will pass through all Exceptions that can occur if _str is not parseable as a GroovyScript.

Parameters:

_str - the supposed-to-be-script-source text.

Returns:

true if _str is an actual script (one that isn't null, empty or only comments); false if not.

Throws:

groovyjarjarantlr.RecognitionException

groovyjarjarantlr.TokenStreamException

isActualScriptTR

public static boolean isActualScriptTR(java.lang.String _src)
                                throws IRuntimeException

Checks if the given text, supposed to be syntactically valid script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments. Test is performed via actual GroovyRecognizer (and not just custom regexps or similar), so should be very reliable. Will internally catch RecognitionException and TokenStreamException and wrap them in an IRuntimeException. This is a convenience method to be used when one can be - almost - sure that _str will indeed be syntactically valid Groovy and so one does not want to (as one does not have to need to) catch the exceptions that theoretically might occur.

Parameters:

_src - the script source, supposed to be valid Groovy script syntax if not null or empty string.

Throws:

IRuntimeException

isActualScriptTR

public static boolean isActualScriptTR(java.lang.String _src,
                                       java.lang.String _msg)
                                throws IRuntimeException

Throws:

IRuntimeException

isActualScriptNT

public static boolean isActualScriptNT(java.lang.String _str)

Checks if the given text, supposed to be script source, actually results in a valid (Groovy) script, that is one that does not completely consist only of comments. Test is performed via actual GroovyRecognizer (and not just custom regexps or similar), so should be very reliable.

Parameters:

_str - the supposed-to-be-script-source text.

_errorValue - boolean value that is returned when the parsing of _str resulted in an error, that is the given text could not be parsed by the GroovyRecognizer. If a syntactically invalid script is seen as "actual script" will depend on where this method is called and so is configurable via this value. Defaults to false.

_logException - if true, parsing (and other) exceptions during the check will produce a message in the log; if false (the default) they will not produce any output.

Returns:

true if _str is an actual script (one that isn't null, empty or only comments); false if not; _errorValue when an exception occurred during the check, for example when _str couldn't be parsed by the GroovyRecognizer.

isActualScriptNT

public static boolean isActualScriptNT(java.lang.String _str,
                                       boolean _errorValue)

isActualScriptNT

public static boolean isActualScriptNT(java.lang.String _str,
                                       boolean _errorValue,
                                       boolean _logException)

asBool

public boolean asBool(java.lang.Object o,
                      boolean nullValue)

Overrides:

asBool in class AbstractScript

asBoolStatic

public static boolean asBoolStatic(java.lang.Object o,
                                   boolean nullValue)

isValidVarName

public static boolean isValidVarName(java.lang.Object o)

Checks if the passed Object is a valid variable name for Groovy. Three checks are made currently: 1. Is the passed object a String? 2. Is the passed String no Groovy keyword? 3. Does the passed String match the Groovy variable name rules? If all three answers are yes, the passed object may be used as a variable name.

Parameters:

o - the object to test

Returns:

true if o is a valid variable name, false otherwise

compilesToSame

public static boolean compilesToSame(java.lang.String sourceA,
                                     java.lang.String sourceB)

Checks if the two given pieces of source code will result in the same actual script, that is not only differ in things like comments or whitespace. The comparison is done via actual Groovy source code parsing which means that it is a bit costly but should be very reliable. It should not result in false positives but may result in false negatives for scripts which a human (or AI ;-) might consider "equivalent". This method can be of use if a "real" change of a script must result in - possibly costly - recalculation or updating of things while only cosmetical changes do not require that (examples of this will be in the alarm system code).

getSource

public java.lang.String getSource()

Specified by:

getSource in class AbstractScript

setSource

public void setSource(java.lang.String $11)

Specified by:

setSource in class AbstractScript

getLineOffset

public int getLineOffset()

setLineOffset

public void setLineOffset(int $12)

Specified by:

setLineOffset in class AbstractScript

getParent

public GroovyScript getParent()

setParent

public void setParent(GroovyScript $13)

getShell

public groovy.lang.GroovyShell getShell()

setShell

public void setShell(groovy.lang.GroovyShell $14)

getCompilerConf

public org.codehaus.groovy.control.CompilerConfiguration getCompilerConf()

setCompilerConf

public void setCompilerConf(org.codehaus.groovy.control.CompilerConfiguration $15)

getBinding

public GroovyScript.HGB getBinding()

setBinding

public void setBinding(GroovyScript.HGB $16)

getScript

public groovy.lang.Script getScript()

setScript

public void setScript(groovy.lang.Script $17)