org.lsst.ccs.gconsole.plugins.monitor

Class AbstractMonitorView1

java.lang.Object

org.lsst.ccs.gconsole.plugins.monitor.AbstractMonitorView1

All Implemented Interfaces:

AgentStatusListener, MonitorView

Direct Known Subclasses:

AbstractMonitorView2, CompoundView, ConfigView, TabbedView

public abstract class AbstractMonitorView1
extends Object
implements MonitorView

Adapter class that simplifies implementing monitor views.

Concrete classes extending AbstractMonitorView1 should not, in general, override implementations of the AgentStatusListener interface methods provided by this adapter. Instead, they should implement:

• connect(AgentInfo)
• disconnect(AgentInfo)
• addChannels(AgentInfo agent, Map)
• removeChannels(AgentInfo, List)
• updateChannels(AgentInfo, Map)

Additionally, they may implement or override any MonitorView methods that are not a part of AgentStatusListener interface. All these methods are called on the EDT.

Author:

onoprien

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractMonitorView1.Descriptor JavaBean that contains information required to re-create this view in its current state.

Field Summary

Fields

Modifier and Type	Field and Description
protected AbstractMonitorView1.Descriptor	descriptor
protected AgentChannelsFilter	filter

Constructor Summary

Constructors

Constructor and Description
AbstractMonitorView1()

Method Summary

Modifier and Type	Method and Description
protected abstract void	addChannels(org.lsst.ccs.bus.data.AgentInfo agent, Map<String,AgentChannel> channels) Adds channels to display.
void	configure(AgentStatusEvent event) Called when the complete static information on the source agent (including channels dictionary) becomes available for the first time, and when it changes.
protected void	connect(org.lsst.ccs.bus.data.AgentInfo agent)
void	connect(AgentStatusEvent event) Called when a new agent connects to the buses.
protected void	disconnect(org.lsst.ccs.bus.data.AgentInfo agent)
void	disconnect(AgentStatusEvent event) Called when an agent disconnects from the buses or goes into OFFLINE state.
protected AbstractMonitorView1.Descriptor	getDescriptor() Returns a reference to the descriptor maintained by this view.
AgentChannelsFilter	getFilter() Returns the filter associated with this view, or null if there is none.
protected boolean	isChannelListFixed()
protected abstract void	removeChannels(org.lsst.ccs.bus.data.AgentInfo agent, List<String> paths) Removes a channels from this view.
void	restore(MonitorView.Descriptor descriptor) Restores this view to the state described by the provided descriptor, to the extent possible.
AbstractMonitorView1.Descriptor	save() Returns a descriptor that contains information required to re-create this view in its current state.
void	setFilter(AgentChannelsFilter filter) Sets the channels filter to be used by this view.
void	statusChanged(AgentStatusEvent event) Called on status change.
protected abstract void	updateChannels(org.lsst.ccs.bus.data.AgentInfo agent, Map<String,Map.Entry<AgentChannel,List<String>>> channels) Called to notify this view that the specified channels have been updated.

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.plugins.monitor.MonitorView

getName, getPanel, install, isEmpty, setName, uninstall

Field Detail

filter

protected AgentChannelsFilter filter

descriptor

protected AbstractMonitorView1.Descriptor descriptor

Constructor Detail

AbstractMonitorView1

public AbstractMonitorView1()

Method Detail

getFilter

public AgentChannelsFilter getFilter()

Description copied from interface: MonitorView

Returns the filter associated with this view, or null if there is none.

Specified by:

getFilter in interface MonitorView

Returns:

Channels filter.

setFilter

public void setFilter(AgentChannelsFilter filter)

Description copied from interface: MonitorView

Sets the channels filter to be used by this view. The filter determines what channels are displayed by this view, and how they are displayed.

Specified by:

setFilter in interface MonitorView

Parameters:

filter - Filter to be associated with this view.

isChannelListFixed

protected boolean isChannelListFixed()

connect

public void connect(AgentStatusEvent event)

Description copied from interface: AgentStatusListener

Called when a new agent connects to the buses. Newly registered listeners are notified immediately if the agent is already connected.

The event passed to this method does not contain any information on channels (corresponding methods return empty collections) or a reference to a status message. The event can only be used to retrieve AgentInfo descriptor and a reference to the AgentStatusAggregator instance.

The implementation should return quickly. Any blocking operations should be scheduled on a separate thread.

Specified by:

connect in interface AgentStatusListener

Parameters:

event - Event.

configure

public void configure(AgentStatusEvent event)

Description copied from interface: AgentStatusListener

Called when the complete static information on the source agent (including channels dictionary) becomes available for the first time, and when it changes. Newly registered listeners are notified immediately if the information is already available.

The event passed to this method contains a list of added channels. Methods accessing lists of changed and removed channels will return empty collections. Since the configuration event is not necessarily triggered by a status message, getMessage() method returns null.

Specified by:

configure in interface AgentStatusListener

Parameters:

event - Event.

statusChanged

public void statusChanged(AgentStatusEvent event)

Description copied from interface: AgentStatusListener

Called on status change.

Specified by:

statusChanged in interface AgentStatusListener

Parameters:

event - event Event.

disconnect

public void disconnect(AgentStatusEvent event)

Description copied from interface: AgentStatusListener

Called when an agent disconnects from the buses or goes into OFFLINE state.

The event passed to this method does not contain any information on channels status - corresponding methods return empty collections. Since the disconnection event might or might not be triggered by a status message, getMessage() method might return null.

The implementation should return quickly. Any blocking operations should be scheduled on a separate thread.

Specified by:

disconnect in interface AgentStatusListener

Parameters:

event - Event.

connect

protected void connect(org.lsst.ccs.bus.data.AgentInfo agent)

disconnect

protected void disconnect(org.lsst.ccs.bus.data.AgentInfo agent)

addChannels

protected abstract void addChannels(org.lsst.ccs.bus.data.AgentInfo agent,
                                    Map<String,AgentChannel> channels)

Adds channels to display.

Parameters:

agent - Source agent.

channels - Map of display paths to channels.

removeChannels

protected abstract void removeChannels(org.lsst.ccs.bus.data.AgentInfo agent,
                                       List<String> paths)

Removes a channels from this view.

Parameters:

agent - Source agent.

paths - Display paths to remove.

updateChannels

protected abstract void updateChannels(org.lsst.ccs.bus.data.AgentInfo agent,
                                       Map<String,Map.Entry<AgentChannel,List<String>>> channels)

Called to notify this view that the specified channels have been updated.

Parameters:

agent - Source agent.

channels - Map of display paths to key-value pairs, where the key is as AgentChannel object and the value is a list of changed attributes.

save

public AbstractMonitorView1.Descriptor save()

Returns a descriptor that contains information required to re-create this view in its current state. The implementation provided by this class returns the descriptor previously set with restore(...).

Specified by:

save in interface MonitorView

Returns:

View descriptor, or null is this view does not support saving.

restore

public void restore(MonitorView.Descriptor descriptor)

Restores this view to the state described by the provided descriptor, to the extent possible. The implementation provided by this class stores the provided descriptor, so that it can be retrieved with save() later.

Specified by:

restore in interface MonitorView

Parameters:

descriptor - View descriptor.

getDescriptor

protected AbstractMonitorView1.Descriptor getDescriptor()

Returns a reference to the descriptor maintained by this view. This is a convenience method intended to be overridden by subclasses to return an appropriate subtype of AbstractMonitorView.Descriptor.

Returns:

Descriptor maintained by this view.