org.eclipse.jgit.util

Class CPUTimeStopWatch

java.lang.Object

org.eclipse.jgit.util.CPUTimeStopWatch

public class CPUTimeStopWatch
extends Object

A simple stopwatch which measures elapsed CPU time of the current thread. CPU time is the time spent on executing your own code plus the time spent on executing operating system calls triggered by your application.

This stopwatch needs a VM which supports getting CPU Time information for the current thread. The static method createInstance() will take care to return only a new instance of this class if the VM is capable of returning CPU time.

Constructor Summary

Constructors

Constructor and Description
CPUTimeStopWatch()

Method Summary

Modifier and Type	Method and Description
static CPUTimeStopWatch	createInstance() use this method instead of the constructor to be sure that the underlying VM provides all features needed by this class.
long	readout() Return the elapsed CPU time in nanoseconds.
void	start() Starts the stopwatch.
long	stop() Stops the stopwatch and return the elapsed CPU time in nanoseconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

CPUTimeStopWatch

public CPUTimeStopWatch()

Method Detail

createInstance

public static CPUTimeStopWatch createInstance()

use this method instead of the constructor to be sure that the underlying VM provides all features needed by this class.

Returns:

a new instance of CPUTimeStopWatch() or null if the VM does not support getting CPU time information

start

public void start()

Starts the stopwatch. If the stopwatch is already started this will restart the stopwatch.

stop

public long stop()

Stops the stopwatch and return the elapsed CPU time in nanoseconds. Should be called only on started stopwatches.

Returns:

the elapsed CPU time in nanoseconds. When called on non-started stopwatches (either because start() was never called or stop() was called after the last call to start()) this method will return 0.

readout

public long readout()

Return the elapsed CPU time in nanoseconds. In contrast to stop() the stopwatch will continue to run after this call.

Returns:

the elapsed CPU time in nanoseconds. When called on non-started stopwatches (either because start() was never called or stop() was called after the last call to start()) this method will return 0.