org.cristalise.kernel.scripting

Class Script

java.lang.Object

org.cristalise.kernel.scripting.Script

All Implemented Interfaces:

DescriptionObject

public class Script
extends Object
implements DescriptionObject

Constructor Summary

Constructors

Constructor and Description
Script() Constructor for castor unmarshall
Script(String lang, AgentProxy agent, PrintStream out) For consoles
Script(String name, Integer version, ItemPath path, String xml) For testing.
Script(String lang, String expr) Creates a script executor for the supplied expression, bypassing the xml parsing bit Output class is forced to an object.
Script(String lang, String expr, Class<?> returnType) Creates a script executor for the supplied expression, bypassing the xml parsing bit
Script(String lang, String name, String expr, AgentProxy agent) Creates a script executor requiring an agent to be set.

Method Summary

Modifier and Type	Method and Description
protected void	addIncludedInputParam(String name, Class<?> type)
protected void	addInputParam(String name, Class<?> type)
protected void	addInputParam(String name, String type)
protected void	addOutput(String name, Class<?> type)
protected void	addOutput(String name, String type)
Object	evaluate(ItemPath itemPath, CastorHashMap inputProps, String actContext, boolean actExecEnv, Object locker) Reads and evaluates input properties, set input parameters from those properties and executes the Script
Object	evaluate(ItemPath itemPath, CastorHashMap inputProps, String actContext, Object locker)
Object	execute() Executes the script with the submitted parameters.
void	export(Writer imports, File dir, boolean shallow)
ScriptContext	getContext()
ArrayList<Include>	getIncludes() Method for castor marshall
String	getItemID()
static Script	getScript(String name, Integer version) Resolves the Script object using its name and version.
String	getScriptData()
static void	main(String[] args)
CollectionArrayList	makeDescCollections()
void	setContext(ScriptContext context)
void	setIncludes(ArrayList<Include> includes) Method for castor unmarshall
boolean	setInputParamValue(String name, Object value) Submits an input parameter to the script.
void	setScriptData(String script)
void	setScriptEngine(String requestedLang) Sets the language

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.cristalise.kernel.utils.DescriptionObject

getItemPath, getName, getVersion, setItemPath, setName, setVersion

Constructor Detail

Script

public Script()

Constructor for castor unmarshall

Script

public Script(String name,
              Integer version,
              ItemPath path,
              String xml)
       throws ScriptParsingException,
              ParameterException

For testing. Parses a given script xml, instead of loading it from Items.

Throws:

ScriptParsingException

ParameterException

Script

public Script(String lang,
              String expr,
              Class<?> returnType)
       throws ScriptingEngineException

Creates a script executor for the supplied expression, bypassing the xml parsing bit

Parameters:

lang - - script language

expr - - the script to run

returnType - Class of the return of the Script

Throws:

ScriptingEngineException

Script

public Script(String lang,
              String name,
              String expr,
              AgentProxy agent)
       throws ScriptingEngineException

Creates a script executor requiring an agent to be set. Used by module event scripts.

Parameters:

lang - - script language

name - - script name for debugging

expr - - the script to run

agent - - the agentproxy to pass into the script as 'agent'

Throws:

ScriptingEngineException

Script

public Script(String lang,
              String expr)
       throws ScriptingEngineException

Creates a script executor for the supplied expression, bypassing the xml parsing bit Output class is forced to an object.

Parameters:

lang - - script language

expr - - the script to run

Throws:

ScriptingEngineException

Script

public Script(String lang,
              AgentProxy agent,
              PrintStream out)
       throws Exception

For consoles

Parameters:

lang - - script language

agent - - Proxy of the console Agent(user)

out - - the output PrintStream for reporting results that don't go to the log

Throws:

Exception

Method Detail

setScriptEngine

public void setScriptEngine(String requestedLang)
                     throws ScriptingEngineException

Sets the language

Parameters:

requestedLang - the language

Throws:

ScriptingEngineException

setContext

public void setContext(ScriptContext context)

Parameters:

context - ScriptContext

getContext

public ScriptContext getContext()

Returns:

ScriptContext

addInputParam

protected void addInputParam(String name,
                             String type)
                      throws ParameterException

Parameters:

name -

type -

Throws:

ParameterException

addInputParam

protected void addInputParam(String name,
                             Class<?> type)
                      throws ParameterException

Throws:

ParameterException

addIncludedInputParam

protected void addIncludedInputParam(String name,
                                     Class<?> type)
                              throws ParameterException

Parameters:

name -

type -

Throws:

ParameterException

addOutput

protected void addOutput(String name,
                         String type)
                  throws ParameterException

Parameters:

name -

type -

Throws:

ParameterException

addOutput

protected void addOutput(String name,
                         Class<?> type)
                  throws ParameterException

Parameters:

name -

type -

Throws:

ParameterException

setInputParamValue

public boolean setInputParamValue(String name,
                                  Object value)
                           throws ParameterException

Submits an input parameter to the script. Must be declared by name and type in the script XML.

Parameters:

name - - input parameter name from the script xml

value - - object to use for this parameter

Returns:

if the input parameter was used or not

Throws:

ParameterException - - name not found or wrong type

evaluate

public Object evaluate(ItemPath itemPath,
                       CastorHashMap inputProps,
                       String actContext,
                       Object locker)
                throws ScriptingEngineException

Parameters:

itemPath -

inputProps -

actContext -

locker -

Returns:

Throws:

ScriptingEngineException

evaluate

public Object evaluate(ItemPath itemPath,
                       CastorHashMap inputProps,
                       String actContext,
                       boolean actExecEnv,
                       Object locker)
                throws ScriptingEngineException

Reads and evaluates input properties, set input parameters from those properties and executes the Script

Parameters:

itemPath - the Item context

inputProps - imput properties

actContext - activity path

locker - transaction locker

Returns:

the values returned by the Script

Throws:

ScriptingEngineException

execute

public Object execute()
               throws ScriptingEngineException

Executes the script with the submitted parameters. All declared input parametes should have been set first.

Returns:

The return value depends on the way the output type was declared in the script xml.

• If there was no output class declared then null is returned
• If a class was declared, but not named, then the object returned by the script is checked to be of that type, then returned.
• If the output value was named and typed, then an object of that class is created and passed to the script as an input parameter. The script should set this before it returns.

Throws:

ScriptingEngineException - - input parameters weren't set, there was an error executing the script, or the output was invalid

setScriptData

public void setScriptData(String script)
                   throws ScriptParsingException

Throws:

ScriptParsingException

getScriptData

public String getScriptData()

getItemID

public String getItemID()

Specified by:

getItemID in interface DescriptionObject

getScript

public static Script getScript(String name,
                               Integer version)
                        throws ScriptingEngineException,
                               ObjectNotFoundException,
                               InvalidDataException

Resolves the Script object using its name and version. If Version is null tries to interpret the name as an expression

Parameters:

name - the name of the Script Item or an expression

version - the version of the Script. If set to null

Returns:

Script

Throws:

ScriptingEngineException

ObjectNotFoundException

InvalidDataException

See Also:

BuiltInVertexProperties.ROUTING_EXPR

getIncludes

public ArrayList<Include> getIncludes()

Method for castor marshall

Returns:

list of Include objects

setIncludes

public void setIncludes(ArrayList<Include> includes)
                 throws ObjectNotFoundException,
                        InvalidDataException,
                        ParameterException,
                        ScriptParsingException

Method for castor unmarshall

Parameters:

includes - included Scripts

Throws:

ObjectNotFoundException

InvalidDataException

ParameterException

ScriptParsingException

makeDescCollections

public CollectionArrayList makeDescCollections()
                                        throws InvalidDataException,
                                               ObjectNotFoundException

Specified by:

makeDescCollections in interface DescriptionObject

Throws:

InvalidDataException

ObjectNotFoundException

export

public void export(Writer imports,
                   File dir,
                   boolean shallow)
            throws IOException

Specified by:

export in interface DescriptionObject

Throws:

IOException

main

public static void main(String[] args)