net.anotheria.moskito.core.stats.impl

Class IntervalRegistry

java.lang.Object

net.anotheria.moskito.core.stats.impl.IntervalRegistry

public final class IntervalRegistry
extends java.lang.Object

This class implements a registry singleton to hold and create Interval instances.

Author:

lrosenberg

Method Summary

Modifier and Type	Method and Description
void	addIntervalRegistryListener(IntervalRegistryListener listener)
void	forceUpdateIntervalForTestingPurposes(java.lang.String intervalName)
static IntervalRegistry	getInstance() This is the Singleton instance accessor method.
Interval	getInterval(java.lang.String aName) This method retrieves an Interval with the given name.
Interval	getInterval(java.lang.String aName, int aLength) This method retrieves an Interval with the given name.
Interval	getIntervalOnlyIfExisting(java.lang.String aName) Same as getInterval(aName) except that it doesn't create an interval implicitely.
java.util.List<Interval>	getIntervals() This method returns a list containing all known Intervals.
java.lang.Long	getUpdateTimestamp(java.lang.String intervalName) Returns last update timestamp of an interval by name.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static IntervalRegistry getInstance()

This is the Singleton instance accessor method.

Returns:

the IntervalRegistry instance.

getInterval

public Interval getInterval(java.lang.String aName,
                            int aLength)

This method retrieves an Interval with the given name. If no one could be found it will create a new Interval with given name and length. TODO: This method should be renamed to "getOrCreateInterval" or something like that TODO: This method MUST be synchonrized to avoid doublicate Interval instances....

Parameters:

aName - the Interval name

aLength - the length of the new Interval in seconds.

Returns:

the existing Interval or a new Interval with given name and length

getInterval

public Interval getInterval(java.lang.String aName)

This method retrieves an Interval with the given name. If no one could be found it will create a new Interval with given name - the length will be a guess. TODO: This method should be renamed to "getOrCreateInterval" or something like that TODO: This method MUST be synchonrized to avoid double Interval instances....

Parameters:

aName - the Interval name

Returns:

the existing Interval or a new Interval with given name and guessed length

getIntervalOnlyIfExisting

public Interval getIntervalOnlyIfExisting(java.lang.String aName)

Same as getInterval(aName) except that it doesn't create an interval implicitely. This method should be used, when you do not want an implicit creation, for example with tieables (thresholds, accumulators).

Parameters:

aName - name of the interval.

Returns:

interval if existing.

Throws:

UnknownIntervalException - if no such interval exists.

getIntervals

public java.util.List<Interval> getIntervals()

This method returns a list containing all known Intervals.

Returns:

the Interval list

getUpdateTimestamp

public java.lang.Long getUpdateTimestamp(java.lang.String intervalName)

Returns last update timestamp of an interval by name.

Parameters:

intervalName - name of the interval.

Returns:

returns the timestamp in milliseconds since 1970 for the interval update.

forceUpdateIntervalForTestingPurposes

public void forceUpdateIntervalForTestingPurposes(java.lang.String intervalName)

addIntervalRegistryListener

public void addIntervalRegistryListener(IntervalRegistryListener listener)