net.obvj.performetrics.monitors

Class MonitoredCallable<V>

java.lang.Object

net.obvj.performetrics.monitors.MonitoredOperation

net.obvj.performetrics.monitors.MonitoredCallable<V>

Type Parameters:

V - the result type of method call

All Implemented Interfaces:

Callable<V>

public class MonitoredCallable<V>
extends MonitoredOperation
implements Callable<V>

A Callable wrapper that maintains one or more counters for monitoring the time spent by the Callable's call() method.

Specify a target Callable via constructor, then execute the call() method available in this wrapper. The target Callable's call() method will be executed and monitored. After the operation, call printSummary(System.out) or printDetails(System.out) to print the elapsed times to the system console or elapsedTime(Counter.Type), to retrieve the elapsed time duration for a particular counter. E.g.:

 double cpuTimeNanos = monitoredRunnable.elapsedTime(Counter.Type.CPU_TIME, TimeUnit.NANOSECONDS);
 

By default, all available counter types will be measured, if no specific counter types are passed to the constructor. If required, an additional constructor may be used to set up one or more specific counters to be maintained. E.g.:

 new MonitoredCallable(callable); // maintains all available counter types
 new MonitoredCallable(callable, Counter.Type.WALL_CLOCK_TIME); // wall-clock time only
 

For a list of available counters, refer to Counter.Type.

Note: This class is not thread-safe. In a multi-thread context, different instances must be created for each thread.

Author:

oswaldo.bapvic.jr

See Also:

Counter, Counter.Type

Constructor Summary

Constructors

Constructor and Description
MonitoredCallable(Callable<V> targetCallable) Builds this monitored operation with a given Callable.
MonitoredCallable(Callable<V> targetCallable, Counter.Type... types) Builds this monitored operation with a given Callable and one or more specific counter types to be maintained.

Method Summary

Modifier and Type	Method and Description
V	call() See Callable.call().

Methods inherited from class net.obvj.performetrics.monitors.MonitoredOperation

elapsedTime, elapsedTime, elapsedTime, getAllCountersByType, getCounters, printDetails, printDetails, printSummary, printSummary, reset

Methods inherited from class java.lang.Object

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

Constructor Detail

MonitoredCallable

public MonitoredCallable(Callable<V> targetCallable)

Builds this monitored operation with a given Callable. All available counter types will be maintained.

Parameters:

targetCallable - the Callable to be executed

MonitoredCallable

public MonitoredCallable(Callable<V> targetCallable,
                         Counter.Type... types)

Builds this monitored operation with a given Callable and one or more specific counter types to be maintained.

Parameters:

targetCallable - the Callable to be executed

types - the counter types to be maintained with the operation

Method Detail

call

public V call()
       throws Exception

See Callable.call().

Specified by:

call in interface Callable<V>

Throws:

Exception