org.javasimon.clock

Interface SimonClock

All Known Subinterfaces:

Manager

All Known Implementing Classes:

DisabledManager, EnabledManager, SwitchingManager, TestClock

public interface SimonClock

Interface for getting current time. By default SYSTEM is used to match System timers, but different implementation can be used to provide different time for Manager. This also allows easier testing without sleeping.

Since:

3.5

Author:

Ivan Mushketyk

Field Summary

Fields

Modifier and Type	Field and Description
static SimonClock	CPU Clock implementation measuring CPU time.
static long	MILLIS_IN_SECOND Number of milliseconds in one second.
static long	NANOS_IN_MILLIS Number of nanoseconds in one millisecond.
static long	NANOS_IN_SECOND Number of nanoseconds in one second.
static SimonClock	SYSTEM Default implementation using System.currentTimeMillis() and System.nanoTime().

Method Summary

Modifier and Type	Method and Description
long	millisForNano(long nanos) Converts nano timer value into millis timestamp compatible with milliTime() without actually using the timer.
long	milliTime() Gets current time in milliseconds.
long	nanoTime() Gets current time in nanoseconds.

Field Detail

MILLIS_IN_SECOND

static final long MILLIS_IN_SECOND

Number of milliseconds in one second.

See Also:

Constant Field Values

NANOS_IN_MILLIS

static final long NANOS_IN_MILLIS

Number of nanoseconds in one millisecond.

NANOS_IN_SECOND

static final long NANOS_IN_SECOND

Number of nanoseconds in one second.

SYSTEM

static final SimonClock SYSTEM

Default implementation using System.currentTimeMillis() and System.nanoTime().

CPU

static final SimonClock CPU

Clock implementation measuring CPU time.

Method Detail

nanoTime

long nanoTime()

Gets current time in nanoseconds.

Returns:

current time in nanoseconds

milliTime

long milliTime()

Gets current time in milliseconds.

Returns:

current time in milliseconds

millisForNano

long millisForNano(long nanos)

Converts nano timer value into millis timestamp compatible with milliTime() without actually using the timer. Method does not just divide nanos by one million, but also works with remembered values for milli- and nano-timers at one particular moment.

Parameters:

nanos - nano timer value

Returns:

ms timestamp

Since:

3.5 (before in SimonUtils since 3.3, before in SimonManager since 3.1)