org.lsst.ccs.bus.data

Class DataDictionary

java.lang.Object

org.lsst.ccs.bus.data.DataDictionary

All Implemented Interfaces:

Serializable, DataProviderDictionary

public final class DataDictionary
extends Object
implements DataProviderDictionary

Data dictionary implementation that minimizes memory footprint and serialized size at the expense of access speed. Instances of this class are immutable.

Implementation notes

Currently, extra complexity is added by the fact that we associate key as well as path with every data channel. This is left over from supporting both full and short paths, and is expected to be removed in later versions. For now, int keyFlag is associated with every tree node to tell how to extract path and key from the full path:

• keyFlag = NO_PATH : not a terminal node
• keyFlag = NULL_PATH : path = null, key = fullPath
• keyFlag = EMPTY_PATH : path = "", key = fullPath
• keyFlag less than 0 : abs(keyFlag) is the number of segments in key, fullPath = path + key
• others : keyFlag is the number of segments in key, fullPath ends with key

Author:

onoprien

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DataDictionary(DataProviderDictionary other)
DataDictionary(List<DataProviderInfo> data)

Method Summary

Modifier and Type	Method and Description
org.lsst.ccs.utilities.taitime.CCSTimeStamp	getCCSTimeStamp() Deprecated.
List<DataProviderInfo>	getDataProviderDescriptionsForGroup(String group) Deprecated.
DataProviderInfo	getDataProviderInfoForPath(String path) Get the DataProviderInfo definition for the provided path.
List<DataProviderInfo>	getDataProviderInfos()
Set<String>	getGroups() Deprecated.
static void	main(String... args)

Methods inherited from class java.lang.Object

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

Constructor Detail

DataDictionary

public DataDictionary(DataProviderDictionary other)

DataDictionary

public DataDictionary(List<DataProviderInfo> data)

Method Detail

getDataProviderInfos

public List<DataProviderInfo> getDataProviderInfos()

Specified by:

getDataProviderInfos in interface DataProviderDictionary

Returns:

the existing list of DataProviders

getDataProviderInfoForPath

public DataProviderInfo getDataProviderInfoForPath(String path)

Description copied from interface: DataProviderDictionary

Get the DataProviderInfo definition for the provided path.

Specified by:

getDataProviderInfoForPath in interface DataProviderDictionary

Parameters:

path - The path for the desired DataProviderInfo

Returns:

The corresponding DataProviderInfo, or null otherwise.

getGroups

@Deprecated
public Set<String> getGroups()

Deprecated.

Specified by:

getGroups in interface DataProviderDictionary

Returns:

the existing groups

getDataProviderDescriptionsForGroup

@Deprecated
public List<DataProviderInfo> getDataProviderDescriptionsForGroup(String group)

Deprecated.

Specified by:

getDataProviderDescriptionsForGroup in interface DataProviderDictionary

Returns:

getCCSTimeStamp

@Deprecated
public org.lsst.ccs.utilities.taitime.CCSTimeStamp getCCSTimeStamp()

Deprecated.

Description copied from interface: DataProviderDictionary

Get the CCSTimeStamp of when this dictionary was created.

Specified by:

getCCSTimeStamp in interface DataProviderDictionary

Returns:

The CCSTimeStamp when this dictionary was created.

main

public static void main(String... args)