* The class is designed so that there's never more than one
* Currency instance for any given currency. Therefore, there's
* no public constructor. You obtain a Currency instance using
* the getInstance methods.
*
* Users can supersede the Java runtime currency data by creating a properties
* file named <JAVA_HOME>/lib/currency.properties. The contents
* of the properties file are key/value pairs of the ISO 3166 country codes
* and the ISO 4217 currency data respectively. The value part consists of
* three ISO 4217 values of a currency, i.e., an alphabetic code, a numeric
* code, and a minor unit. Those three ISO 4217 values are separated by commas.
* The lines which start with '#'s are considered comment lines. For example,
*
*
* #Sample currency properties
*
* JP=JPZ,999,0
*
* will supersede the currency data for Japan.
*
* @since 1.4
*/
public final class Currency implements Serializable {
private static final long serialVersionUID = -158308464356906721L;
private static HashMap
* The method returns Currency instance. The constructor is private
* so that we can insure that there's never more than one instance for a
* given currency.
*/
private Currency(android.icu.util.Currency icuCurrency) {
this.icuCurrency = icuCurrency;
this.currencyCode = icuCurrency.getCurrencyCode();
}
/**
* Returns the Currency instance for the given currency code.
*
* @param currencyCode the ISO 4217 code of the currency
* @return the Currency instance for the given currency code
* @exception NullPointerException if currencyCode is null
* @exception IllegalArgumentException if currencyCode is not
* a supported ISO 4217 code.
*/
public static Currency getInstance(String currencyCode) {
synchronized (instances) {
Currency instance = instances.get(currencyCode);
if (instance == null) {
android.icu.util.Currency icuInstance =
android.icu.util.Currency.getInstance(currencyCode);
if (icuInstance == null) {
return null;
}
instance = new Currency(icuInstance);
instances.put(currencyCode, instance);
}
return instance;
}
}
/**
* Returns the Currency instance for the country of the
* given locale. The language and variant components of the locale
* are ignored. The result may vary over time, as countries change their
* currencies. For example, for the original member countries of the
* European Monetary Union, the method returns the old national currencies
* until December 31, 2001, and the Euro from January 1, 2002, local time
* of the respective countries.
* null for territories that don't
* have a currency, such as Antarctica.
*
* @param locale the locale for whose country a Currency
* instance is needed
* @return the Currency instance for the country of the given
* locale, or null
* @exception NullPointerException if locale or its country
* code is null
* @exception IllegalArgumentException if the country of the given locale
* is not a supported ISO 3166 country code.
*/
public static Currency getInstance(Locale locale) {
android.icu.util.Currency icuInstance =
android.icu.util.Currency.getInstance(locale);
String variant = locale.getVariant();
String country = locale.getCountry();
if (!variant.isEmpty() && (variant.equals("EURO") || variant.equals("HK") ||
variant.equals("PREEURO"))) {
country = country + "_" + variant;
}
String currencyCode = ICU.getCurrencyCode(country);
if (currencyCode == null) {
throw new IllegalArgumentException("Unsupported ISO 3166 country: " + locale);
}
if (icuInstance == null || icuInstance.getCurrencyCode().equals("XXX")) {
return null;
}
return getInstance(currencyCode);
}
/**
* Gets the set of available currencies. The returned set of currencies
* contains all of the available currencies, which may include currencies
* that represent obsolete ISO 4217 codes. The set can be modified
* without affecting the available currencies in the runtime.
*
* @return the set of available currencies. If there is no currency
* available in the runtime, the returned set is empty.
* @since 1.7
*/
public static Setlocale is null
*/
public String getSymbol(Locale locale) {
if (locale == null) {
throw new NullPointerException("locale == null");
}
return icuCurrency.getSymbol(locale);
}
/**
* Gets the default number of fraction digits used with this currency.
* For example, the default number of fraction digits for the Euro is 2,
* while for the Japanese Yen it's 0.
* In the case of pseudo-currencies, such as IMF Special Drawing Rights,
* -1 is returned.
*
* @return the default number of fraction digits used with this currency
*/
public int getDefaultFractionDigits() {
if (icuCurrency.getCurrencyCode().equals("XXX")) {
return -1;
}
return icuCurrency.getDefaultFractionDigits();
}
/**
* Returns the ISO 4217 numeric code of this currency.
*
* @return the ISO 4217 numeric code of this currency
* @since 1.7
*/
public int getNumericCode() {
return icuCurrency.getNumericCode();
}
/**
* Gets the name that is suitable for displaying this currency for
* the default locale. If there is no suitable display name found
* for the default locale, the ISO 4217 currency code is returned.
*
* @return the display name of this currency for the default locale
* @since 1.7
*/
public String getDisplayName() {
return icuCurrency.getDisplayName();
}
/**
* Gets the name that is suitable for displaying this currency for
* the specified locale. If there is no suitable display name found
* for the specified locale, the ISO 4217 currency code is returned.
*
* @param locale the locale for which a display name for this currency is
* needed
* @return the display name of this currency for the specified locale
* @exception NullPointerException if locale is null
* @since 1.7
*/
public String getDisplayName(Locale locale) {
return icuCurrency.getDisplayName(locale);
}
/**
* Returns the ISO 4217 currency code of this currency.
*
* @return the ISO 4217 currency code of this currency
*/
public String toString() {
return icuCurrency.toString();
}
/**
* Resolves instances being deserialized to a single instance per currency.
*/
private Object readResolve() {
return getInstance(currencyCode);
}
}