Package adams.tools

Class AbstractScriptedTool

java.lang.Object

adams.core.logging.LoggingObject

adams.core.logging.CustomLoggingLevelObject

adams.core.option.AbstractOptionHandler

adams.tools.AbstractTool

adams.tools.AbstractScriptedTool

All Implemented Interfaces:

CleanUpHandler, Destroyable, GlobalInfoSupporter, LoggingLevelHandler, LoggingSupporter, OptionHandler, FileBasedScripting, FileBasedScriptingWithOptions, SizeOfHandler, Stoppable, StoppableWithFeedback, Serializable, Comparable

Direct Known Subclasses:

Groovy, Scripted

public abstract class AbstractScriptedTool
extends AbstractTool
implements FileBasedScriptingWithOptions

Abstract ancestor for filters that execute external scripts.

Version:

$Revision$

Author:

FracPete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected PlaceholderFile	m_ScriptFile	the script.
protected Object	m_ScriptObject	the loaded script object.
protected String	m_ScriptOptions	the options for the script.

Fields inherited from class adams.tools.AbstractTool

m_Stopped

Fields inherited from class adams.core.option.AbstractOptionHandler

m_OptionManager

Fields inherited from class adams.core.logging.LoggingObject

m_Logger, m_LoggingIsEnabled, m_LoggingLevel

Constructor Summary

Constructors

Constructor	Description
AbstractScriptedTool()

Method Summary

Modifier and Type	Method	Description
protected abstract String	checkScriptObject()	Checks the script object.
void	defineOptions()	Adds options to the internal list of options.
void	destroy()	Frees up memory in a "destructive" non-reversible way.
PlaceholderFile	getScriptFile()	Gets the script file.
BaseText	getScriptOptions()	Gets the script options.
protected String	initScriptObject()	Tries to initialize the scripts object, sets its options and performs some checks.
protected abstract String	loadScriptObject()	Loads the scripts object and sets its options.
protected void	preRun()	Before the actual run is executed.
void	reset()	Resets the conversion.
String	scriptFileTipText()	Returns the tip text for this property.
String	scriptOptionsTipText()	Returns the tip text for this property.
void	setScriptFile(PlaceholderFile value)	Sets the script file.
void	setScriptOptions(BaseText value)	Sets the script options.

Methods inherited from class adams.tools.AbstractTool

cleanUp, compareTo, doRun, equals, forCommandLine, forName, getTools, isStopped, postRun, run, runTool, stopExecution

Methods inherited from class adams.core.option.AbstractOptionHandler

cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, globalInfo, initialize, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString

Methods inherited from class adams.core.logging.LoggingObject

configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

Methods inherited from class java.lang.Object

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

Methods inherited from interface adams.core.logging.LoggingLevelHandler

getLoggingLevel

Field Detail

m_ScriptFile

protected PlaceholderFile m_ScriptFile

the script.

m_ScriptOptions

protected String m_ScriptOptions

the options for the script.

m_ScriptObject

protected transient Object m_ScriptObject

the loaded script object.

Constructor Detail

AbstractScriptedTool

public AbstractScriptedTool()

Method Detail

defineOptions

public void defineOptions()

Adds options to the internal list of options.

Specified by:

defineOptions in interface OptionHandler

Overrides:

defineOptions in class AbstractOptionHandler

reset

public void reset()

Resets the conversion.

Overrides:

reset in class AbstractOptionHandler

setScriptFile

public void setScriptFile(PlaceholderFile value)

Sets the script file.

Specified by:

setScriptFile in interface FileBasedScripting

Parameters:

value - the script

getScriptFile

public PlaceholderFile getScriptFile()

Gets the script file.

Specified by:

getScriptFile in interface FileBasedScripting

Returns:

the script

scriptFileTipText

public String scriptFileTipText()

Returns the tip text for this property.

Specified by:

scriptFileTipText in interface FileBasedScripting

Returns:

tip text for this property suitable for displaying in the explorer/experimenter gui

setScriptOptions

public void setScriptOptions(BaseText value)

Sets the script options.

Specified by:

setScriptOptions in interface FileBasedScriptingWithOptions

Parameters:

value - the options

getScriptOptions

public BaseText getScriptOptions()

Gets the script options.

Specified by:

getScriptOptions in interface FileBasedScriptingWithOptions

Returns:

the options

scriptOptionsTipText

public String scriptOptionsTipText()

Returns the tip text for this property.

Specified by:

scriptOptionsTipText in interface FileBasedScriptingWithOptions

Returns:

tip text for this property suitable for displaying in the explorer/experimenter gui

loadScriptObject

protected abstract String loadScriptObject()

Loads the scripts object and sets its options.

Returns:

null if OK, otherwise the error message

checkScriptObject

protected abstract String checkScriptObject()

Checks the script object.

Returns:

null if OK, otherwise the error message

initScriptObject

protected String initScriptObject()

Tries to initialize the scripts object, sets its options and performs some checks.

Returns:

null if OK, otherwise the error message

preRun

protected void preRun()

Before the actual run is executed.

Overrides:

preRun in class AbstractTool

destroy

public void destroy()

Frees up memory in a "destructive" non-reversible way.

Specified by:

destroy in interface Destroyable

Overrides:

destroy in class AbstractTool

See Also:

AbstractOptionHandler.cleanUpOptions()