org.lsst.ccs.bus.data

Class KeyValueDataList

java.lang.Object

org.lsst.ccs.bus.data.KeyValueData

org.lsst.ccs.bus.data.KeyValueDataList

All Implemented Interfaces:

Serializable, Iterable<KeyValueData>

public final class KeyValueDataList
extends KeyValueData
implements Serializable, Iterable<KeyValueData>

An object designed to group together KeyValueData objects before publication on the Status bus. This is a KeyValueData itself, whose value is a List At construction time this list is associated a time stamp, either as a user input or set to the creation time by default. When data is added to this list, it is stored internally as a KeyValueData. If no time stamp is provided at the time the key-value pair is added, it is by default assigned the time stamp of the list.

Author:

The LSST CCS Team

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.lsst.ccs.bus.data.KeyValueData

KeyValueData.KeyValueDataType

Constructor Summary

Constructors

Constructor and Description
KeyValueDataList() Create a KeyValueDataList without a key or a timestamp.
KeyValueDataList(CCSTimeStamp ccsTimeStamp) Create a KeyValueDataList with a ccs time stamp.
KeyValueDataList(long timestamp) Deprecated. use constructor with CCSTimeStamp
KeyValueDataList(String key) Create a KeyValueDataList with a key.
KeyValueDataList(String key, CCSTimeStamp ccsTimeStamp) Create a KeyValueDataList with a key and a time stamp.
KeyValueDataList(String key, long timestamp) Deprecated. use constructor with CCSTimeStamp

Method Summary

Modifier and Type	Method and Description
void	addData(KeyValueData data) Add a KeyValueData object to the KeyValueDataList.
void	addData(String key, Serializable value) Add a key-value pair to this KeyValueDataList by assigning it the timestamp of the KeyDataList.
void	addData(String key, Serializable value, CCSTimeStamp ccsTimeStamp) Add a key-value pair with a CCS timestamp to this KeyValueDataList.
void	addData(String key, Serializable value, CCSTimeStamp ccsTimeStamp, KeyValueData.KeyValueDataType type) Add a key-value pair with a CCS timestamp to this KeyValueDataList.
void	addData(String key, Serializable value, KeyValueData.KeyValueDataType type) Add a key-value pair to this KeyValueDataList by assigning it the timestamp of the KeyDataList.
void	addData(String key, Serializable value, long timestamp) Deprecated. use corresponding method with CCSTimeStamp
void	addData(String key, Serializable value, long timestamp, KeyValueData.KeyValueDataType type) Deprecated. use corresponding method with CCSTimeStamp
List<KeyValueData>	getListOfKeyValueData() Get the list of KeyValueData contained in this object.
List<KeyValueData>	getListOfKeyValueData(KeyValueData.KeyValueDataType type) Get the list of KeyValueData contained in this object for a given type.
Iterator<KeyValueData>	iterator()
String	toString()

Methods inherited from class org.lsst.ccs.bus.data.KeyValueData

getCCSTimeStamp, getKey, getTimestamp, getType, getValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

KeyValueDataList

public KeyValueDataList()

Create a KeyValueDataList without a key or a timestamp. By default the key is assigned the empty String, while the time stamp is that of the object creation. The value of this KeyValueData is a List

KeyValueDataList

public KeyValueDataList(String key)

Create a KeyValueDataList with a key. The time stamp is by default the object creation time. The value of this KeyValueData is a List

Parameters:

key - The list's key

KeyValueDataList

@Deprecated
public KeyValueDataList(String key,
                                    long timestamp)

Deprecated. use constructor with CCSTimeStamp

Create a KeyValueDataList with a key and a time stamp. The value of this KeyValueData is a List

Parameters:

key - The list's key

timestamp - The key-value pair timestamp.

KeyValueDataList

public KeyValueDataList(String key,
                        CCSTimeStamp ccsTimeStamp)

Create a KeyValueDataList with a key and a time stamp. The value of this KeyValueData is a List

Parameters:

key - The list's key

ccsTimeStamp - The key-value pair ccsTimeStamp.

KeyValueDataList

@Deprecated
public KeyValueDataList(long timestamp)

Deprecated. use constructor with CCSTimeStamp

Create a KeyValueDataList with a time stamp. The key is assigned by default the empty String. The value of this KeyValueData is a List

Parameters:

timestamp - The key-value pair timestamp.

KeyValueDataList

public KeyValueDataList(CCSTimeStamp ccsTimeStamp)

Create a KeyValueDataList with a ccs time stamp. The key is assigned by default the empty String. The value of this KeyValueData is a List

Parameters:

ccsTimeStamp - The key-value pair ccs timestamp.

Method Detail

addData

public void addData(String key,
                    Serializable value)

Add a key-value pair to this KeyValueDataList by assigning it the timestamp of the KeyDataList. Internally the pair is stored in a KeyValueData object. The default type is KeyValueData.KeyValueDataType.KeyValueTrendingData

Parameters:

key - The key of the pair.

value - The value of the pair.

addData

public void addData(String key,
                    Serializable value,
                    KeyValueData.KeyValueDataType type)

Add a key-value pair to this KeyValueDataList by assigning it the timestamp of the KeyDataList. Internally the pair is stored in a KeyValueData object.

Parameters:

key - The key of the pair.

value - The value of the pair.

type - The type of the KeyValueData to add.

addData

@Deprecated
public void addData(String key,
                                Serializable value,
                                long timestamp)

Deprecated. use corresponding method with CCSTimeStamp

Add a key-value pair with a timestamp to this KeyValueDataList. Internally the pair is stored in a KeyValueData object. The default type is KeyValueData.KeyValueDataType.KeyValueTrendingData

Parameters:

key - The key of the pair.

value - The value of the pair.

timestamp - The timestamp in milliseconds associated to the pair.

addData

public void addData(String key,
                    Serializable value,
                    CCSTimeStamp ccsTimeStamp)

Add a key-value pair with a CCS timestamp to this KeyValueDataList. Internally the pair is stored in a KeyValueData object. The default type is KeyValueData.KeyValueDataType.KeyValueTrendingData

Parameters:

key - The key of the pair.

value - The value of the pair.

ccsTimeStamp - The ccsTimeStamp associated to the pair.

addData

@Deprecated
public void addData(String key,
                                Serializable value,
                                long timestamp,
                                KeyValueData.KeyValueDataType type)

Deprecated. use corresponding method with CCSTimeStamp

Add a key-value pair with a timestamp to this KeyValueDataList. Internally the pair is stored in a KeyValueData object.

Parameters:

key - The key of the pair.

value - The value of the pair.

timestamp - The timestamp in milliseconds associated to the pair.

type - The type of the KeyValueData to add.

addData

public void addData(String key,
                    Serializable value,
                    CCSTimeStamp ccsTimeStamp,
                    KeyValueData.KeyValueDataType type)

Add a key-value pair with a CCS timestamp to this KeyValueDataList. Internally the pair is stored in a KeyValueData object.

Parameters:

key - The key of the pair.

value - The value of the pair.

ccsTimeStamp - The CCS timestamp associated to the pair.

type - The type of the KeyValueData to add.

getListOfKeyValueData

public List<KeyValueData> getListOfKeyValueData()

Get the list of KeyValueData contained in this object.

Returns:

The list of KeyValueData.

getListOfKeyValueData

public List<KeyValueData> getListOfKeyValueData(KeyValueData.KeyValueDataType type)

Get the list of KeyValueData contained in this object for a given type.

Parameters:

type - The KeyValueDataType for which the data is required.

Returns:

The list of KeyValueData that match the provided type.

addData

public void addData(KeyValueData data)

Add a KeyValueData object to the KeyValueDataList.

Parameters:

data - The KeyValueData object to add to the KeyValueDataList.

iterator

public Iterator<KeyValueData> iterator()

Specified by:

iterator in interface Iterable<KeyValueData>

toString

public String toString()

Overrides:

toString in class KeyValueData