org.ametys.plugins.core.ui.script

Interface ScriptBinding

All Known Implementing Classes:

RepositoryScriptBinding, RuntimeScriptBinding, StaticConfigurableScriptBinding

public interface ScriptBinding

This interface describes a console data, variables and functions. Each implementation of this interface will enhance the console, by providing additional variables and functions that can be used in scripts.

Method Summary

Modifier and Type	Method and Description
void	cleanVariables(Map<String,Object> variables) Allows clean up of variables created during the getVariables call.
String	getFunctions() Returns the JavaScript functions to inject at the start of the script, in the form of a single String prepended to the script.
Map<String,I18nizableText>	getFunctionsDescriptions() Returns the list of functions descriptions, mapped by function name.
Map<String,Object>	getVariables() Returns the list of variables this ScriptBinding provides, mapped by variable name.
Map<String,I18nizableText>	getVariablesDescriptions() Returns the list of variables descriptions, mapped by variable name.
Object	processScriptResult(Object result) Process the script result if there are any specificities for this console data.

Method Detail

getVariables

Map<String,Object> getVariables()

Returns the list of variables this ScriptBinding provides, mapped by variable name.

Returns:

The list of variables, or null if no variable is provided.

getVariablesDescriptions

Map<String,I18nizableText> getVariablesDescriptions()

Returns the list of variables descriptions, mapped by variable name. This list does not have to match the getVariables return value, but the description is used to inform the user of the existence and usability of each variable.

Returns:

The list of variables descriptions, or null if no description is provided.

cleanVariables

void cleanVariables(Map<String,Object> variables)

Allows clean up of variables created during the getVariables call.

Parameters:

variables - The map of variables.

getFunctions

String getFunctions()

Returns the JavaScript functions to inject at the start of the script, in the form of a single String prepended to the script.

Returns:

The functions text, or null if no function is provided.

getFunctionsDescriptions

Map<String,I18nizableText> getFunctionsDescriptions()

Returns the list of functions descriptions, mapped by function name. This list does not have to match the functions returned by getFunctions, but the description is used to inform the user of the existence and usability of each function.

Returns:

The list of functions descriptions, or null if no description is provided.

processScriptResult

Object processScriptResult(Object result)
                    throws ScriptException

Process the script result if there are any specificities for this console data.

Parameters:

result - The result

Returns:

The result processed, or null if this console data does not have any processing to do.

Throws:

ScriptException - If a processing error occurs.