Package org.openjdk.jmc.common.unit

Class CustomUnitSelector

java.lang.Object

org.openjdk.jmc.common.unit.CustomUnitSelector

All Implemented Interfaces:

LinearKindOfQuantity.LinearUnitSelector, TypedUnit.UnitSelector<LinearUnit>

public class CustomUnitSelector
extends Object
implements LinearKindOfQuantity.LinearUnitSelector

Field Summary

Fields

Modifier and Type	Field	Description
protected LinearKindOfQuantity.LinearUnitSelector	bigSelector
protected LinearKindOfQuantity	kindOfQuantity
protected LinearKindOfQuantity.LinearUnitSelector	smallSelector
protected ArrayList<ITypedQuantity<LinearUnit>>	tickList
protected double[]	tickMultiplierArr
protected LinearUnit[]	unitArr
protected double[]	unitMultiplierArr

Constructor Summary

Constructors

Constructor	Description
CustomUnitSelector(LinearKindOfQuantity kindOfQuantity, LinearKindOfQuantity.LinearUnitSelector smallSelector, Collection<LinearUnit> units, LinearKindOfQuantity.LinearUnitSelector bigSelector, SortedSet<ITypedQuantity<LinearUnit>> ticks)

Method Summary

Modifier and Type	Method	Description
LinearUnit	getLargestExactUnit(ITypedQuantity<LinearUnit> quantity)	Get the largest unit, if any, in which this quantity can be expressed exactly, typically with an integer.
LinearUnit	getPreferredUnit(ITypedQuantity<LinearUnit> quantity, double minNumericalValue, double maxNumericalValue)
ITypedQuantity<LinearUnit>	snapToBestBetweenHalfAndEqual(ITypedQuantity<LinearUnit> upperLimit)

Methods inherited from class java.lang.Object

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

Field Detail

kindOfQuantity

protected final LinearKindOfQuantity kindOfQuantity

unitMultiplierArr

protected final double[] unitMultiplierArr

unitArr

protected final LinearUnit[] unitArr

tickMultiplierArr

protected final double[] tickMultiplierArr

tickList

protected final ArrayList<ITypedQuantity<LinearUnit>> tickList

smallSelector

protected final LinearKindOfQuantity.LinearUnitSelector smallSelector

bigSelector

protected final LinearKindOfQuantity.LinearUnitSelector bigSelector

Constructor Detail

CustomUnitSelector

public CustomUnitSelector(LinearKindOfQuantity kindOfQuantity,
                          LinearKindOfQuantity.LinearUnitSelector smallSelector,
                          Collection<LinearUnit> units,
                          LinearKindOfQuantity.LinearUnitSelector bigSelector,
                          SortedSet<ITypedQuantity<LinearUnit>> ticks)

Method Detail

getPreferredUnit

public LinearUnit getPreferredUnit(ITypedQuantity<LinearUnit> quantity,
                                   double minNumericalValue,
                                   double maxNumericalValue)

Specified by:

getPreferredUnit in interface TypedUnit.UnitSelector<LinearUnit>

snapToBestBetweenHalfAndEqual

public ITypedQuantity<LinearUnit> snapToBestBetweenHalfAndEqual(ITypedQuantity<LinearUnit> upperLimit)

Specified by:

snapToBestBetweenHalfAndEqual in interface LinearKindOfQuantity.LinearUnitSelector

getLargestExactUnit

public LinearUnit getLargestExactUnit(ITypedQuantity<LinearUnit> quantity)

Description copied from interface: TypedUnit.UnitSelector

Get the largest unit, if any, in which this quantity can be expressed exactly, typically with an integer. If the quantity has zero magnitude ( IQuantity.doubleValue() == 0.0), quantity.getUnit() will be returned. Thus, if you want to find out a maximum common unit for a set of quantities (not recommended), only use the non-zero quantities.

Note that this may be a fairly expensive operation, and isn't intended to be used excessively. The only valid use case is for guessing the original unit in which a quantity was expressed, after it has been stored or transmitted using a legacy mechanism with a fixed unit.

Specified by:

getLargestExactUnit in interface TypedUnit.UnitSelector<LinearUnit>

Returns:

a unit or null