Hyperic HQ Plugin API v. 4.4.0.2

org.hyperic.util.units
Interface Formatter

All Known Implementing Classes:
ApproxDurationFormatter, BinaryFormatter, BitRateFormatter, BytesFormatter, BytesToBitsFormatter, CurrencyFormatter, DateFormatter, DurationFormatter, NoFormatter, PercentageFormatter, PercentFormatter, SimpleFormatter

public interface Formatter


Method Summary
 FormattedNumber format(UnitNumber val, java.util.Locale locale, FormatSpecifics format)
          Format a number with the given locale.
 FormattedNumber[] formatSame(double[] values, int unitType, int scale, java.util.Locale locale, FormatSpecifics format)
          Format a several values at once into the same format.
 java.math.BigDecimal getBaseValue(double value, int scale)
          Get the base value of a value, given its scale.
 java.math.BigDecimal getScaledValue(java.math.BigDecimal value, int targScale)
          Get a scaled version of a value.
 UnitNumber parse(java.lang.String val, java.util.Locale locale, ParseSpecifics specifics)
          Parse a string into a UnitNumber.
 

Method Detail

format

FormattedNumber format(UnitNumber val,
                       java.util.Locale locale,
                       FormatSpecifics format)
Format a number with the given locale.

Parameters:
val - Value to format
locale - Locale that the resultant format should be in
format - Optional format to give specific hints to the formatter about how the result should look.

formatSame

FormattedNumber[] formatSame(double[] values,
                             int unitType,
                             int scale,
                             java.util.Locale locale,
                             FormatSpecifics format)
Format a several values at once into the same format. I.e. no matter the discrepency of range, they all contain the same units (megabytes, etc.)

Parameters:
values - Values to format
unitType - One of UnitsConstants.UNIT_*
scale - One of UnitsConstants.SCALE_*
locale - Locale that the resultant format should be in
format - Optional format to give specific hints to the formatter about how the result should look.

getBaseValue

java.math.BigDecimal getBaseValue(double value,
                                  int scale)
Get the base value of a value, given its scale. E.x.: getBaseValue(1, SCALE_KILO) -> 1024 (bytes being the base unit)

Parameters:
value - Value to get the base of
scale - Scale of the value -- must be valid for the formatter unit type

getScaledValue

java.math.BigDecimal getScaledValue(java.math.BigDecimal value,
                                    int targScale)
Get a scaled version of a value. The value in its base format, and the target scale are passed. The return value will be a number, scaled to the target. E.x.: getScaledValue(1024, SCALE_NONE) -> 1024 getScaledValue(1024, SCALE_KILO) -> 1 (1 kilobyte)

Parameters:
value - Value to scale
targScale - Target scale -- must be valid for the formatter unit type

parse

UnitNumber parse(java.lang.String val,
                 java.util.Locale locale,
                 ParseSpecifics specifics)
                 throws java.text.ParseException
Parse a string into a UnitNumber. E.x. parse("34 MB") -> UnitNumber(34, UNIT_BYTES, SCALE_MEGA)

Parameters:
val - Value to parse
locale - Locale to parse with
specifics - An optional argument which gives the parser more information about parsing
Returns:
the number representing the parsed value
Throws:
java.text.ParseException

Hyperic HQ Plugin API v. 4.4.0.2

Copyright © 2004-2006 Hyperic, Inc. support@hyperic.net, All Rights Reserved.