Fork of the Fernflower decompiler
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
fernflower/timer/com/vladium/utils/timing/ITimer.java

55 lines
2.0 KiB

11 years ago
package com.vladium.utils.timing;
// ----------------------------------------------------------------------------
/**
* A simple interface for measuring time intervals. An instance of this goes
* through the following lifecycle states:
* <DL>
* <DT> <EM>ready</EM>
* <DD> timer is ready to start a new measurement
* <DT> <EM>started</EM>
* <DD> timer has recorded the starting time interval point
* <DT> <EM>stopped</EM>
* <DD> timer has recorded the ending time interval point
* </DL>
* See individual methods for details.<P>
*
* If this library has been compiled with {@link ITimerConstants#DO_STATE_CHECKS}
* set to 'true' the implementation will enforce this lifecycle model and throw
* IllegalStateException when it is violated.
*
* @author (C) <a href="mailto:vroubtsov@illinoisalumni.org">Vlad Roubtsov</a>, 2002
*/
public interface ITimer
{
// public: ................................................................
/**
* Starts a new time interval and advances this timer instance to 'started'
* state. This method can be called from 'ready' state only. */
void start ();
/**
* Terminates the current time interval and advances this timer instance to
* 'stopped' state. Interval duration will be available via
* {@link #getDuration()} method. This method can be called from 'started'
* state only. */
void stop ();
/**
* Returns the duration of the time interval that elapsed between the last
* calls to {@link #start()} and {@link #stop()}. This method can be called
* any number of times from 'stopped' state and will return the same value
* each time.<P>
* * @return interval duration in milliseconds */
double getDuration ();
/**
* This method can be called from any state and will reset this timer
* instance back to 'ready' state. */
void reset ();
} // end of interface
// ----------------------------------------------------------------------------