org.scripthelper.context

Interface ScriptContext

All Known Implementing Classes:

DefaultScriptContext, DefaultSwingScriptContext

public interface ScriptContext

The script context.

Method Summary

Modifier and Type	Method and Description
default void	__step__(java.lang.Object... args) Enter a step.
default void	abort() Abort the current script silently.
void	abort(java.lang.String message) Abort the current script.
default void	clearLoggerTab() Clear the current value of the tab for the text.
default void	clearTab() Clear the current value of the tab for the text.
default java.lang.Object	createScript(java.io.File file) Create another script that can be used in the current script.
default java.lang.Object	createScript(java.io.File file, boolean useContext) Create another script that can be used in the current script.
default java.lang.Object	createScript(java.lang.String path) Create another script that can be used in the current script.
default java.lang.Object	createScript(java.lang.String path, boolean useContext) Create another script that can be used in the current script.
default void	echo(java.lang.Number number) Echo a number.
default void	echo(java.lang.Number number, java.lang.String htmlColor) Echo a number with a specified color.
void	echo(java.lang.String message) Echo a message.
default void	echo(java.lang.String message, java.lang.String htmlColor) Echo a message with a specified color.
void	error(java.lang.String message) Error a message.
default java.lang.Object	getAdditionalHelper(java.lang.String name) Return the additional helper with a specified name.
default java.util.Map<java.lang.String,java.lang.Object>	getAdditionalHelpers() Return the additional helpers.
default ScriptHelper	getHelper() Return the script helper.
default java.lang.String	getLoggerTab() Return the tab as text.
default java.lang.Object	getMainScriptObject() Return the wrapper associated script object.
java.io.File	getPath(java.lang.String path) Return the absolute path of a file defined relative to the script file.
default java.io.File	getScriptFile() Return the script file.
ScriptLogger	getScriptLogger() Return the associated ScriptLogger.
default java.lang.Object	getScriptObject(java.io.File file) Return an additional script called by the wrapper associated script object, specified by its file.
default java.lang.Object	getScriptObject(java.lang.String name) Return an additional script called by the wrapper associated script object, specified by its name.
ScriptSource	getScriptSource() Return the script source.
default ScriptWrapper<?>	getScriptWrapper() Return the script wrapper.
default boolean	hasAdditionalHelpers() Return true if there are additional helpers.
void	setLogger(ScriptLogger logger) Set the associated ScriptLogger.
default void	setLoggerTab(int tabs) Set the current value for of the tab for the text.
default void	setProgress(float value) Set the value of the script progression.
void	setScriptSource(ScriptSource source) Set the Script source.
default void	setScriptWrapper(ScriptWrapper<?> wrapper) Set the script wrapper.
default void	setTab(int tabs) Set the current value for of the tab for the text.

Method Detail

setScriptWrapper

default void setScriptWrapper(ScriptWrapper<?> wrapper)

Set the script wrapper. Do nothing by default.

Parameters:

wrapper - the script wrapper

getScriptWrapper

default ScriptWrapper<?> getScriptWrapper()

Return the script wrapper. Return null by default.

Returns:

the script wrapper

getMainScriptObject

default java.lang.Object getMainScriptObject()

Return the wrapper associated script object.

Returns:

the script object

getScriptObject

default java.lang.Object getScriptObject(java.lang.String name)

Return an additional script called by the wrapper associated script object, specified by its name.

Parameters:

name - the script name

Returns:

the script object

getScriptObject

default java.lang.Object getScriptObject(java.io.File file)

Return an additional script called by the wrapper associated script object, specified by its file.

Parameters:

file - the script file

Returns:

the script object

getHelper

default ScriptHelper getHelper()

Return the script helper. Return null by default.

Returns:

the script helper

createScript

default java.lang.Object createScript(java.lang.String path)
                               throws ScriptRuntimeException

Create another script that can be used in the current script.

Parameters:

path - the script path

Returns:

the script object

Throws:

ScriptRuntimeException - if the script could not be created (the file may not exist, or the syntax is invalid)

createScript

default java.lang.Object createScript(java.io.File file)
                               throws ScriptRuntimeException

Create another script that can be used in the current script.

Parameters:

file - the script file

Returns:

the script object

Throws:

ScriptRuntimeException - if the script could not be created (the file may not exist, or the syntax is invalid)

createScript

default java.lang.Object createScript(java.io.File file,
                                      boolean useContext)
                               throws ScriptRuntimeException

Create another script that can be used in the current script.

Parameters:

file - the script file

useContext - true if the additional script must use the context

Returns:

the script object

Throws:

ScriptRuntimeException - if the script could not be created (the file may not exist, or the syntax is invalid)

createScript

default java.lang.Object createScript(java.lang.String path,
                                      boolean useContext)
                               throws ScriptRuntimeException

Create another script that can be used in the current script.

Parameters:

path - the script path

useContext - true if the additional script must use the context

Returns:

the script object

Throws:

ScriptRuntimeException - if the script could not be created (the file may not exist, or the syntax is invalid)

setScriptSource

void setScriptSource(ScriptSource source)

Set the Script source.

Parameters:

source - the script source

setLogger

void setLogger(ScriptLogger logger)

Set the associated ScriptLogger.

Parameters:

logger - the associated ScriptLogger

getScriptLogger

ScriptLogger getScriptLogger()

Return the associated ScriptLogger.

Returns:

the associated ScriptLogger

clearLoggerTab

default void clearLoggerTab()

Clear the current value of the tab for the text. All subsequent lines will be presented without tab. Defer to the getScriptLogger().

getLoggerTab

default java.lang.String getLoggerTab()

Return the tab as text. Return an empty String by default. Defer to the getScriptLogger().

Returns:

the tab

setLoggerTab

default void setLoggerTab(int tabs)

Set the current value for of the tab for the text. All subsequent lines will be presented with a tab of tabs. Defer to the getScriptLogger().

Parameters:

tabs - the current value for of the tab for the text

getAdditionalHelpers

default java.util.Map<java.lang.String,java.lang.Object> getAdditionalHelpers()

Return the additional helpers.

Returns:

the additional helpers

getAdditionalHelper

default java.lang.Object getAdditionalHelper(java.lang.String name)

Return the additional helper with a specified name.

Parameters:

name - the helper name

Returns:

the additional helper

hasAdditionalHelpers

default boolean hasAdditionalHelpers()

Return true if there are additional helpers.

Returns:

true if there are additional helpers

getScriptSource

ScriptSource getScriptSource()

Return the script source.

Returns:

the script source

getScriptFile

default java.io.File getScriptFile()

Return the script file.

Returns:

the script file

echo

void echo(java.lang.String message)

Echo a message.

Parameters:

message - the message text

echo

default void echo(java.lang.String message,
                  java.lang.String htmlColor)

Echo a message with a specified color. By default defer to echo(java.lang.String).

Parameters:

message - the message text

htmlColor - the message color

echo

default void echo(java.lang.Number number)

Echo a number.

Parameters:

number - the number

echo

default void echo(java.lang.Number number,
                  java.lang.String htmlColor)

Echo a number with a specified color.

Parameters:

number - the number

htmlColor - the number color

error

void error(java.lang.String message)

Error a message.

Parameters:

message - the message text

clearTab

default void clearTab()

Clear the current value of the tab for the text. All subsequent lines will be presented without tab. Do nothing by default.

setTab

default void setTab(int tabs)

Set the current value for of the tab for the text. All subsequent lines will be presented with a tab of tabs. Do nothing by default.

Parameters:

tabs - the current value for of the tab for the text

setProgress

default void setProgress(float value)

Set the value of the script progression.

Parameters:

value - the value

getPath

java.io.File getPath(java.lang.String path)

Return the absolute path of a file defined relative to the script file.

Parameters:

path - the relative path

Returns:

the absolute path

abort

void abort(java.lang.String message)
    throws AbortScriptException

Abort the current script. The Scripting engine will use the throwable exception to stop the execution.

Parameters:

message - the abort message

Throws:

AbortScriptException - the exception used to abort the Script

abort

default void abort()
            throws AbortScriptException

Abort the current script silently. The Scripting engine will use the throwable exception to stop the execution, but the console will not show the aborting message.

Throws:

AbortScriptException - the exception used to abort the Script

__step__

default void __step__(java.lang.Object... args)

Enter a step. Do nothing by default.

Parameters:

args - the arguments