Package com.google.common.base
Class Stopwatch
- java.lang.Object
-
- com.google.common.base.Stopwatch
-
@Beta @GwtCompatible(emulated=true) @Deprecated(since="2022-12-01") public final class Stopwatch extends java.lang.Object
Deprecated.The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023An object that measures elapsed time in nanoseconds. It is useful to measure elapsed time using this class instead of direct calls toSystem.nanoTime()
for a few reasons:- An alternate time source can be substituted, for testing or performance reasons.
- As documented by
nanoTime
, the value returned has no absolute meaning, and can only be interpreted as relative to another timestamp returned bynanoTime
at a different time.Stopwatch
is a more effective abstraction because it exposes only these relative values, not the absolute ones.
Basic usage:
Stopwatch stopwatch = Stopwatch.
createStarted
(); doSomething(); stopwatch.stop
(); // optional long millis = stopwatch.elapsed(MILLISECONDS); log.info("time: " + stopwatch); // formatted string like "12.3 ms"Stopwatch methods are not idempotent; it is an error to start or stop a stopwatch that is already in the desired state.
When testing code that uses this class, use
createUnstarted(Ticker)
orcreateStarted(Ticker)
to supply a fake or mock ticker. This allows you to simulate any valid behavior of the stopwatch.Note: This class is not thread-safe.
- Since:
- 10.0
-
-
Constructor Summary
Constructors Constructor Description Stopwatch()
Deprecated.UsecreateUnstarted()
instead.Stopwatch(Ticker ticker)
Deprecated.UsecreateUnstarted(Ticker)
instead.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static Stopwatch
createStarted()
Deprecated.Creates (and starts) a new stopwatch usingSystem.nanoTime()
as its time source.static Stopwatch
createStarted(Ticker ticker)
Deprecated.Creates (and starts) a new stopwatch, using the specified time source.static Stopwatch
createUnstarted()
Deprecated.Creates (but does not start) a new stopwatch usingSystem.nanoTime()
as its time source.static Stopwatch
createUnstarted(Ticker ticker)
Deprecated.Creates (but does not start) a new stopwatch, using the specified time source.long
elapsed(java.util.concurrent.TimeUnit desiredUnit)
Deprecated.Returns the current elapsed time shown on this stopwatch, expressed in the desired time unit, with any fraction rounded down.long
elapsedMillis()
Deprecated.Usestopwatch.elapsed(MILLISECONDS)
instead.long
elapsedTime(java.util.concurrent.TimeUnit desiredUnit)
Deprecated.Useelapsed(TimeUnit)
instead.boolean
isRunning()
Deprecated.Stopwatch
reset()
Deprecated.Sets the elapsed time for this stopwatch to zero, and places it in a stopped state.Stopwatch
start()
Deprecated.Starts the stopwatch.Stopwatch
stop()
Deprecated.Stops the stopwatch.java.lang.String
toString()
Deprecated.Returns a string representation of the current elapsed time.
-
-
-
Constructor Detail
-
Stopwatch
@Deprecated public Stopwatch()
Deprecated.UsecreateUnstarted()
instead. This constructor is scheduled to be removed in Guava release 17.0.Creates (but does not start) a new stopwatch usingSystem.nanoTime()
as its time source.
-
Stopwatch
@Deprecated public Stopwatch(Ticker ticker)
Deprecated.UsecreateUnstarted(Ticker)
instead. This constructor is scheduled to be removed in Guava release 17.0.Creates (but does not start) a new stopwatch, using the specified time source.
-
-
Method Detail
-
createUnstarted
public static Stopwatch createUnstarted()
Deprecated.Creates (but does not start) a new stopwatch usingSystem.nanoTime()
as its time source.- Since:
- 15.0
-
createUnstarted
public static Stopwatch createUnstarted(Ticker ticker)
Deprecated.Creates (but does not start) a new stopwatch, using the specified time source.- Since:
- 15.0
-
createStarted
public static Stopwatch createStarted()
Deprecated.Creates (and starts) a new stopwatch usingSystem.nanoTime()
as its time source.- Since:
- 15.0
-
createStarted
public static Stopwatch createStarted(Ticker ticker)
Deprecated.Creates (and starts) a new stopwatch, using the specified time source.- Since:
- 15.0
-
isRunning
public boolean isRunning()
Deprecated.
-
start
public Stopwatch start()
Deprecated.Starts the stopwatch.- Returns:
- this
Stopwatch
instance - Throws:
java.lang.IllegalStateException
- if the stopwatch is already running.
-
stop
public Stopwatch stop()
Deprecated.Stops the stopwatch. Future reads will return the fixed duration that had elapsed up to this point.- Returns:
- this
Stopwatch
instance - Throws:
java.lang.IllegalStateException
- if the stopwatch is already stopped.
-
reset
public Stopwatch reset()
Deprecated.Sets the elapsed time for this stopwatch to zero, and places it in a stopped state.- Returns:
- this
Stopwatch
instance
-
elapsed
public long elapsed(java.util.concurrent.TimeUnit desiredUnit)
Deprecated.Returns the current elapsed time shown on this stopwatch, expressed in the desired time unit, with any fraction rounded down.Note that the overhead of measurement can be more than a microsecond, so it is generally not useful to specify
TimeUnit.NANOSECONDS
precision here.- Since:
- 14.0 (since 10.0 as
elapsedTime()
)
-
elapsedTime
@Deprecated public long elapsedTime(java.util.concurrent.TimeUnit desiredUnit)
Deprecated.Useelapsed(TimeUnit)
instead. This method is scheduled to be removed in Guava release 16.0.Returns the current elapsed time shown on this stopwatch, expressed in the desired time unit, with any fraction rounded down.Note that the overhead of measurement can be more than a microsecond, so it is generally not useful to specify
TimeUnit.NANOSECONDS
precision here.
-
elapsedMillis
@Deprecated public long elapsedMillis()
Deprecated.Usestopwatch.elapsed(MILLISECONDS)
instead. This method is scheduled to be removed in Guava release 16.0.Returns the current elapsed time shown on this stopwatch, expressed in milliseconds, with any fraction rounded down. This is identical toelapsed(TimeUnit.MILLISECONDS)
.
-
toString
@GwtIncompatible("String.format()") public java.lang.String toString()
Deprecated.Returns a string representation of the current elapsed time.- Overrides:
toString
in classjava.lang.Object
-
-