js.format

Class Currency

java.lang.Object

js.format.Currency

All Implemented Interfaces:

Format

public final class Currency
extends Object
implements Format

Currency format - $12.34. Currency string representation has a numeric value and a currency symbol, both depending on locale settings.

Currency formatter implementation is based on Java NumberFormat that is not synchronized. Therefore this implementation is not thread safe.

Version:

final

Author:

Iulian Rotaru

Field Summary

Fields

Modifier and Type	Field and Description
private NumberFormat	numberFormat Formatter for currency.

Constructor Summary

Constructors

Constructor and Description
Currency() Create currency formatter with default locale settings.
Currency(Locale locale) Create currency formatter for given locale settings.

Method Summary

Modifier and Type	Method and Description
String	format(Object value) Format numeric value as currency representation using locale settings.
Object	parse(String value) Parse localized currency and return its numeric value.

Methods inherited from class java.lang.Object

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

Field Detail

numberFormat

private NumberFormat numberFormat

Formatter for currency. Both numeric part and currency symbol are subject of locale adjustments.

Constructor Detail

Currency

public Currency()

Create currency formatter with default locale settings.

Currency

public Currency(Locale locale)

Create currency formatter for given locale settings.

Parameters:

locale - locale settings.

Method Detail

format

public String format(Object value)

Format numeric value as currency representation using 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 currency or empty string.

Throws:

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

parse

public Object parse(String value)
             throws ParseException

Parse localized currency and return its numeric value. Returned value is an instance of Number class. This method returns null if given value argument is null or empty.

Specified by:

parse in interface Format

Parameters:

value - locale currency value.

Returns:

currency value as Number instance or null if value argument is null or empty.

Throws:

ParseException - if value argument is not a valid currency accordingly this formatter locale.