org.lsst.ccs.bus

Class Command

java.lang.Object

org.lsst.ccs.bus.BusMessage

org.lsst.ccs.bus.Command

All Implemented Interfaces:

Serializable, BusPayload, CommandBusMessage

Direct Known Subclasses:

ModuleConfigCommand, ModuleInvokerCommand, SystemCommand

public abstract class Command
extends BusMessage
implements CommandBusMessage

A command sent on the CCS bus Will be executed by the destination subsystem.

Author:

Eric Aubourg

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	canRunInActiveMode
protected boolean	canWaitForReady
protected String	command
protected String	destination
protected String	key
protected static org.lsst.ccs.utilities.logging.Logger	log
protected Object[]	parameters
protected boolean	unParsed indicates that the command is a pure String to be parsed by the receiver.

Fields inherited from class org.lsst.ccs.bus.BusMessage

detailLevel, origin, priorityLevel, summary, timeStamp

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Command(String command)
protected	Command(String command, Object[] parameters)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canRunInActiveMode() Can this command be executed by a subsystem which is in "active" mode ?
boolean	canWaitForReady() can this command wait for a single-threaded ownerSubsystem to be ready ?
String	getCommand()
String	getCorrelId()
String	getDestination() The command destination : subsystem name or "*"
String	getKey() Key used for lock and arbitration.
String	getMessageType()
Object[]	getParameters()
boolean	isUnParsed()
boolean	isWrite() is this command a writing command that has to be protected ?
void	setCanRunInActiveMode(boolean canRunInActiveMode)
void	setCanWaitForReady(boolean canWaitForReady) can this command wait for a single-threaded ownerSubsystem to be ready
void	setCorrelId(String correlId) Correlation id, propagated from command to command
void	setDestination(String destination) The command destination : subsystem name or "*"
void	setKey(String key) Key used for lock and arbitration.
void	setUnParsed(boolean unParsed)
String	toString()

Methods inherited from class org.lsst.ccs.bus.BusMessage

getDetailLevel, getOrigin, getPriorityLevel, getSummary, getTimeStamp, setDetailLevel, setOrigin, setPriorityLevel, setSummary, setTimeStamp

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.lsst.ccs.utilities.logging.Logger log

destination

protected String destination

key

protected String key

canWaitForReady

protected boolean canWaitForReady

canRunInActiveMode

protected boolean canRunInActiveMode

unParsed

protected boolean unParsed

indicates that the command is a pure String to be parsed by the receiver.

command

protected String command

parameters

protected Object[] parameters

Constructor Detail

Command

protected Command(String command)

Command

protected Command(String command,
       Object[] parameters)

Method Detail

getMessageType

public String getMessageType()

Specified by:

getMessageType in class BusMessage

getDestination

public String getDestination()

The command destination : subsystem name or "*"

Returns:

command destination

setDestination

public void setDestination(String destination)

The command destination : subsystem name or "*"

Parameters:

destination -

getKey

public String getKey()

Key used for lock and arbitration. If set, incoming commands must have the same key.

Returns:

the key

setKey

public void setKey(String key)

Key used for lock and arbitration. If set, incoming commands must have the same key

Parameters:

key -

isWrite

public boolean isWrite()

is this command a writing command that has to be protected ?

canWaitForReady

public boolean canWaitForReady()

can this command wait for a single-threaded ownerSubsystem to be ready ?

Returns:

a boolean

setCanWaitForReady

public void setCanWaitForReady(boolean canWaitForReady)

can this command wait for a single-threaded ownerSubsystem to be ready

Parameters:

canWaitForReady -

canRunInActiveMode

public boolean canRunInActiveMode()

Can this command be executed by a subsystem which is in "active" mode ?

Returns:

a boolean

setCanRunInActiveMode

public void setCanRunInActiveMode(boolean canRunInActiveMode)

toString

public String toString()

Overrides:

toString in class Object

getCorrelId

public String getCorrelId()

setCorrelId

public void setCorrelId(String correlId)

Correlation id, propagated from command to command

isUnParsed

public boolean isUnParsed()

setUnParsed

public void setUnParsed(boolean unParsed)

getCommand

public String getCommand()

getParameters

public Object[] getParameters()