eu.chargetime.ocpp.utilities

Class Stopwatch

java.lang.Object

eu.chargetime.ocpp.utilities.Stopwatch

public final class Stopwatch
extends Object

Stopwatch implementation. Cut version from Guava (needed to minimize dependency tree for client).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Stopwatch.Ticker

Constructor Summary

Constructors

Constructor and Description
Stopwatch(Stopwatch.Ticker ticker)

Method Summary

Modifier and Type	Method and Description
static Stopwatch	createStarted() Creates (and starts) a new stopwatch using System.nanoTime() as its time source.
static Stopwatch	createUnstarted() Creates (but does not start) a new stopwatch using System.nanoTime() as its time source.
java.time.Duration	elapsed() Returns the current elapsed time shown on this stopwatch as a Duration.
long	elapsed(TimeUnit desiredUnit) Returns the current elapsed time shown on this stopwatch, expressed in the desired time unit, with any fraction rounded down.
boolean	isRunning() Returns true if start() has been called on this stopwatch, and stop() has not been called since the last call to start().
Stopwatch	reset() Sets the elapsed time for this stopwatch to zero, and places it in a stopped state.
Stopwatch	start() Starts the stopwatch.
Stopwatch	stop() Stops the stopwatch.
String	toString() Returns a string representation of the current elapsed time.

Methods inherited from class java.lang.Object

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

Constructor Detail

Stopwatch

public Stopwatch(Stopwatch.Ticker ticker)

Method Detail

createUnstarted

public static Stopwatch createUnstarted()

Creates (but does not start) a new stopwatch using System.nanoTime() as its time source.

createStarted

public static Stopwatch createStarted()

Creates (and starts) a new stopwatch using System.nanoTime() as its time source.

isRunning

public boolean isRunning()

Returns true if start() has been called on this stopwatch, and stop() has not been called since the last call to start().

start

public Stopwatch start()

Starts the stopwatch.

Returns:

this Stopwatch instance

Throws:

IllegalStateException - if the stopwatch is already running.

stop

public Stopwatch stop()

Stops the stopwatch. Future reads will return the fixed duration that had elapsed up to this point.

Returns:

this Stopwatch instance

Throws:

IllegalStateException - if the stopwatch is already stopped.

reset

public Stopwatch reset()

Sets the elapsed time for this stopwatch to zero, and places it in a stopped state.

Returns:

this Stopwatch instance

elapsed

public long elapsed(TimeUnit desiredUnit)

Returns the current elapsed time shown on this stopwatch, expressed in the desired time unit, with any fraction rounded down.

Note: the overhead of measurement can be more than a microsecond, so it is generally not useful to specify TimeUnit.NANOSECONDS precision here.

It is generally not a good idea to use an ambiguous, unitless long to represent elapsed time. Therefore, we recommend using elapsed() instead, which returns a strongly-typed Duration instance.

elapsed

public java.time.Duration elapsed()

Returns the current elapsed time shown on this stopwatch as a Duration. Unlike elapsed(TimeUnit), this method does not lose any precision due to rounding.

toString

public String toString()

Returns a string representation of the current elapsed time.

Overrides:

toString in class Object