org.lsst.ccs.gconsole.plugins.trending

Class RestSource

java.lang.Object

org.lsst.ccs.gconsole.plugins.trending.RestSource

public class RestSource
extends Object

Source of trending data based on a REST server. Provides getters for retrieving the list of known trending channels and the data for specified channels. Public methods of this class can be called on any thread.

This sources watches for external events that can change the list of known channels, and notifies listeners on EDT when this happens.

Author:

onoprien

Field Summary

Fields

Modifier and Type	Field and Description
static String	VALUE_KEY

Method Summary

Modifier and Type	Method and Description
void	addListener(ChangeListener listener) Registers a listener to be notified if the list of channels available from this trending source changes.
protected void	fireEvent() Notifies listeners of changes in this source.
ArrayList<TrendData>	get(List<Trend> trends, long begin, long end, Boolean raw, Integer nBins) Retrieves from the REST server and processes historical data for the specified trending channel.
List<String>	getChannels() Returns the list of known data channel paths.
void	refresh() Triggers refreshing of the list of channels by retrieving them from the REST server.
void	removeAllListeners() Removes all listeners.
void	removeListener(ChangeListener listener) Removes a listener.

Methods inherited from class java.lang.Object

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

Field Detail

VALUE_KEY

public static final String VALUE_KEY

See Also:

Constant Field Values

Method Detail

refresh

public void refresh()

Triggers refreshing of the list of channels by retrieving them from the REST server. Returns immediately without waiting for the refreshing to complete.

addListener

public void addListener(ChangeListener listener)

Registers a listener to be notified if the list of channels available from this trending source changes. This method can be called on any thread. The listeners are notified on the EDT.

Parameters:

listener - Listener to be added.

removeListener

public void removeListener(ChangeListener listener)

Removes a listener.

Parameters:

listener - Listener to be removed.

removeAllListeners

public void removeAllListeners()

Removes all listeners.

fireEvent

protected void fireEvent()

Notifies listeners of changes in this source. Can be called on any thread. Listeners are notified on EDT.

getChannels

public List<String> getChannels()

Returns the list of known data channel paths. Calling this method does not retrieve data from the REST server, the returned list reflects the result of the last refresh.

Returns:

List of channel paths.

get

public ArrayList<TrendData> get(List<Trend> trends,
                                long begin,
                                long end,
                                Boolean raw,
                                Integer nBins)

Retrieves from the REST server and processes historical data for the specified trending channel. If the supplied trends contain previously retrieved data, some of that data can be re-used, reducing the amount of data that needs to be retrieved from the REST server. This method blocks until all requested data have been received.

Parameters:

trends - List of trends for which the data has to be retrieved.

begin - Beginning of time window.

end - End of time window

raw - TRUE or FALSE depending on whether raw or statistical data should be retrieved; if null, current application preferences will be consulted.

nBins - Approximate desired number of bins in the resulting dataset; if null, current application preferences will be consulted.

Returns:

List of newly created datasets, in the trends order. Note that this list will never be null, but individual elements can be null if data retrieval for corresponding trends fails for any reason.