sapphire.util

Class ActionBlock

java.lang.Object

sapphire.util.ActionBlock

All Implemented Interfaces:

java.io.Serializable

public class ActionBlock
extends java.lang.Object
implements java.io.Serializable

Allows to create and maintain a group of actions and their properties.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ActionBlock.Action
class	ActionBlock.BlockProperty
class	ActionBlock.ReturnProperty

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMMAND_ACTION
static java.lang.String	COMMAND_ACTIONBLOCK
static java.lang.String	COMMAND_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
ActionBlock() Default contructor
ActionBlock(org.json.JSONObject jsonObject) Contructor based on JSONObject
ActionBlock(java.lang.String xml) Contructor based on xml definition
ActionBlock(java.lang.String name, java.lang.String xml) Contructor based on a name (for performance monitoring) and an xml definition

Method Summary

Modifier and Type	Method and Description
void	addActionBlockCommand(ActionBlock actionBlock) Internal method.
void	addBlockPropertyCommand(java.lang.String propertyid, java.lang.String value) Internal method.
void	addChildCaseActionBlock(java.lang.String caseValue, ActionBlock childActionBlock) Internal method.
void	addReturnPropertyCommand(java.lang.String propertyid, java.lang.String value) Internal method.
void	endProcessing() Internal method.
ActionBlock.Action	getAction(java.lang.String name) Internal method.
ActionBlock	getActionBlock(int index) Internal method.
java.lang.String	getActionClass(int actionindex) Returns the actionclass for the given index of an acion in the block
java.lang.String	getActionClass(java.lang.String name) Returns the action class for the given action block name
int	getActionCount() Returns the number of actions defined in the block.
java.lang.String	getActionid(int actionindex) Returns the actionid for the given index of an acion in the block
java.lang.String	getActionid(java.lang.String name) Returns the actionid for the given action block name
java.lang.String	getActionName(int actionindex) Returns the name of an action for the given index
java.util.HashMap	getActionProperties(int actionindex) Gets the property values for the given Action in the Block.
java.util.HashMap	getActionProperties(java.lang.String name) Gets the property values for the given Action in the Block.
java.lang.String	getActionProperty(int actionindex, java.lang.String propertyid) Gets a property value for the given Action in the Block.
java.lang.String	getActionProperty(java.lang.String name, java.lang.String propertyid) Gets a property value for the given Action in the Block.
java.lang.String	getActionTest(int actionindex) Returns the test for the given index of an acion in the block
java.lang.String	getAsyncDueDt() Returns the due date for action block when executed asynchronously
java.util.HashMap	getBlockProperties() Returns a pointer to all of the actionblock properties
java.lang.String	getBlockProperty(java.lang.String propertyid) Returns a single block property.
java.lang.String	getCaseValue()
ActionBlock	getChildCaseActionBlock(java.lang.String caseValue)
java.lang.Object	getCommand(int index) Internal method.
int	getCommandCount() Internal method.
java.lang.String	getDebugLog() Returns the debug log
java.util.List<java.lang.String>	getDistinctActionClasses()
java.util.List<java.lang.String>	getDistinctActions()
int	getErrorAction() Returns the current error action number (-1 if no error action)
java.lang.String	getErrorActionName() Returns the current error action name (empty string if no error action)
ErrorHandler	getErrorHandler() Internal method.
java.util.HashMap	getGroovyBindings() Returns a pointer to all of the actionblock properties
java.lang.String	getName() Returns the name assigned to the action block
java.util.HashMap	getReturnProperties() Returns a pointer to all of the actionblock properties
java.lang.String	getReturnProperty(java.lang.String propertyid) Returns a single block property.
java.lang.String	getTest() Internal method.
java.lang.String	getTest(java.lang.String name) Returns the test for the given action block name
java.lang.String	getTestName() Returns the label assigned to the action block test condition
java.lang.String	getTodolistid()
java.lang.String	getVersionid(int actionindex) Returns the versionid for the given index of an acion in the block
java.lang.String	getVersionid(java.lang.String name) Returns the versionid for the given action block name
boolean	hasChildCaseActionBlock()
boolean	isDebugMode() Whether the actionblock is in debug mode
void	log(java.lang.String message) Internal method.
void	setAction(java.lang.String name, java.lang.String actionid, java.lang.String versionid) Creates a new action inside the action block and initialize its properties.
void	setAction(java.lang.String name, java.lang.String actionid, java.lang.String versionid, java.util.HashMap properties) Creates a new action inside the action block and initialize its properties.
void	setAction(java.lang.String name, java.lang.String actionid, java.lang.String versionid, PropertyList properties) Creates a new action inside the action block and initialize its properties.
void	setAction(java.lang.String name, java.lang.String test, java.lang.String actionClass, java.lang.String actionid, java.lang.String versionid, java.util.HashMap hmProperties) Internal method.
void	setAction(java.lang.String name, java.lang.String test, java.lang.String actionClass, java.lang.String actionid, java.lang.String versionid, PropertyList properties) Internal method.
void	setActionBlockProperty(java.lang.String name, java.lang.String blockpropertyid, java.lang.String actionpropertyid) Sets a block property based on an action output property.
void	setActionClass(java.lang.String name, java.lang.String actionClass) Creates a new action inside the action block and initialize its properties.
void	setActionClass(java.lang.String name, java.lang.String actionClass, java.util.HashMap properties) Creates a new action inside the action block and initialize its properties.
void	setActionClass(java.lang.String name, java.lang.String actionClass, PropertyList properties) Creates a new action inside the action block and initialize its properties.
void	setActionLabel(java.lang.String actionName, java.lang.String actionlabel) Internal method.
void	setActionProperties(int actionindex, java.util.HashMap properties) Sets the property values for the given Action in the Block.
void	setActionProperties(int actionindex, PropertyList properties) Sets the property values for the given Action in the Block.
void	setActionProperties(java.lang.String name, java.util.HashMap properties) Sets the property values for the given Action in the Block.
void	setActionProperties(java.lang.String name, PropertyList properties) Sets the property values for the given Action in the Block.
void	setActionProperty(java.lang.String name, java.lang.String propertyid, java.lang.String value) Sets a property value for the given Action in the Block.
void	setAsyncDueDt(java.lang.String asyncDueDt) Sets a due date for action blocks executed asynchronously
void	setBlockProperties(java.util.HashMap properties) Sets a collection of properties for the action block.
void	setBlockProperties(PropertyList properties) Sets a collection of properties for the action block.
void	setBlockProperty(java.lang.String propertyid, java.lang.String value) Sets a single property for the block.
void	setCaseValue(java.lang.String caseValue)
void	setDebugLog(java.lang.String log) Internal method.
void	setDebugMode(boolean debugMode) Put the actionblock into Debug mode
void	setErrorAction(int errorAction) Sets the current error action number (-1 if no error action)
void	setGroovyBindings(java.util.HashMap bindings) Sets a collection of binding maps for the Groovy expressions
void	setJSONObject(org.json.JSONObject jsonObject) Populates an action block based on a xml definition
void	setName(java.lang.String name) Populates an action block based on a xml definition
void	setReturnProperties(java.util.HashMap properties) Sets a collection of properties for the action block.
void	setReturnProperties(PropertyList properties) Sets a collection of properties for the action block.
void	setReturnProperty(java.lang.String propertyid, java.lang.String value) Sets a single property for the block.
void	setTest(java.lang.String test) Sets a conditional test for the action block.
void	setTestName(java.lang.String testName) Sets a label for the conditional test for the action block.
void	setTodolistid(java.lang.String todolistid)
void	setXML(java.lang.String xml) Populates an action block based on a xml definition
void	startProcessing() Internal method.
void	synchronizeProperties(ActionBlock returnactionblock) Internal method.
org.json.JSONObject	toJSONObject()
java.lang.String	toJSONString() Public toJSON
java.lang.String	toString() Public toString
java.lang.String	toXML() Public toXML

Methods inherited from class java.lang.Object

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

Field Detail

COMMAND_ACTION

public static final java.lang.String COMMAND_ACTION

See Also:

Constant Field Values

COMMAND_ACTIONBLOCK

public static final java.lang.String COMMAND_ACTIONBLOCK

See Also:

Constant Field Values

COMMAND_UNKNOWN

public static final java.lang.String COMMAND_UNKNOWN

See Also:

Constant Field Values

Constructor Detail

ActionBlock

public ActionBlock()

Default contructor

ActionBlock

public ActionBlock(java.lang.String name,
                   java.lang.String xml)
            throws SapphireException

Contructor based on a name (for performance monitoring) and an xml definition

Throws:

SapphireException

ActionBlock

public ActionBlock(java.lang.String xml)
            throws SapphireException

Contructor based on xml definition

Throws:

SapphireException

ActionBlock

public ActionBlock(org.json.JSONObject jsonObject)
            throws SapphireException

Contructor based on JSONObject

Throws:

SapphireException

Method Detail

setXML

public void setXML(java.lang.String xml)
            throws SapphireException

Populates an action block based on a xml definition

Parameters:

xml - XML String containing actionblocks, actions, properties and returns

Throws:

SapphireException

setJSONObject

public void setJSONObject(org.json.JSONObject jsonObject)
                   throws SapphireException

Populates an action block based on a xml definition

Parameters:

jsonObject - JSON Object containing actionblocks, actions, properties and returns

Throws:

SapphireException

getName

public java.lang.String getName()

Returns the name assigned to the action block

Returns:

the name

getTestName

public java.lang.String getTestName()

Returns the label assigned to the action block test condition

Returns:

the testName

setName

public void setName(java.lang.String name)

Populates an action block based on a xml definition

Parameters:

name - name A name for the action block to be used for monitoring performance stats

getCaseValue

public java.lang.String getCaseValue()

setCaseValue

public void setCaseValue(java.lang.String caseValue)

getAsyncDueDt

public java.lang.String getAsyncDueDt()

Returns the due date for action block when executed asynchronously

Returns:

the due date

setAsyncDueDt

public void setAsyncDueDt(java.lang.String asyncDueDt)

Sets a due date for action blocks executed asynchronously

Parameters:

asyncDueDt - Due date

toString

public java.lang.String toString()

Public toString

Overrides:

toString in class java.lang.Object

Returns:

String representation of the ActionBlock contents

toXML

public java.lang.String toXML()

Public toXML

Returns:

String XML representation of the ActionBlock contents

toJSONString

public java.lang.String toJSONString()

Public toJSON

Returns:

String JSON representation of the ActionBlock contents

toJSONObject

public org.json.JSONObject toJSONObject()

setTest

public void setTest(java.lang.String test)

Sets a conditional test for the action block.

Parameters:

test - A groovy expression that determines whether this actionblock should execute or not

setTestName

public void setTestName(java.lang.String testName)

Sets a label for the conditional test for the action block.

Parameters:

testName - A label for a conditional test in a actionblock

setGroovyBindings

public void setGroovyBindings(java.util.HashMap bindings)

Sets a collection of binding maps for the Groovy expressions

Parameters:

bindings - A HashMap of bindings for the block.

getGroovyBindings

public java.util.HashMap getGroovyBindings()

Returns a pointer to all of the actionblock properties

Returns:

The properties of the block.

setBlockProperties

public void setBlockProperties(java.util.HashMap properties)

Sets a collection of properties for the action block.

Parameters:

properties - A HashMap of properties for the block.

setBlockProperties

public void setBlockProperties(PropertyList properties)

Sets a collection of properties for the action block.

Parameters:

properties - A PropertyList of properties for the block.

setBlockProperty

public void setBlockProperty(java.lang.String propertyid,
                             java.lang.String value)

Sets a single property for the block.

Parameters:

propertyid - The property identifier.

value - The property value.

getBlockProperty

public java.lang.String getBlockProperty(java.lang.String propertyid)

Returns a single block property.

Parameters:

propertyid - The property identifier.

Returns:

The value of the property or an empty string.

getBlockProperties

public java.util.HashMap getBlockProperties()

Returns a pointer to all of the actionblock properties

Returns:

The properties of the block.

setReturnProperties

public void setReturnProperties(java.util.HashMap properties)

Sets a collection of properties for the action block.

Parameters:

properties - A HashMap of properties for the block.

setReturnProperties

public void setReturnProperties(PropertyList properties)

Sets a collection of properties for the action block.

Parameters:

properties - A PropertyList of properties for the block.

setReturnProperty

public void setReturnProperty(java.lang.String propertyid,
                              java.lang.String value)

Sets a single property for the block.

Parameters:

propertyid - The property identifier.

value - The property value.

getReturnProperties

public java.util.HashMap getReturnProperties()

Returns a pointer to all of the actionblock properties

Returns:

The properties of the block.

getReturnProperty

public java.lang.String getReturnProperty(java.lang.String propertyid)

Returns a single block property.

Parameters:

propertyid - The property identifier.

Returns:

The value of the property or an empty string.

setAction

public void setAction(java.lang.String name,
                      java.lang.String actionid,
                      java.lang.String versionid)
               throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionid - Identifier of the Sapphire server-side action to be processed.

versionid - Version of the action to be processed.

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setAction

public void setAction(java.lang.String name,
                      java.lang.String actionid,
                      java.lang.String versionid,
                      java.util.HashMap properties)
               throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionid - Identifier of the Sapphire server-side action to be processed.

versionid - Version of the action to be processed.

properties - A HashMap of properties that you want for the action in a String/String key/value pair.

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setAction

public void setAction(java.lang.String name,
                      java.lang.String actionid,
                      java.lang.String versionid,
                      PropertyList properties)
               throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionid - Identifier of the Sapphire server-side action to be processed.

versionid - Version of the action to be processed.

properties - The properties that you want for the action in a String/String key/value pair.

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setActionClass

public void setActionClass(java.lang.String name,
                           java.lang.String actionClass)
                    throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionClass - An class descendant of BaseAction

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setActionClass

public void setActionClass(java.lang.String name,
                           java.lang.String actionClass,
                           java.util.HashMap properties)
                    throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionClass - An class descendant of BaseAction

properties - A HashMap of properties that you want for the action in a String/String key/value pair.

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setActionClass

public void setActionClass(java.lang.String name,
                           java.lang.String actionClass,
                           PropertyList properties)
                    throws ActionException

Creates a new action inside the action block and initialize its properties.

Parameters:

name - Unique name used to identify the action inside the block.

actionClass - An class descendant of BaseAction

properties - The properties that you want for the action in a String/String key/value pair.

Throws:

ActionException - When the action already exists or the action identifier/version are incorrect.

setActionProperty

public void setActionProperty(java.lang.String name,
                              java.lang.String propertyid,
                              java.lang.String value)
                       throws ActionException

Sets a property value for the given Action in the Block.

Parameters:

name - Unique identifier used to identify the action inside the block.

propertyid - The property that you want to update.

value - The value of the property.

Throws:

ActionException - When the action does not exist or the property identifier/value pair is invalid.

getActionProperty

public java.lang.String getActionProperty(java.lang.String name,
                                          java.lang.String propertyid)
                                   throws ActionException

Gets a property value for the given Action in the Block.

Parameters:

name - Unique identifier used to identify the action inside the block.

propertyid - The property identifier.

Returns:

The value of the

Throws:

ActionException - When the action name does not exist or the property identifier is invalid.

getActionProperty

public java.lang.String getActionProperty(int actionindex,
                                          java.lang.String propertyid)
                                   throws ActionException

Gets a property value for the given Action in the Block.

Parameters:

actionindex - Index used to identify the action inside the block.

propertyid - The property identifier.

Throws:

ActionException - When the action name does not exist or the property identifier is invalid.

setActionProperties

public void setActionProperties(java.lang.String name,
                                java.util.HashMap properties)
                         throws ActionException

Sets the property values for the given Action in the Block.

Parameters:

name - Unique identifier used to identify the action inside the block.

properties - A HashMap of properties for the action.

Throws:

ActionException - When the action name does not exist or the properties are null.

setActionProperties

public void setActionProperties(java.lang.String name,
                                PropertyList properties)
                         throws ActionException

Sets the property values for the given Action in the Block.

Parameters:

name - Unique identifier used to identify the action inside the block.

properties - The properties for the action.

Throws:

ActionException - When the action name does not exist or the properties are null.

setActionProperties

public void setActionProperties(int actionindex,
                                java.util.HashMap properties)
                         throws ActionException

Sets the property values for the given Action in the Block.

Parameters:

actionindex - Unique identifier used to identify the action inside the block.

properties - A HashMap of properties for the action.

Throws:

ActionException - When the action index is invalid or the properties are null.

setActionProperties

public void setActionProperties(int actionindex,
                                PropertyList properties)
                         throws ActionException

Sets the property values for the given Action in the Block.

Parameters:

actionindex - Unique identifier used to identify the action inside the block.

properties - The properties for the action.

Throws:

ActionException - When the action index is invalid or the properties are null.

getActionProperties

public java.util.HashMap getActionProperties(java.lang.String name)
                                      throws ActionException

Gets the property values for the given Action in the Block.

Parameters:

name - Unique identifier used to identify the action inside the block.

Returns:

the properties for the action.

Throws:

ActionException - When the action name does not exist.

getActionProperties

public java.util.HashMap getActionProperties(int actionindex)
                                      throws ActionException

Gets the property values for the given Action in the Block.

Parameters:

actionindex - The index of the action in the block

Returns:

the properties for the action.

Throws:

ActionException - When the action name does not exist.

getActionCount

public int getActionCount()

Returns the number of actions defined in the block.

Returns:

The number of actions.

getChildCaseActionBlock

public ActionBlock getChildCaseActionBlock(java.lang.String caseValue)

hasChildCaseActionBlock

public boolean hasChildCaseActionBlock()

getDistinctActions

public java.util.List<java.lang.String> getDistinctActions()

getDistinctActionClasses

public java.util.List<java.lang.String> getDistinctActionClasses()

getActionName

public java.lang.String getActionName(int actionindex)
                               throws ActionException

Returns the name of an action for the given index

Returns:

The action name.

Throws:

ActionException - When the index is invalid for the block.

getActionid

public java.lang.String getActionid(java.lang.String name)
                             throws ActionException

Returns the actionid for the given action block name

Parameters:

name - The name of the action in the block.

Returns:

The actionid.

Throws:

ActionException - When the name is invalid for the block.

getActionid

public java.lang.String getActionid(int actionindex)
                             throws ActionException

Returns the actionid for the given index of an acion in the block

Parameters:

actionindex - The index of the action in the block.

Returns:

The actionid.

Throws:

ActionException - When the index is invalid for the block.

getActionClass

public java.lang.String getActionClass(java.lang.String name)
                                throws ActionException

Returns the action class for the given action block name

Parameters:

name - The name of the action in the block.

Returns:

The action class.

Throws:

ActionException - When the name is invalid for the block.

getActionClass

public java.lang.String getActionClass(int actionindex)
                                throws ActionException

Returns the actionclass for the given index of an acion in the block

Parameters:

actionindex - The index of the action in the block.

Returns:

The action class.

Throws:

ActionException - When the index is invalid for the block.

getVersionid

public java.lang.String getVersionid(java.lang.String name)
                              throws ActionException

Returns the versionid for the given action block name

Parameters:

name - The name of the action in the block.

Returns:

The versionid.

Throws:

ActionException - When the name is invalid for the block.

getVersionid

public java.lang.String getVersionid(int actionindex)
                              throws ActionException

Returns the versionid for the given index of an acion in the block

Parameters:

actionindex - The index of the action in the block.

Returns:

The versionid.

Throws:

ActionException - When the index is invalid for the block.

getTest

public java.lang.String getTest(java.lang.String name)
                         throws ActionException

Returns the test for the given action block name

Parameters:

name - The name of the action in the block.

Returns:

The test.

Throws:

ActionException - When the name is invalid for the block.

getActionTest

public java.lang.String getActionTest(int actionindex)
                               throws ActionException

Returns the test for the given index of an acion in the block

Parameters:

actionindex - The index of the action in the block.

Returns:

The test.

Throws:

ActionException - When the index is invalid for the block.

setActionBlockProperty

public void setActionBlockProperty(java.lang.String name,
                                   java.lang.String blockpropertyid,
                                   java.lang.String actionpropertyid)
                            throws ActionException

Sets a block property based on an action output property.

Parameters:

name - The name of the action

blockpropertyid - The property that you want to update

actionpropertyid - The name of the property for the given action block

Throws:

ActionException - When the name is invalid for the block.

getErrorAction

public int getErrorAction()

Returns the current error action number (-1 if no error action)

Returns:

the number of the action in error

setErrorAction

public void setErrorAction(int errorAction)

Sets the current error action number (-1 if no error action)

Parameters:

errorAction - the number of the action in error

setDebugMode

public void setDebugMode(boolean debugMode)

Put the actionblock into Debug mode

Parameters:

debugMode - whether the actionblock is in debug mode or not

isDebugMode

public boolean isDebugMode()

Whether the actionblock is in debug mode

Returns:

boolean whether the actionblock is in debug mode or not

getDebugLog

public java.lang.String getDebugLog()

Returns the debug log

Returns:

String The debug log

getErrorActionName

public java.lang.String getErrorActionName()

Returns the current error action name (empty string if no error action)

Returns:

the number of the action in error

getErrorHandler

public ErrorHandler getErrorHandler()

Internal method. Not for reuse.

getAction

public ActionBlock.Action getAction(java.lang.String name)
                             throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

getTodolistid

public java.lang.String getTodolistid()

setTodolistid

public void setTodolistid(java.lang.String todolistid)

synchronizeProperties

public void synchronizeProperties(ActionBlock returnactionblock)
                           throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

setAction

public void setAction(java.lang.String name,
                      java.lang.String test,
                      java.lang.String actionClass,
                      java.lang.String actionid,
                      java.lang.String versionid,
                      PropertyList properties)
               throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

setAction

public void setAction(java.lang.String name,
                      java.lang.String test,
                      java.lang.String actionClass,
                      java.lang.String actionid,
                      java.lang.String versionid,
                      java.util.HashMap hmProperties)
               throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

setActionLabel

public void setActionLabel(java.lang.String actionName,
                           java.lang.String actionlabel)
                    throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

addActionBlockCommand

public void addActionBlockCommand(ActionBlock actionBlock)
                           throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

addChildCaseActionBlock

public void addChildCaseActionBlock(java.lang.String caseValue,
                                    ActionBlock childActionBlock)

Internal method. Not for reuse.

addBlockPropertyCommand

public void addBlockPropertyCommand(java.lang.String propertyid,
                                    java.lang.String value)
                             throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

addReturnPropertyCommand

public void addReturnPropertyCommand(java.lang.String propertyid,
                                     java.lang.String value)
                              throws ActionException

Internal method. Not for reuse.

Throws:

ActionException

startProcessing

public void startProcessing()

Internal method. Not for reuse.

endProcessing

public void endProcessing()

Internal method. Not for reuse.

setDebugLog

public void setDebugLog(java.lang.String log)

Internal method. Not for reuse.

log

public void log(java.lang.String message)

Internal method. Not for reuse.

getCommandCount

public int getCommandCount()

Internal method. Not for reuse.

getTest

public java.lang.String getTest()

Internal method. Not for reuse.

getActionBlock

public ActionBlock getActionBlock(int index)

Internal method. Not for reuse.

getCommand

public java.lang.Object getCommand(int index)

Internal method. Not for reuse.