org.lsst.ccs.gconsole.base.filter

Class TestFilter

java.lang.Object

org.lsst.ccs.gconsole.base.filter.AbstractChannelsFilter

org.lsst.ccs.gconsole.base.filter.TestFilter

All Implemented Interfaces:

AgentChannelsFilter, PersistableAgentChannelsFilter, Persistable, Savable

public class TestFilter
extends AbstractChannelsFilter

Author:

onoprien

Nested Class Summary

Nested classes/interfaces inherited from interface org.lsst.ccs.gconsole.services.persist.Persistable

Persistable.Descriptor

Field Summary

Fields inherited from class org.lsst.ccs.gconsole.base.filter.AbstractChannelsFilter

ALL, CREATOR_PATH_UNFILTERED, descriptor

Fields inherited from interface org.lsst.ccs.gconsole.base.filter.AgentChannelsFilter

CATEGORY

Constructor Summary

Constructors

Constructor and Description
TestFilter()

Method Summary

Modifier and Type	Method and Description
List<String>	getAgents() Returns a list of agent names accepted by this filter.
List<String>	getDisplayChannels() Returns a list of display paths produced by this filter.
String	getDisplayPath(AgentChannel channel) Returns the display path corresponding to the specified original channel.
String	getDisplayPath(String originPath) Returns the display channel corresponding to the specified original path.
List<String>	getDisplayPaths(AgentChannel channel) Returns a list of display channels for the specified original channel.
List<String>	getDisplayPaths(String originPath) Returns a list of display channels for the specified original path.
List<String>	getFields(boolean compact) Returns a list of attributes to display for each channel.
List<String>	getGroups() Returns a list of groups of display paths produced by this filter.
String	getName() Returns the name of this filter.
List<String>	getOriginChannels() Returns a list of original channel selectors that might be accepted by this filter.
String	getOriginPath(String displayPath) Returns the original path corresponding to the specified display channel.
List<String>	getOriginPaths(String displayPath) Returns the list of original paths mapped to the specified display channel.
static PersistableAgentChannelsFilter	getTest()

Methods inherited from class org.lsst.ccs.gconsole.base.filter.AbstractChannelsFilter

getDescriptor, getUnfiltered

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.lsst.ccs.gconsole.base.filter.AgentChannelsFilter

getDisplayPath, isSelector, matchTemplate

Methods inherited from interface org.lsst.ccs.gconsole.services.persist.Persistable

edit, getCategory, getPath, restore, restore, save

Constructor Detail

TestFilter

public TestFilter()

Method Detail

getTest

public static PersistableAgentChannelsFilter getTest()

getName

public String getName()

Description copied from interface: PersistableAgentChannelsFilter

Returns the name of this filter. The default implementation forwards the call to Persistable's descriptor.

Returns:

Name of this filter, or null if this filter has no name.

getAgents

public List<String> getAgents()

Description copied from interface: AgentChannelsFilter

Returns a list of agent names accepted by this filter. The list returned by this method affects interpretation of channel selectors returned by getOriginChannels(): every selector that does not explicitly specify agent is only applied to agents from the list.

The default implementation returns null.

Returns:

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

getOriginChannels

public List<String> getOriginChannels()

Description copied from interface: AgentChannelsFilter

Returns a list of original channel selectors that might be accepted by this filter.

The list returned by this method may contain channel selectors of several types (note that interpretation of some selectors depends on the list returned by getAgents() method):

• Complete path.
• Path template in the "[agent]/[partial path][/]" format. Templates that omit the agent name are expanded against all agents whose names are in the getAgents() list (or all agents present on the buses if that list is null). Templates that end with "/" match all channels that start with "agent/partial path/".
• Arbitrary regular expression (to be matched against the entire original path).
• Attribute selector strings in the "[agent.name=value&][agent.type=value&][agent.key[=value]&…&agent.key[=value]&][key[=value]&…&key[=value]]" format, where key and value are names and values of agent properties or static channel attributes. If value is omitted, the existence of the attribute is checked.

The default implementation returns null.

Returns:

Original channel paths accepted by this filter, or null if any original path for which AgentChannelsFilter.getDisplayPaths(org.lsst.ccs.gconsole.services.aggregator.AgentChannel) returns a non-empty list is accepted.

getDisplayChannels

public List<String> getDisplayChannels()

Description copied from interface: AgentChannelsFilter

Returns a list of display paths produced by this filter. Typically, if this method returns a non-null list, components downstream from this filter will display this fixed set of channels, whether or not the data is actually available. If this method returns null, all display paths produced by getDisplayPaths(AgentChannel channel) for original channels accepted by getOriginChannels() should be displayed.

The default implementation returns null.

Returns:

Display paths produced by this filter, or null if the set of display paths is not constrained by this filter.

getFields

public List<String> getFields(boolean compact)

Description copied from interface: AgentChannelsFilter

Returns a list of attributes to display for each channel. The default implementation returns null.

Parameters:

compact - If true, returns a list of columns in a compact view.

Returns:

Display fields, or null if this filter does not provides any hints on what attributes should be displayed.

getGroups

public List<String> getGroups()

Description copied from interface: AgentChannelsFilter

Returns a list of groups of display paths produced by this filter. The default implementation returns null.

Returns:

Display groups, or null if the set of groups is not constrained by this filter.

getDisplayPaths

public List<String> getDisplayPaths(AgentChannel channel)

Description copied from interface: AgentChannelsFilter

Returns a list of display channels for the specified original channel. This method is called by clients that have access to original AgentChannel instances (like monitoring views).

Not that if the specified original channel is not accepted by this filter, this method should return an empty list. null should never be returned.

The default implementation returns a singleton list that contains a string returned by AgentChannelsFilter.getDisplayPath(AgentChannel) method.

Parameters:

channel - Original data channel.

Returns:

List of display channels.

getDisplayPaths

public List<String> getDisplayPaths(String originPath)

Description copied from interface: AgentChannelsFilter

Returns a list of display channels for the specified original path. This method is called by clients that do not have access to original AgentChannel instances (like the trending tool).

If the specified original channel is not accepted by this filter, this method should return an empty list. null should never be returned.

The default implementation returns a singleton list that contains a string returned by AgentChannelsFilter.getDisplayPath(String) method.

Parameters:

originPath - Original path.

Returns:

List of display channels.

getDisplayPath

public String getDisplayPath(AgentChannel channel)

Description copied from interface: AgentChannelsFilter

Returns the display path corresponding to the specified original channel. This method is used directly by clients that expect each original channel to be mapped to no more than one display path. It can also be overridden to define a path returned in a singleton list by If the original channel is mapped to multiple display paths, this method may return one of them, or null if the clients that rely on mapping to a single display path should ignore the specified channel.

The default implementation forwards the call to AgentChannelsFilter.getDisplayPath(String) method. Subclasses may override it to take into account channel attributes and metadata.

Parameters:

channel - Original data channel.

Returns:

Display path, or null if the provided channel is not accepted by this filter.

getDisplayPath

public String getDisplayPath(String originPath)

Description copied from interface: AgentChannelsFilter

Returns the display channel corresponding to the specified original path. If the original channel is mapped to multiple display paths, this method may return one of them, or null.

If the specified original channel is not accepted by this filter, this method should return an empty list. null should never be returned.

The default implementation returns an unmodified original path.

Parameters:

originPath - Original path.

Returns:

List of display channels.

getOriginPaths

public List<String> getOriginPaths(String displayPath)

Description copied from interface: AgentChannelsFilter

Returns the list of original paths mapped to the specified display channel.

The default implementation returns a list that contains one element - the path returned by getOriginPath(...) - or an empty list if getOriginPath(...) returns null.

Parameters:

displayPath - Display channel path.

Returns:

Original paths, or an empty list if the specified path does not correspond to any original channel.

getOriginPath

public String getOriginPath(String displayPath)

Description copied from interface: AgentChannelsFilter

Returns the original path corresponding to the specified display channel. If multiple original paths are mapped to the specified display path, this method may return one of them, or null.

The default implementation returns the display path provided as an argument.

Parameters:

displayPath - Display channel path.

Returns:

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