net.obvj.performetrics.monitors

Class MonitoredOperation

java.lang.Object

net.obvj.performetrics.monitors.MonitoredOperation

Direct Known Subclasses:

MonitoredCallable, MonitoredRunnable

public abstract class MonitoredOperation
extends Object

A base object for monitorable operations that maintains one or more counters.

Author:

oswaldo.bapvic.jr

Constructor Summary

Constructors

Constructor and Description
MonitoredOperation(Counter.Type... types) Builds a monitored operation with the specified type(s).

Method Summary

Modifier and Type	Method and Description
Duration	elapsedTime(Counter.Type type) Returns the total elapsed time of a specific counter type.
double	elapsedTime(Counter.Type type, TimeUnit timeUnit) Returns the total elapsed time of a specific counter type, in the specified time unit.
double	elapsedTime(Counter.Type type, TimeUnit timeUnit, ConversionMode conversionMode) Returns the total elapsed time of a specific counter, in the specified time unit, with a custom ConversionMode applied.
List<Counter>	getCounters() Returns all counters available in this monitored operation.
List<Counter>	getCounters(Counter.Type type) Returns all counters associated with a given type in this monitored operation.
void	printStatistics(PrintStream printStream) Prints operation statistics in the specified print stream.
void	printStatistics(PrintStream printStream, TimeUnit timeUnit) Prints operation statistics in the specified print stream, with a custom time unit.
void	reset() Cleans all counters available in this monitored operation.

Methods inherited from class java.lang.Object

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

Constructor Detail

MonitoredOperation

public MonitoredOperation(Counter.Type... types)

Builds a monitored operation with the specified type(s).

Parameters:

types - the counter type(s) to be maintained by this operation

Method Detail

getCounters

public List<Counter> getCounters()

Returns all counters available in this monitored operation.

Returns:

all counters available in this monitored operation.

getCounters

public List<Counter> getCounters(Counter.Type type)

Returns all counters associated with a given type in this monitored operation.

Parameters:

type - the counter type to be fetched

Returns:

all counters associated with the given type

Throws:

IllegalArgumentException - if the type was not specified in this operation

elapsedTime

public Duration elapsedTime(Counter.Type type)

Returns the total elapsed time of a specific counter type.

Parameters:

type - the counter type to be fetched

Returns:

the total elapsed time for the specified counter

Throws:

IllegalArgumentException - if the type was not specified in this operation

Since:

2.1.0

elapsedTime

public double elapsedTime(Counter.Type type,
                          TimeUnit timeUnit)

Returns the total elapsed time of a specific counter type, in the specified time unit.

Parameters:

type - the counter type to be fetched

timeUnit - the time unit to which the elapsed time will be converted

Returns:

the elapsed time for the specified counter, converted to the given time unit using the default conversion mode.

Throws:

IllegalArgumentException - if the type was not specified in this operation

Since:

2.1.0

elapsedTime

public double elapsedTime(Counter.Type type,
                          TimeUnit timeUnit,
                          ConversionMode conversionMode)

Returns the total elapsed time of a specific counter, in the specified time unit, with a custom ConversionMode applied.

Parameters:

type - the counter type to be fetched

timeUnit - the time unit to which the elapsed time will be converted

conversionMode - the ConversionMode to be applied

Returns:

the elapsed time for the specified counter, converted to the given time unit using the given conversion mode.

Throws:

IllegalArgumentException - if the type was not specified in this operation

Since:

2.1.0

printStatistics

public void printStatistics(PrintStream printStream)

Prints operation statistics in the specified print stream.

Parameters:

printStream - the print stream to which statistics will be sent

printStatistics

public void printStatistics(PrintStream printStream,
                            TimeUnit timeUnit)

Prints operation statistics in the specified print stream, with a custom time unit.

Parameters:

printStream - the print stream to which statistics will be sent

timeUnit - the time unit for the elapsed times to be displayed

reset

public void reset()

Cleans all counters available in this monitored operation.

Since:

2.2.0