Module java.money

Package javax.money.format

Class MonetaryFormats

java.lang.Object

javax.money.format.MonetaryFormats

public final class MonetaryFormats
extends Object

This class models the singleton accessor for MonetaryAmountFormat instances.

This class is thread-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	MonetaryFormats.DefaultMonetaryFormatsSingletonSpi	This class models the singleton accessor for MonetaryAmountFormat instances.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	MonetaryFormats()	Private singleton constructor.

Method Summary

Modifier and Type	Method	Description
static MonetaryAmountFormat	getAmountFormat(String formatName, String... providers)	Access the a MonetaryAmountFormat given its styleId.
static MonetaryAmountFormat	getAmountFormat(Locale locale, String... providers)	Access the default MonetaryAmountFormat given a Locale.
static MonetaryAmountFormat	getAmountFormat(AmountFormatQuery formatQuery)	Access the default MonetaryAmountFormat given a Locale.
static Collection<MonetaryAmountFormat>	getAmountFormats(AmountFormatQuery formatQuery)	Access all MonetaryAmountFormat instances that match the given a AmountFormatQuery.
static Set<Locale>	getAvailableLocales(String... providers)	Get all available locales.
static List<String>	getDefaultFormatProviderChain()	Get the default provider chain, identified by the unique provider names in order as evaluated and used.
static Collection<String>	getFormatProviderNames()	Get the names of the currently registered format providers.
private static MonetaryFormatsSingletonSpi	getMonetaryFormatsSpi()
static boolean	isAvailable(Locale locale, String... providers)	Checks if a MonetaryAmountFormat is available for the given Locale and providers.
static boolean	isAvailable(AmountFormatQuery formatQuery)	Checks if a MonetaryAmountFormat is available for the given AmountFormatQuery.
private static MonetaryFormatsSingletonSpi	loadMonetaryFormatsSingletonSpi()	Loads the SPI backing bean.

Methods inherited from class java.lang.Object

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

Constructor Details

MonetaryFormats

private MonetaryFormats()

Private singleton constructor.

Method Details

getMonetaryFormatsSpi

private static MonetaryFormatsSingletonSpi getMonetaryFormatsSpi()

loadMonetaryFormatsSingletonSpi

private static MonetaryFormatsSingletonSpi loadMonetaryFormatsSingletonSpi()

Loads the SPI backing bean.

Returns:

the instance of MonetaryFormatsSingletonSpi to be used by this singleton.

isAvailable

public static boolean isAvailable(Locale locale,
 String... providers)

Checks if a MonetaryAmountFormat is available for the given Locale and providers.

Parameters:

locale - the target Locale, not null.

providers - The providers to be queried, if not set the providers as defined by #getDefaultCurrencyProviderChain() are queried.

Returns:

true, if a corresponding MonetaryAmountFormat is accessible.

getAmountFormat

public static MonetaryAmountFormat getAmountFormat(Locale locale,
 String... providers)

Access the default MonetaryAmountFormat given a Locale.

Parameters:

locale - the target Locale, not null.

providers - The providers to be queried, if not set the providers as defined by #getDefaultCurrencyProviderChain() are queried.

Returns:

the matching MonetaryAmountFormat

Throws:

MonetaryException - if no registered MonetaryAmountFormatProviderSpi can provide a corresponding MonetaryAmountFormat instance.

isAvailable

public static boolean isAvailable(AmountFormatQuery formatQuery)

Checks if a MonetaryAmountFormat is available for the given AmountFormatQuery.

Parameters:

formatQuery - the required AmountFormatQuery, not null. If the query does not define any explicit provider chain, the providers as defined by #getDefaultCurrencyProviderChain() are used.

Returns:

true, if a corresponding MonetaryAmountFormat is accessible.

getAmountFormat

public static MonetaryAmountFormat getAmountFormat(AmountFormatQuery formatQuery)

Access the default MonetaryAmountFormat given a Locale.

Parameters:

formatQuery - the required AmountFormatQuery, not null. If the query does not define any explicit provider chain, the providers as defined by #getDefaultCurrencyProviderChain() are used.

Returns:

the matching MonetaryAmountFormat

Throws:

MonetaryException - if no registered MonetaryAmountFormatProviderSpi can provide a corresponding MonetaryAmountFormat instance.

getAmountFormats

public static Collection<MonetaryAmountFormat> getAmountFormats(AmountFormatQuery formatQuery)

Access all MonetaryAmountFormat instances that match the given a AmountFormatQuery.

Parameters:

formatQuery - the required AmountFormatQuery, not null. If the query does not define any explicit provider chain, the providers as defined by #getDefaultCurrencyProviderChain() are used.

Returns:

the matching MonetaryAmountFormat

Throws:

MonetaryException - if no registered MonetaryAmountFormatProviderSpi can provide a corresponding MonetaryAmountFormat instance.

getAmountFormat

public static MonetaryAmountFormat getAmountFormat(String formatName,
 String... providers)

Access the a MonetaryAmountFormat given its styleId.

Parameters:

formatName - the target format name, not null.

providers - The providers to be used, if not set the providers as defined by #getDefaultCurrencyProviderChain() are used.

Returns:

the matching MonetaryAmountFormat

Throws:

MonetaryException - if no registered MonetaryAmountFormatProviderSpi can provide a corresponding MonetaryAmountFormat instance.

getAvailableLocales

public static Set<Locale> getAvailableLocales(String... providers)

Get all available locales. This equals to MonetaryAmountFormatProviderSpi.getAvailableLocales().

Parameters:

providers - The providers to be used, if not set the providers as defined by #getDefaultCurrencyProviderChain() are used.

Returns:

all available locales, never null.

getFormatProviderNames

public static Collection<String> getFormatProviderNames()

Get the names of the currently registered format providers.

Returns:

the provider names, never null.

getDefaultFormatProviderChain

public static List<String> getDefaultFormatProviderChain()

Get the default provider chain, identified by the unique provider names in order as evaluated and used.

Returns:

the default provider chain, never null.