de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies

Class TimerInfo

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.TimerInfo

public class TimerInfo
extends java.lang.Object

Stores information about a (user-defined) timer. This class represents a simple state machine for handling internal timer events caused by instrumenting code according to the NotifyTimer annotation.

Since:

1.00

Version:

1.00

Author:

Holger Eichelberger

Field Summary

Fields

Modifier and Type	Field and Description
private long	start Stores the start time of the timer (in milliseconds).
private TimerState	state Stores the current state of the timer.
private long	value Stores the (incrementally aggreagted) value of the timer.

Constructor Summary

Constructors

Constructor and Description
TimerInfo(long start) Creates a new timer info and initializes it as if the timer was started at the given point of time.

Method Summary

Modifier and Type	Method and Description
long	getValue() Returns the current (incrementally aggregated) value.
boolean	handleState(TimerState state, long now) Handles a state change to the given state at the given point of time now.
boolean	isActive() Returns if the timer is active (started or resumed).
boolean	isStopped() Returns if the timer is stopped.
private void	start(long start) Initializes the timer as if it was started at the given point of time.

Methods inherited from class java.lang.Object

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

Field Detail

start

private long start

Stores the start time of the timer (in milliseconds).

value

private long value

Stores the (incrementally aggreagted) value of the timer.

state

private TimerState state

Stores the current state of the timer.

Constructor Detail

TimerInfo

public TimerInfo(long start)

Creates a new timer info and initializes it as if the timer was started at the given point of time.

Parameters:

start - the start point of time (in milliseconds)

Since:

1.00

Method Detail

start

private void start(long start)

Initializes the timer as if it was started at the given point of time.

Parameters:

start - the start point of time (in milliseconds)

Since:

1.00

getValue

public long getValue()

Returns the current (incrementally aggregated) value. This value represents the sum of all stop-resume events or (if no stop occurred) the entire timer period.

Returns:

the current value of the timer, 0 if not finished and not stopped so far

Since:

1.00

handleState

public boolean handleState(TimerState state,
                           long now)

Handles a state change to the given state at the given point of time now.

Parameters:

state - the new state

now - the current time in milliseconds

Returns:

true if the timer is finished and observers should be notified, false else

Since:

1.00

isActive

public final boolean isActive()

Returns if the timer is active (started or resumed).

Returns:

true if the timer is active, false if the timer is in another state

Since:

1.00

isStopped

public final boolean isStopped()

Returns if the timer is stopped.

Returns:

true if the timer is stopped, false if the timer is in another state

Since:

1.00