com.nsysmon.measure

Class ACollectingMeasurement

java.lang.Object

com.nsysmon.measure.ACollectingMeasurement

All Implemented Interfaces:

AWithParameters

public class ACollectingMeasurement
extends Object
implements AWithParameters

This is a measurement that aggregates several - potentially many - measurements in a single object. It is intended for situations that have interesting details but do not warrant full-blown child measurements.

A typical example of this is iterating over a JDBC ResultSet: calling 'next()' on the ResultSet may take significant time, and measuring that time can be of interest. It is however often sufficient to measure the total time used up by iterating over the ResultSet.

Author:

arno

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ACollectingMeasurement.Detail

Method Summary

Modifier and Type	Method and Description
void	addDetailMeasurement(String detailIdentifier, long durationNanos)
void	addParameter(String identifier, String value)
<R,E extends Exception> R	detail(String detailIdentifier, AMeasureCallback<R,E> callback)
void	finish()
void	finishDetail()
Map<String,ACollectingMeasurement.Detail>	getDetails()
String	getIdentifier()
Map<String,String>	getParameters()
long	getStartTimeMillis()
long	getTotalDurationNanos()
boolean	isFinished()
boolean	isSerial()
void	startDetail(String detailIdentifier)

Methods inherited from class java.lang.Object

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

Method Detail

isSerial

public boolean isSerial()

getStartTimeMillis

public long getStartTimeMillis()

getIdentifier

public String getIdentifier()

addParameter

public void addParameter(String identifier,
                         String value)

Specified by:

addParameter in interface AWithParameters

getParameters

public Map<String,String> getParameters()

getDetails

public Map<String,ACollectingMeasurement.Detail> getDetails()

getTotalDurationNanos

public long getTotalDurationNanos()

detail

public <R,E extends Exception> R detail(String detailIdentifier,
                                        AMeasureCallback<R,E> callback)
                                 throws E extends Exception

Throws:

E extends Exception

startDetail

public void startDetail(String detailIdentifier)

finishDetail

public void finishDetail()

addDetailMeasurement

public void addDetailMeasurement(String detailIdentifier,
                                 long durationNanos)

isFinished

public boolean isFinished()

finish

public void finish()