org.lsst.ccs.bus.messages

Class StatusMessage<T extends Serializable,D>

java.lang.Object

org.lsst.ccs.bus.messages.BusMessage<T,D>

org.lsst.ccs.bus.messages.StatusMessage<T,D>

Type Parameters:

T - Any Serializable class embedded in the StatusMessage

D - The class of the encoded object.

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

StatusAlert, StatusCommandDictionary, StatusConfigurationInfo, StatusData, StatusDataProviderDictionary, StatusEnum, StatusHeartBeat, StatusLock, StatusStateChangeNotification

public abstract class StatusMessage<T extends Serializable,D>
extends BusMessage<T,D>

Base class for all messages sent on the Status Bus. All StatusMessage objects contain the internal state of the Agent from which they originated at the time of publication. The default encoding for StatusMessages breaks down the embedded object in key-value pairs (and possibly timestamp) and returns the DataList object containing them. Subclasses can change this default encoding behavior. Please refer to their documentation for further details on their encoding strategy.

Author:

LSST CCS Team

See Also:

Serialized Form

Field Summary

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

obj

Constructor Summary

Constructors

Constructor and Description
StatusMessage(Class clazz, byte[] ser) Build a StatusMessage containing an already serialized object.
StatusMessage(T obj) Build a StatusMessage from the provided Object.

Method Summary

Modifier and Type	Method and Description
StateBundle	getState() Get the published State object that contains the Agent's internal state at the moment the StatusMessage was published.
void	setState(StateBundle state) Set the StateBundle of this StatusMessage.
String	toString()

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

encodeObject, getCCSTimeStamp, getClassName, getDeserializationDuration, getDoneDeSerializationTime, getEncodedData, getObject, getOriginAgentInfo, getSerializationDuration, getSerializationTime, getTransferDuration, setOriginAgentInfo

Methods inherited from class java.lang.Object

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

Constructor Detail

StatusMessage

public StatusMessage(Class clazz,
                     byte[] ser)

Build a StatusMessage containing an already serialized object.

Parameters:

clazz - The Class of the serialized object.

ser - The serialized version of the object to be sent over the buses.

StatusMessage

public StatusMessage(T obj)

Build a StatusMessage from the provided Object.

Parameters:

obj - The Serializable object to be sent over the buses.

Method Detail

setState

public void setState(StateBundle state)

Set the StateBundle of this StatusMessage. The StateBundle represents the state of the Agent at the time the message was sent on the buses. Implementation Note. This method is meant to be used by the messaging layer at the time the message is sent. This method contains a protection against being invoked more than once.

Parameters:

state - The StateBundle representing the state of the Agent at the time the message was sent.

getState

public StateBundle getState()

Get the published State object that contains the Agent's internal state at the moment the StatusMessage was published.

Returns:

The StateBundle object.

toString

public String toString()

Overrides:

toString in class BusMessage<T extends Serializable,D>