de.ipcon.gui

Class ClientScriptingHelper

java.lang.Object

de.ipcon.gui.AbstractClientHelper

de.ipcon.gui.ClientScriptingHelper

public class ClientScriptingHelper
extends AbstractClientHelper

Manages the internal BeanShell scripting engine and execution environment.

Encapsulates interpreter lifecycle, default imports, constant injection, and contextual bindings for client-side script execution.

Constructor Summary

Constructors

Constructor and Description
ClientScriptingHelper(Client _client) Constructs a scripting helper bound to the active client runtime context.

Method Summary

Modifier and Type	Method and Description
void	executeScript(AbstractScript s) Convenience method to execute an AbstractScript without supplemental parameters.
void	executeScript(AbstractScript s, java.util.Map<java.lang.String,java.lang.Object> mapping) Executes an AbstractScript within the client runtime context, binding optional parameters.
BeanShellScript	getScript() Returns the active BeanShell interpreter instance.
AbstractScript	getScript(electric.xml.Element el) Creates an AbstractScript instance from an XML configuration element.
void	initScript() Initializes the BeanShell scripting interpreter.
void	setScript(BeanShellScript s) Assigns an explicit BeanShell interpreter instance.

Methods inherited from class de.ipcon.gui.AbstractClientHelper

client

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientScriptingHelper

public ClientScriptingHelper(Client _client)

Constructs a scripting helper bound to the active client runtime context.

Parameters:

_ctx - context providing access to loaders, sessions, and environment services

Method Detail

getScript

public BeanShellScript getScript()

Returns the active BeanShell interpreter instance.

Returns:

configured BeanShellScript instance, or null if not yet initialized

setScript

public void setScript(BeanShellScript s)

Assigns an explicit BeanShell interpreter instance.

Parameters:

s - script engine instance to bind

initScript

public void initScript()

Initializes the BeanShell scripting interpreter.

Configures default package imports (GUI, BOs, utilities), binds the client context, and registers standard runtime constants (such as D_ZERO).

getScript

public AbstractScript getScript(electric.xml.Element el)

Creates an AbstractScript instance from an XML configuration element.

Extracts script language and source code from the given XML element. The script is retained uncompiled because the generated execution wrapper is discarded after invocation.

Note: Currently returns a BeanShell script instance regardless of the declared language, binding execution to the client’s primary interpreter context.

Parameters:

el - XML element containing script code and attributes

Returns:

instantiated AbstractScript, or null if el is null

executeScript

public void executeScript(AbstractScript s)

Convenience method to execute an AbstractScript without supplemental parameters.

Parameters:

s - script instance to execute; ignored if null

executeScript

public void executeScript(AbstractScript s,
                          java.util.Map<java.lang.String,java.lang.Object> mapping)

Executes an AbstractScript within the client runtime context, binding optional parameters.

Parameters:

s - script instance to execute; ignored if null

mapping - variable map injected into the script execution scope; may be null