js.format

Class Number

java.lang.Object

js.format.Number

All Implemented Interfaces:

Format

public final class Number
extends Object
implements Format

Numeric value format - 12.34. This class is a thin wrapper for Java NumberFormat with grouping.

Version:

final

Author:

Iulian Rotaru

Field Summary

Fields

Modifier and Type	Field and Description
private NumberFormat	numberFormat Number formatter.

Constructor Summary

Constructors

Constructor and Description
Number() Create number formatter with default locale settings.
Number(Locale locale) Create number formatter with given locale settings.

Method Summary

Modifier and Type	Method and Description
String	format(Object value) Format numeric value using this formatter locale settings.
Object	parse(String value) Parse string numeric value accordingly this formatter locale.

Methods inherited from class java.lang.Object

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

Field Detail

numberFormat

private NumberFormat numberFormat

Number formatter.

Constructor Detail

Number

public Number()

Create number formatter with default locale settings.

Number

public Number(Locale locale)

Create number formatter with given locale settings.

Parameters:

locale - locale settings.

Method Detail

format

public String format(Object value)

Format numeric value using this formatter locale settings. Returns empty string if value argument is null.

Specified by:

format in interface Format

Parameters:

value - numeric value.

Returns:

numeric value represented as locale string, possible empty if value argument is null.

Throws:

IllegalArgumentException - if value argument is not an instance of Number.

parse

public Object parse(String value)
             throws ParseException

Parse string numeric value accordingly this formatter locale. Given numeric value argument should be represented accordingly this formatter locale. This method returns a Number instance. Returns null if value argument is null or empty.

Specified by:

parse in interface Format

Parameters:

value - locale numeric value.

Returns:

Number instance, possible null.

Throws:

ParseException - if value argument does not represent a number accordingly this formatter locale.