Top Methods
org.HdrHistogram

public Interface ValueRecorder

Known Direct Implementers
org.HdrHistogram.AbstractHistogram, org.HdrHistogram.Recorder, org.HdrHistogram.SingleWriterRecorder

Method Summary

Modifier and TypeMethod and Description
public void
recordValue(long
The value to be recorded
value
)

Record a value

public void
recordValueWithCount(long
The value to be recorded
value
,
long
The number of occurrences of this value to record
count
)

Record a value (adding to the value's current count)

public void
recordValueWithExpectedInterval(long
The value to record
value
,
long
If expectedIntervalBetweenValueSamples is larger than 0, add auto-generated value records as appropriate if value is larger than expectedIntervalBetweenValueSamples
expectedIntervalBetweenValueSamples
)

Record a value.

public void
reset()

Reset the contents and collected stats

Method Detail

recordValueback to summary
public void recordValue(long value) throws ArrayIndexOutOfBoundsException

Record a value

Parameters
value:long

The value to be recorded

Exceptions
ArrayIndexOutOfBoundsException:
(may throw) if value cannot be covered by the histogram's range
recordValueWithCountback to summary
public void recordValueWithCount(long value, long count) throws ArrayIndexOutOfBoundsException

Record a value (adding to the value's current count)

Parameters
value:long

The value to be recorded

count:long

The number of occurrences of this value to record

Exceptions
ArrayIndexOutOfBoundsException:
(may throw) if value cannot be covered by the histogram's range
recordValueWithExpectedIntervalback to summary
public void recordValueWithExpectedInterval(long value, long expectedIntervalBetweenValueSamples) throws ArrayIndexOutOfBoundsException

Record a value.

To compensate for the loss of sampled values when a recorded value is larger than the expected interval between value samples, will auto-generate an additional series of decreasingly-smaller (down to the expectedIntervalBetweenValueSamples) value records.

Note

This is a at-recording correction method, as opposed to the post-recording correction method provided by AbstractHistogram#copyCorrectedForCoordinatedOmission(long). The two methods are mutually exclusive, and only one of the two should be be used on a given data set to correct for the same coordinated omission issue.

Parameters
value:long

The value to record

expectedIntervalBetweenValueSamples:long

If expectedIntervalBetweenValueSamples is larger than 0, add auto-generated value records as appropriate if value is larger than expectedIntervalBetweenValueSamples

Exceptions
ArrayIndexOutOfBoundsException:
(may throw) if value cannot be covered by the histogram's range
resetback to summary
public void reset()

Reset the contents and collected stats