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

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.
Map<Counter.Type,List<Counter>>	getAllCountersByType() Returns a map of populated counters grouped by type, where each entry in the counters list represents a timing session.
List<Counter>	getCounters(Counter.Type type) Returns all counters associated with a given type in this monitored operation.
void	printDetails(PrintStream printStream) Prints detailed information about timing sessions in the specified print stream.
void	printDetails(PrintStream printStream, PrintStyle printStyle) Prints detailed information about timing sessions in the specified print stream, with a custom PrintStyle.
void	printSummary(PrintStream printStream) Prints summarized elapsed times in the specified print stream.
void	printSummary(PrintStream printStream, PrintStyle printStyle) Prints summarized elapsed times in the specified print stream, with a custom PrintStyle.
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

Method Detail

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 specified type was not assigned to the operation during instantiation

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 specified type was not assigned to the operation during instantiation

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 specified type was not assigned to the operation during instantiation

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 specified type was not assigned to the operation during instantiation

Since:

2.1.0

printSummary

public void printSummary(PrintStream printStream)

Prints summarized elapsed times in the specified print stream.

Parameters:

printStream - the print stream to which data will be sent

Throws:

NullPointerException - if the PrintStream is null

Since:

2.2.1

printSummary

public void printSummary(PrintStream printStream,
                         PrintStyle printStyle)

Prints summarized elapsed times in the specified print stream, with a custom PrintStyle.

Parameters:

printStream - the print stream to which data will be sent

printStyle - the PrintStyle to be applied

Throws:

NullPointerException - if the PrintStream is null

IllegalArgumentException - if the specified PrintStyle is not compatible with PrintFormat.SUMMARIZED

Since:

2.2.1

printDetails

public void printDetails(PrintStream printStream)

Prints detailed information about timing sessions in the specified print stream.

Parameters:

printStream - the print stream to which information will be sent

Throws:

NullPointerException - if the PrintStream is null

Since:

2.2.1

printDetails

public void printDetails(PrintStream printStream,
                         PrintStyle printStyle)

Prints detailed information about timing sessions in the specified print stream, with a custom PrintStyle.

Parameters:

printStream - the print stream to which information will be sent

printStyle - the PrintStyle to be applied

Throws:

NullPointerException - if the PrintStream is null

IllegalArgumentException - if the specified PrintStyle is not compatible with PrintFormat.DETAILED

Since:

2.2.1

getAllCountersByType

public Map<Counter.Type,List<Counter>> getAllCountersByType()

Returns a map of populated counters grouped by type, where each entry in the counters list represents a timing session.

Returns:

a map of populated counters grouped by type

Since:

2.2.1

reset

public void reset()

Cleans all counters available in this monitored operation.

Since:

2.2.0