javax.money.spi

Interface MonetaryFormatsSingletonSpi

All Known Implementing Classes:

MonetaryFormats.DefaultMonetaryFormatsSingletonSpi

public interface MonetaryFormatsSingletonSpi

This interface models the singleton functionality of MonetaryFormats.

Implementations of this interface must be thread-safe.

Author:

Anatole Tresch, Werner Keil

Method Summary

Modifier and Type	Method and Description
default MonetaryAmountFormat	getAmountFormat(AmountFormatQuery formatQuery) Access an MonetaryAmountFormat given a .AmountFormatQuery.
default MonetaryAmountFormat	getAmountFormat(Locale locale, String... providers) Access the default MonetaryAmountFormat given a Locale.
default MonetaryAmountFormat	getAmountFormat(String formatName, String... providers) Access the default MonetaryAmountFormat given a Locale.
Collection<MonetaryAmountFormat>	getAmountFormats(AmountFormatQuery formatQuery) Access all MonetaryAmountFormat instances matching the given .AmountFormatQuery.
Set<Locale>	getAvailableLocales(String... providers) Get all available locales.
List<String>	getDefaultProviderChain() Get the default provider chain, identified by the unique provider names in order as evaluated and used.
Set<String>	getProviderNames() Get the names of the currently registered format providers.
default boolean	isAvailable(AmountFormatQuery formatQuery) Checks if a MonetaryAmountFormat is available given a .AmountFormatQuery.
default boolean	isAvailable(Locale locale, String... providers) Checks if a MonetaryAmountFormat is available given a .AmountFormatQuery.

Method Detail

getAvailableLocales

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

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

Parameters:

providers - The (optional) providers to be used, ordered correspondingly.

Returns:

all available locales, never null.

getAmountFormats

Collection<MonetaryAmountFormat> getAmountFormats(AmountFormatQuery formatQuery)

Access all MonetaryAmountFormat instances matching the given .AmountFormatQuery.

Parameters:

formatQuery - The format query defining the requirements of the formatter.

Returns:

the corresponding MonetaryAmountFormat instances, never null

getProviderNames

Set<String> getProviderNames()

Get the names of the currently registered format providers.

Returns:

the provider names, never null.

getDefaultProviderChain

List<String> getDefaultProviderChain()

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

Returns:

the default provider chain, never null.

getAmountFormat

default MonetaryAmountFormat getAmountFormat(AmountFormatQuery formatQuery)

Access an MonetaryAmountFormat given a .AmountFormatQuery.

Parameters:

formatQuery - The format query defining the requirements of the formatter.

Returns:

the corresponding MonetaryAmountFormat

Throws:

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

isAvailable

default boolean isAvailable(AmountFormatQuery formatQuery)

Checks if a MonetaryAmountFormat is available given a .AmountFormatQuery.

Parameters:

formatQuery - The format query defining the requirements of the formatter.

Returns:

true, if a t least one MonetaryAmountFormat is matching the query.

isAvailable

default boolean isAvailable(Locale locale,
                            String... providers)

Checks if a MonetaryAmountFormat is available given a .AmountFormatQuery.

Parameters:

locale - the target Locale, not null.

providers - The (optional) providers to be used, ordered correspondingly.

Returns:

true, if a t least one MonetaryAmountFormat is matching the query.

getAmountFormat

default MonetaryAmountFormat getAmountFormat(Locale locale,
                                             String... providers)

Access the default MonetaryAmountFormat given a Locale.

Parameters:

locale - the target Locale, not null.

providers - The (optional) providers to be used, ordered correspondingly.

Returns:

the matching MonetaryAmountFormat

Throws:

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

getAmountFormat

default MonetaryAmountFormat getAmountFormat(String formatName,
                                             String... providers)

Access the default MonetaryAmountFormat given a Locale.

Parameters:

formatName - the target format name, not null.

providers - The (optional) providers to be used, ordered correspondingly.

Returns:

the matching MonetaryAmountFormat

Throws:

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