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(long timestamp) Create a KeyValueDataList with a time stamp.
KeyValueDataList(String key) Create a KeyValueDataList with a key.
KeyValueDataList(String key, long timestamp) Create a KeyValueDataList with a key and a time stamp.

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, 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) Add a key-value pair with a timestamp to this KeyValueDataList.
void	addData(String key, Serializable value, long timestamp, KeyValueData.KeyValueDataType type) Add a key-value pair with a timestamp to this KeyValueDataList.
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

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

public KeyValueDataList(String key,
                        long timestamp)

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(long timestamp)

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.

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

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

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,
                    long timestamp,
                    KeyValueData.KeyValueDataType type)

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.

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