org.javasimon.callback.lastsplits

Class LastSplits

java.lang.Object

org.javasimon.callback.lastsplits.LastSplits

All Implemented Interfaces:

LogMessageSource<Split>

public class LastSplits
extends Object
implements LogMessageSource<Split>

Object stored among Stopwatch's attributes in charge of

• Managing concurrent access to the inner ring buffer through synchronized blocks
• Computing som statistics (min, max, mean, trend) based on retained values
• Log retained values and statistics

Since:

3.2

Author:

gquintana

Constructor Summary

Constructors

Constructor and Description
LastSplits(int capacity) Constructor with ring buffer size.

Method Summary

Modifier and Type	Method and Description
void	add(Split split) Adds split to the buffer.
void	clear() Removes all splits from buffer.
int	getCount() Gets number of splits in the buffer.
String	getLogMessage(Split lastSplit) Transforms this list of splits into a loggable message.
LogTemplate<Split>	getLogTemplate()
Long	getMax() Compute the longest duration of splits in the buffer
Double	getMean() Compute mean duration of splits in the buffer
Long	getMin() Compute the smallest duration of splits in the buffer
Double	getTrend() Compute a trend of duration: the average delta of splits between 2 splits spaced of at least 1 ms.
Double	getTrend(long timeDeltaThreshold) Compute a trend of duration: the average delta of splits between 2 split spaced of at least the given threshold.
void	log(Split lastSplit) Log eventually this list of splits into log template
void	setLogTemplate(LogTemplate<Split> logTemplate)
String	toString() String containing: count, min, mean, max and trend(1ms).

Methods inherited from class java.lang.Object

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

Constructor Detail

LastSplits

public LastSplits(int capacity)

Constructor with ring buffer size.

Parameters:

capacity - Buffer size

Method Detail

add

public void add(Split split)

Adds split to the buffer.

Parameters:

split - Split

clear

public void clear()

Removes all splits from buffer.

getLogTemplate

public LogTemplate<Split> getLogTemplate()

setLogTemplate

public void setLogTemplate(LogTemplate<Split> logTemplate)

getCount

public int getCount()

Gets number of splits in the buffer.

Returns:

Split number

getMean

public Double getMean()

Compute mean duration of splits in the buffer

Returns:

Mean or average

getMin

public Long getMin()

Compute the smallest duration of splits in the buffer

Returns:

Minimum

getMax

public Long getMax()

Compute the longest duration of splits in the buffer

Returns:

Maximum

getTrend

public Double getTrend()

Compute a trend of duration: the average delta of splits between 2 splits spaced of at least 1 ms. Sum(splits(t[n])-splits(t[n-1])/SizeOf(splits)

Returns:

Trend, average delta of splits

getTrend

public Double getTrend(long timeDeltaThreshold)

Compute a trend of duration: the average delta of splits between 2 split spaced of at least the given threshold. The threshold is only here to avoid computing a delta between 2 splits occurring at the same time by 2 different threads. Sum(splits(t[n])-splits(t[n-1])/SizeOf(splits)

Parameters:

timeDeltaThreshold - Accepted splits space

Returns:

Trend, average delta of splits

toString

public String toString()

String containing: count, min, mean, max and trend(1ms). This method can be expensive, because many computations are done.

Overrides:

toString in class Object

Returns:

String

getLogMessage

public String getLogMessage(Split lastSplit)

Transforms this list of splits into a loggable message.

Specified by:

getLogMessage in interface LogMessageSource<Split>

Parameters:

lastSplit - Context

Returns:

Message

log

public void log(Split lastSplit)

Log eventually this list of splits into log template