se.l4.vibe.builder.TimerBuilder Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of vibe-api Show documentation

There is a newer version: 0.4.0

package se.l4.vibe.builder;

import se.l4.vibe.percentile.PercentileCounter;
import se.l4.vibe.timer.Timer;

/**
 * Builder for instances of {@link Timer}.
 * 
 * @author Andreas Holstenson
 *
 */
public interface TimerBuilder
	extends Builder
{
	/**
	 * Measure how many timings fall within a predefined set of ranges. Ranges
	 * are given in milliseconds. 
	 * 
	 * Each bucket  represent a range, the first value given in this array is the 
	 * start of the first bucket and the last one is the upper bound for the 
	 * next to last bucket.
	 * 
	 * 
	 * Example:
	 * 
	 * withBuckets(0, 100, 400, 500)
	 * 
	 * 
	 * Buckets created:
	 * 
	 *   0-100
	 *   101-400
	 *   401-500
	 *   501-*
	 * 
	 * 
	 * 
	 * This will enable percentile calculations for this timer.
	 * 
	 * @param limits
	 * @return
	 */
	TimerBuilder withBuckets(int... limits);
	
	/**
	 * Set the percentile counter to use for this timer. The counter should be setup
	 * to measure things in nanoseconds.
	 * 
	 * @param counter
	 * @return
	 */
	TimerBuilder withPercentiles(PercentileCounter counter);
	
	/**
	 * Build and return the timer without exporting it.
	 * 
	 * @return
	 */
	Timer build();
	
	/**
	 * Export and return the timer.
	 * 
	 * @return
	 */
	Timer export();
}