org.lsst.ccs.gconsole.agent

Interface AgentChannelsFilter

All Known Implementing Classes:

AbstractChannelsFilter

public interface AgentChannelsFilter

A filter that selects a set of data channels and defines their presentation. Original channels are identified by their unique string trending paths (slash-separated, the first segment is the subsystem name). This filter maps some of the original channels to one or more display paths in "[page//]path1/.../pathN/name" format.

Author:

onoprien

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AgentChannelsFilter.Listener Interface to be implemented by classes that should be notified of changes in the AgentChannelsFilter.

Field Summary

Fields

Modifier and Type	Field and Description
static AgentChannelsFilter	PASS Trivial filter that accepts all channels and does not modify paths.

Method Summary

Modifier and Type	Method and Description
default void	addListener(AgentChannelsFilter.Listener listener) Registers a listener that will be notified of any changes in this filter.
default Set<String>	getAgents() Returns a set of subsystem names accepted by this filter.
default Map<String,Object>	getAttributes(String path) Returns attributes associated with the specified path.
default Set<String>	getDisplayChannels() Returns a set of display paths produced by this filter.
default List<String>	getDisplayPath(String originPath) Returns a list of display channels for the specified original channel.
default String	getName() Returns the name of this filter.
default Set<String>	getOriginChannels() Returns a set of original channel paths accepted by this filter.
default String	getOriginPath(String displayPath) Returns the original path corresponding to the specified display channel.
default void	removeListener(AgentChannelsFilter.Listener listener) Removes a listener.

Field Detail

PASS

static final AgentChannelsFilter PASS

Trivial filter that accepts all channels and does not modify paths. This filter uses default implementations for all methods.

Method Detail

getName

default String getName()

Returns the name of this filter.

Returns:

Name of this filter.

getAgents

default Set<String> getAgents()

Returns a set of subsystem names accepted by this filter.

Returns:

Agent names accepted by this filter, or null if any agent might be accepted.

getOriginChannels

default Set<String> getOriginChannels()

Returns a set of original channel paths accepted by this filter.

Returns:

Original channel paths accepted by this filter, or null if any original path for which getDisplayPath(java.lang.String) returns a non-empty list is accepted.

getDisplayChannels

default Set<String> getDisplayChannels()

Returns a set of display paths produced by this filter. Typically, if this method returns a non-null set, components downstream from this filter will display this fixed set of channels, whether or not the data is available, regardless of what paths are returned by getDisplayPath(java.lang.String) applied to accepted original channels. Otherwise, any display channels for which the data is available will be displayed.

Returns:

Display paths produced by this filter, or null if the set is not fixed.

getOriginPath

default String getOriginPath(String displayPath)

Returns the original path corresponding to the specified display channel.

Parameters:

displayPath - The display channel path.

Returns:

The original path, or null if the specified path does not correspond to any original channel.

getDisplayPath

default List<String> getDisplayPath(String originPath)

Returns a list of display channels for the specified original channel.

Parameters:

originPath - The path of the original channel.

Returns:

Display paths, or an empty list if the specified channel is not accepted by this filter.

getAttributes

default Map<String,Object> getAttributes(String path)

Returns attributes associated with the specified path.

Parameters:

path - Full or partial display path.

Returns:

Map of attribute names to their values.

addListener

default void addListener(AgentChannelsFilter.Listener listener)

Registers a listener that will be notified of any changes in this filter.

Parameters:

listener - Listener to be notified.

removeListener

default void removeListener(AgentChannelsFilter.Listener listener)

Removes a listener.

Parameters:

listener - Listener to be removed.