ca.uhn.fhir.util

Class StopWatch

java.lang.Object

ca.uhn.fhir.util.StopWatch

public class StopWatch
extends Object

A multipurpose stopwatch which can be used to time tasks and produce human readable output about task duration, throughput, estimated task completion, etc.

Thread Safety Note: StopWatch is not intended to be thread safe.

Since:

HAPI FHIR 3.3.0

Constructor Summary

Constructors

Constructor and Description
StopWatch() Constructor
StopWatch(Date theStart) Constructor

Method Summary

Modifier and Type	Method and Description
void	endCurrentTask() Finish the counter on the current task (which was started by calling startTask(String).
static String	formatMillis(long val) Formats a number of milliseconds for display (e.g.
String	formatTaskDurations() Returns a string providing the durations of all tasks collected by startTask(String)
String	formatThroughput(int theNumOperations, TimeUnit theUnit) Determine the current throughput per unit of time (specified in theUnit) assuming that theNumOperations operations have happened.
String	getEstimatedTimeRemaining(double theCompleteToDate, double theTotal) Given an amount of something completed so far, and a total amount, calculates how long it will take for something to complete
long	getMillis()
long	getMillis(Date theNow)
long	getMillisAndRestart()
int	getMillisPerOperation(int theNumOperations)
Date	getStartedDate()
double	getThroughput(int theNumOperations, TimeUnit theUnit) Determine the current throughput per unit of time (specified in theUnit) assuming that theNumOperations operations have happened.
void	restart()
void	startTask(String theTaskName) Starts a counter for a sub-task
String	toString() Formats value in an appropriate format.

Methods inherited from class java.lang.Object

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

Constructor Detail

StopWatch

public StopWatch()

Constructor

StopWatch

public StopWatch(Date theStart)

Constructor

Parameters:

theStart - The time to record as the start for this timer

Method Detail

endCurrentTask

public void endCurrentTask()

Finish the counter on the current task (which was started by calling startTask(String). This method has no effect if no task is currently started so it's ok to call it more than once.

formatTaskDurations

public String formatTaskDurations()

Returns a string providing the durations of all tasks collected by startTask(String)

formatThroughput

public String formatThroughput(int theNumOperations,
                               TimeUnit theUnit)

Determine the current throughput per unit of time (specified in theUnit) assuming that theNumOperations operations have happened.

For example, if this stopwatch has 2 seconds elapsed, and this method is called for theNumOperations=30 and TimeUnit=SECONDS, this method will return 15

See Also:

getThroughput(int, TimeUnit)

getEstimatedTimeRemaining

public String getEstimatedTimeRemaining(double theCompleteToDate,
                                        double theTotal)

Given an amount of something completed so far, and a total amount, calculates how long it will take for something to complete

Parameters:

theCompleteToDate - The amount so far

theTotal - The total (must be higher than theCompleteToDate

Returns:

A formatted amount of time

getMillis

public long getMillis(Date theNow)

getMillis

public long getMillis()

getMillisAndRestart

public long getMillisAndRestart()

getMillisPerOperation

public int getMillisPerOperation(int theNumOperations)

Parameters:

theNumOperations - Ok for this to be 0, it will be treated as 1

getStartedDate

public Date getStartedDate()

getThroughput

public double getThroughput(int theNumOperations,
                            TimeUnit theUnit)

Determine the current throughput per unit of time (specified in theUnit) assuming that theNumOperations operations have happened.

For example, if this stopwatch has 2 seconds elapsed, and this method is called for theNumOperations=30 and TimeUnit=SECONDS, this method will return 15

See Also:

formatThroughput(int, TimeUnit)

restart

public void restart()

startTask

public void startTask(String theTaskName)

Starts a counter for a sub-task

Thread Safety Note: This method is not threadsafe! Do not use subtasks in a multithreaded environment.

Parameters:

theTaskName - Note that if theTaskName is blank or empty, no task is started

toString

public String toString()

Formats value in an appropriate format. See formatMillis(long)} for a description of the format

Overrides:

toString in class Object

See Also:

formatMillis(long)

formatMillis

public static String formatMillis(long val)

Formats a number of milliseconds for display (e.g. in a log file), tailoring the output to how big the value actually is.

Example outputs:

• 133ms
• 00:00:10.223
• 1.7 days
• 64 days