org.sonar.api.ce.measure

Class RangeDistributionBuilder

java.lang.Object

org.sonar.api.ce.measure.RangeDistributionBuilder

public class RangeDistributionBuilder
extends Object

Utility to build a distribution based on defined ranges

An example of usage : you wish to record the percentage of lines of code that belong to method with pre-defined ranges of complexity.

Since:

5.2

Constructor Summary

Constructors

Constructor and Description
RangeDistributionBuilder()
RangeDistributionBuilder(Number[] bottomLimits) RangeDistributionBuilder for a defined range Each entry is initialized at zero

Method Summary

Modifier and Type	Method and Description
RangeDistributionBuilder	add(Number value) Increments an entry by 1
RangeDistributionBuilder	add(Number value, int count) Increments an entry
RangeDistributionBuilder	add(String data) Adds an existing Distribution to the current one.
String	build() Used to build a measure from the current object
boolean	isEmpty()

Methods inherited from class java.lang.Object

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

Constructor Detail

RangeDistributionBuilder

public RangeDistributionBuilder()

RangeDistributionBuilder

public RangeDistributionBuilder(Number[] bottomLimits)

RangeDistributionBuilder for a defined range Each entry is initialized at zero

Parameters:

bottomLimits - the bottom limits of ranges to be used

Method Detail

add

public RangeDistributionBuilder add(Number value)

Increments an entry by 1

Parameters:

value - the value to use to pick the entry to increment

add

public RangeDistributionBuilder add(Number value,
                                    int count)

Increments an entry

Parameters:

value - the value to use to pick the entry to increment

count - the number by which to increment

add

public RangeDistributionBuilder add(String data)

Adds an existing Distribution to the current one. It will create the entries if they don't exist. Can be used to add the values of children resources for example
The returned distribution will be invalidated in case the given value does not use the same bottom limits

Parameters:

data - the data to add to the current one

isEmpty

public boolean isEmpty()

Returns:

whether the current object is empty or not

build

@CheckForNull
public String build()

Used to build a measure from the current object

Returns:

the built measure