Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2014-2016 Philip Helger (www.helger.com)
* philip[at]helger[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.helger.masterdata.currency;
import java.math.BigDecimal;
import java.math.RoundingMode;
import java.text.DecimalFormat;
import java.text.NumberFormat;
import java.util.Arrays;
import java.util.Currency;
import java.util.Locale;
import java.util.function.Predicate;
import javax.annotation.CheckReturnValue;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.NotThreadSafe;
import org.slf4j.LoggerFactory;
import com.helger.commons.ValueEnforcer;
import com.helger.commons.annotation.CodingStyleguideUnaware;
import com.helger.commons.annotation.Nonempty;
import com.helger.commons.annotation.ReturnsMutableCopy;
import com.helger.commons.collection.ArrayHelper;
import com.helger.commons.collection.CollectionHelper;
import com.helger.commons.collection.ext.CommonsArrayList;
import com.helger.commons.collection.ext.ICommonsList;
import com.helger.commons.filter.IFilter;
import com.helger.commons.id.IHasID;
import com.helger.commons.lang.EnumHelper;
import com.helger.commons.locale.LocaleCache;
import com.helger.commons.string.StringHelper;
import com.helger.commons.text.display.IHasDisplayText;
/**
* A list of pre-selected currencies as specified in ISO 4217.
* http://en.wikipedia.org/wiki/ISO_4217
*
* @author Philip Helger
*/
@NotThreadSafe
public enum ECurrency implements IHasID ,IHasDisplayText
{
AED ("AED", ECurrencyName.AED, "_AE", "ar_AE"),
AFN ("AFN", ECurrencyName.AFN, "_AF"),
ALL ("ALL", ECurrencyName.ALL, "_AL", "sq_AL"),
AMD ("AMD", ECurrencyName.AMD, "_AM"),
ANG ("ANG", ECurrencyName.ANG, "_AN", "_CW", "_SX"),
AOA ("AOA", ECurrencyName.AOA, "_AO"),
ARS ("ARS", ECurrencyName.ARS, "_AR", "es_AR"),
AUD ("AUD", ECurrencyName.AUD, "_AU", "_CC", "_CX", "_HM", "_KI", "_NF", "_NR", "_TV", "en_AU"),
AWG ("AWG", ECurrencyName.AWG, "_AW"),
AZN ("AZN", ECurrencyName.AZN, "_AZ"),
BAM ("BAM", ECurrencyName.BAM, "_BA", "sr_BA"),
BBD ("BBD", ECurrencyName.BBD, "_BB"),
BDT ("BDT", ECurrencyName.BDT, "_BD"),
BGN ("BGN", ECurrencyName.BGN, "_BG", "bg_BG"),
BHD ("BHD", ECurrencyName.BHD, "_BH", "ar_BH"),
BIF ("BIF", ECurrencyName.BIF, "_BI"),
BMD ("BMD", ECurrencyName.BMD, "_BM"),
BND ("BND", ECurrencyName.BND, "_BN"),
BOB ("BOB", ECurrencyName.BOB, "_BO", "es_BO"),
BRL ("BRL", ECurrencyName.BRL, "_BR", "pt_BR"),
BSD ("BSD", ECurrencyName.BSD, "_BS"),
BTN ("BTN", ECurrencyName.BTN, "_BT"),
BWP ("BWP", ECurrencyName.BWP, "_BW"),
BYR ("BYR", ECurrencyName.BYR, "_BY", "be_BY"),
BZD ("BZD", ECurrencyName.BZD, "_BZ"),
CAD ("CAD", ECurrencyName.CAD, "_CA", "en_CA", "fr_CA"),
CDF ("CDF", ECurrencyName.CDF, "_CD"),
CHF ("CHF", ECurrencyName.CHF, "_CH", "_LI", "de_CH", "fr_CH", "it_CH"),
CLP ("CLP", ECurrencyName.CLP, "_CL", "es_CL"),
CNY ("CNY", ECurrencyName.CNY, "_CN", "zh_CN"),
COP ("COP", ECurrencyName.COP, "_CO", "es_CO"),
CRC ("CRC", ECurrencyName.CRC, "_CR", "es_CR"),
@Deprecated CSD ("CSD", true, ECurrencyName.CSD, "_CS", "sr_CS"),
CUC ("CUC", ECurrencyName.CUC, "_CU"),
CUP ("CUP", ECurrencyName.CUP, "_CU"),
CVE ("CVE", ECurrencyName.CVE, "_CV"),
CZK ("CZK", ECurrencyName.CZK, "_CZ", "cs_CZ"),
DJF ("DJF", ECurrencyName.DJF, "_DJ"),
DKK ("DKK", ECurrencyName.DKK, "_DK", "_FO", "_GL", "da_DK"),
DOP ("DOP", ECurrencyName.DOP, "_DO", "es_DO"),
DZD ("DZD", ECurrencyName.DZD, "_DZ", "ar_DZ"),
// Estonian Kroon (until 31.12.2010)
@Deprecated EEK ("EEK", true, ECurrencyName.EEK, "_EE", "et_EE"),
EGP ("EGP", ECurrencyName.EGP, "_EG", "ar_EG"),
ERN ("ERN", ECurrencyName.ERN, "_ER"),
ETB ("ETB", ECurrencyName.ETB, "_ET"),
EUR ("EUR",
ECurrencyName.EUR,
"_AD",
"_AT",
"_AX",
"_BE",
"_BL",
"_CY",
"_DE",
"_EE",
"_ES",
"_FI",
"_FR",
"_GF",
"_GP",
"_GR",
"_IE",
"_IT",
"_LT",
"_LU",
"_LV",
"_MC",
"_ME",
"_MF",
"_MQ",
"_MT",
"_NL",
"_PM",
"_PT",
"_RE",
"_SI",
"_SK",
"_SM",
"_TF",
"_VA",
"_YT",
"ca_ES",
"de_AT",
"de_DE",
"de_LU",
"el_CY",
"el_GR",
"en_IE",
"en_MT",
"es_ES",
"et_EE",
"fi_FI",
"fr_BE",
"fr_FR",
"fr_LU",
"ga_IE",
"it_IT",
"lt_LT",
"lv_LV",
"mt_MT",
"nl_BE",
"nl_NL",
"pt_PT",
"sk_SK",
"sl_SI",
"sr_ME"),
FJD ("FJD", ECurrencyName.FJD, "_FJ"),
FKP ("FKP", ECurrencyName.FKP, "_FK"),
GBP ("GBP", ECurrencyName.GBP, "_GB", "_GG", "_GS", "_IM", "_JE", "en_GB"),
GEL ("GEL", ECurrencyName.GEL, "_GE"),
GHS ("GHS", ECurrencyName.GHS, "_GH"),
GIP ("GIP", ECurrencyName.GIP, "_GI"),
GMD ("GMD", ECurrencyName.GMD, "_GM"),
GNF ("GNF", ECurrencyName.GNF, "_GN"),
GTQ ("GTQ", ECurrencyName.GTQ, "_GT", "es_GT"),
GYD ("GYD", ECurrencyName.GYD, "_GY"),
HKD ("HKD", ECurrencyName.HKD, "_HK", "zh_HK"),
HNL ("HNL", ECurrencyName.HNL, "_HN", "es_HN"),
HRK ("HRK", ECurrencyName.HRK, "_HR", "hr_HR"),
HTG ("HTG", ECurrencyName.HTG, "_HT"),
HUF ("HUF", ECurrencyName.HUF, "_HU", "hu_HU"),
IDR ("IDR", ECurrencyName.IDR, "_ID", "in_ID"),
ILS ("ILS", ECurrencyName.ILS, "_IL", "_PS", "iw_IL"),
INR ("INR", ECurrencyName.INR, "_IN", "en_IN", "hi_IN"),
IQD ("IQD", ECurrencyName.IQD, "_IQ", "ar_IQ"),
IRR ("IRR", ECurrencyName.IRR, "_IR"),
ISK ("ISK", ECurrencyName.ISK, "_IS", "is_IS"),
JMD ("JMD", ECurrencyName.JMD, "_JM"),
JOD ("JOD", ECurrencyName.JOD, "_JO", "ar_JO"),
JPY ("JPY", ECurrencyName.JPY, "_JP", "ja_JP", "ja_JP_JP"),
KES ("KES", ECurrencyName.KES, "_KE"),
KGS ("KGS", ECurrencyName.KGS, "_KG"),
KHR ("KHR", ECurrencyName.KHR, "_KH"),
KMF ("KMF", ECurrencyName.KMF, "_KM"),
KPW ("KPW", ECurrencyName.KPW, "_KP"),
KRW ("KRW", ECurrencyName.KRW, "_KR", "ko_KR"),
KWD ("KWD", ECurrencyName.KWD, "_KW", "ar_KW"),
KYD ("KYD", ECurrencyName.KYD, "_KY"),
KZT ("KZT", ECurrencyName.KZT, "_KZ"),
LAK ("LAK", ECurrencyName.LAK, "_LA"),
LBP ("LBP", ECurrencyName.LBP, "_LB", "ar_LB"),
LKR ("LKR", ECurrencyName.LKR, "_LK"),
LRD ("LRD", ECurrencyName.LRD, "_LR"),
LSL ("LSL", ECurrencyName.LSL, "_LS"),
// Used until 31.12.2014
@Deprecated LTL ("LTL", true, ECurrencyName.LTL, "_LT", "lt_LT"),
// Used until 31.12.2013
@Deprecated LVL ("LVL", true, ECurrencyName.LVL, "_LV", "lv_LV"),
LYD ("LYD", ECurrencyName.LYD, "_LY", "ar_LY"),
MAD ("MAD", ECurrencyName.MAD, "_EH", "_MA", "ar_MA"),
MDL ("MDL", ECurrencyName.MDL, "_MD"),
MGA ("MGA", ECurrencyName.MGA, "_MG"),
MKD ("MKD", ECurrencyName.MKD, "_MK", "mk_MK"),
MMK ("MMK", ECurrencyName.MMK, "_MM"),
MNT ("MNT", ECurrencyName.MNT, "_MN"),
MOP ("MOP", ECurrencyName.MOP, "_MO"),
MRO ("MRO", ECurrencyName.MRO, "_MR"),
MUR ("MUR", ECurrencyName.MUR, "_MU"),
MVR ("MVR", ECurrencyName.MVR, "_MV"),
MWK ("MWK", ECurrencyName.MWK, "_MW"),
MXN ("MXN", ECurrencyName.MXN, "_MX", "es_MX"),
MYR ("MYR", ECurrencyName.MYR, "_MY", "ms_MY"),
MZN ("MZN", ECurrencyName.MZN, "_MZ"),
NAD ("NAD", ECurrencyName.NAD, "_NA"),
NGN ("NGN", ECurrencyName.NGN, "_NG"),
NIO ("NIO", ECurrencyName.NIO, "_NI", "es_NI"),
NOK ("NOK", ECurrencyName.NOK, "_BV", "_NO", "_SJ", "no_NO", "no_NO_NY"),
NPR ("NPR", ECurrencyName.NPR, "_NP"),
NZD ("NZD", ECurrencyName.NZD, "_CK", "_NU", "_NZ", "_PN", "_TK", "en_NZ"),
OMR ("OMR", ECurrencyName.OMR, "_OM", "ar_OM"),
PAB ("PAB", ECurrencyName.PAB, "_PA", "es_PA"),
PEN ("PEN", ECurrencyName.PEN, "_PE", "es_PE"),
PGK ("PGK", ECurrencyName.PGK, "_PG"),
PHP ("PHP", ECurrencyName.PHP, "_PH", "en_PH"),
PKR ("PKR", ECurrencyName.PKR, "_PK"),
PLN ("PLN", ECurrencyName.PLN, "_PL", "pl_PL"),
PYG ("PYG", ECurrencyName.PYG, "_PY", "es_PY"),
QAR ("QAR", ECurrencyName.QAR, "_QA", "ar_QA"),
RON ("RON", ECurrencyName.RON, "_RO", "ro_RO"),
RSD ("RSD", ECurrencyName.RSD, "_RS", "sr_RS"),
RUB ("RUB", ECurrencyName.RUB, "_RU", "ru_RU"),
RWF ("RWF", ECurrencyName.RWF, "_RW"),
SAR ("SAR", ECurrencyName.SAR, "_SA", "ar_SA"),
SBD ("SBD", ECurrencyName.SBD, "_SB"),
SCR ("SCR", ECurrencyName.SCR, "_SC"),
SDG ("SDG", ECurrencyName.SDG, "_SD", "ar_SD"),
SEK ("SEK", ECurrencyName.SEK, "_SE", "sv_SE"),
SGD ("SGD", ECurrencyName.SGD, "_SG", "en_SG", "zh_SG"),
SHP ("SHP", ECurrencyName.SHP, "_SH"),
SLL ("SLL", ECurrencyName.SLL, "_SL"),
SOS ("SOS", ECurrencyName.SOS, "_SO"),
SRD ("SRD", ECurrencyName.SRD, "_SR"),
SSP ("SSP", ECurrencyName.SSP, "_SS"),
STD ("STD", ECurrencyName.STD, "_ST"),
SVC ("SVC", ECurrencyName.SVC, "_SV", "es_SV"),
SYP ("SYP", ECurrencyName.SYP, "_SY", "ar_SY"),
SZL ("SZL", ECurrencyName.SZL, "_SZ"),
THB ("THB", ECurrencyName.THB, "_TH", "th_TH", "th_TH_TH"),
TJS ("TJS", ECurrencyName.TJS, "_TJ"),
TMT ("TMT", ECurrencyName.TMT, "_TM"),
TND ("TND", ECurrencyName.TND, "_TN", "ar_TN"),
TOP ("TOP", ECurrencyName.TOP, "_TO"),
TRY ("TRY", ECurrencyName.TRY, "_TR", "tr_TR"),
TTD ("TTD", ECurrencyName.TTD, "_TT"),
TWD ("TWD", ECurrencyName.TWD, "_TW", "zh_TW"),
TZS ("TZS", ECurrencyName.TZS, "_TZ"),
UAH ("UAH", ECurrencyName.UAH, "_UA", "uk_UA"),
UGX ("UGX", ECurrencyName.UGX, "_UG"),
USD ("USD",
ECurrencyName.USD,
"_AS",
"_BQ",
"_EC",
"_FM",
"_GU",
"_IO",
"_MH",
"_MP",
"_PR",
"_PW",
"_TC",
"_TL",
"_UM",
"_US",
"_VG",
"_VI",
"en_US",
"es_EC",
"es_PR",
"es_US"),
UYU ("UYU", ECurrencyName.UYU, "_UY", "es_UY"),
UZS ("UZS", ECurrencyName.UZS, "_UZ"),
VEF ("VEF", ECurrencyName.VEF, "_VE", "es_VE"),
VND ("VND", ECurrencyName.VND, "_VN", "vi_VN"),
VUV ("VUV", ECurrencyName.VUV, "_VU"),
WST ("WST", ECurrencyName.WST, "_WS"),
XAF ("XAF", ECurrencyName.XAF, "_CF", "_CG", "_CM", "_GA", "_GQ", "_TD"),
XCD ("XCD", ECurrencyName.XCD, "_AG", "_AI", "_DM", "_GD", "_KN", "_LC", "_MS", "_VC"),
XOF ("XOF", ECurrencyName.XOF, "_BF", "_BJ", "_CI", "_GW", "_ML", "_NE", "_SN", "_TG"),
XPF ("XPF", ECurrencyName.XPF, "_NC", "_PF", "_WF"),
YER ("YER", ECurrencyName.YER, "_YE", "ar_YE"),
ZAR ("ZAR", ECurrencyName.ZAR, "_ZA", "en_ZA"),
@Deprecated ZMK ("ZMK", true, ECurrencyName.ZMK, "_ZM"),
ZMW ("ZMW", true, ECurrencyName.ZMW, "_ZM"),
@Deprecated ZWL ("ZWL", true, ECurrencyName.ZWL, "_ZW");
/**
* The default rounding mode to be used for currency values. It may be
* overridden for each currency individually.
*/
public static final RoundingMode DEFAULT_ROUNDING_MODE = RoundingMode.HALF_EVEN;
/** The default currency */
public static final ECurrency DEFAULT_CURRENCY = EUR;
/** The default scale to be used if no JDK Currency is available */
public static final int DEFAULT_SCALE = 2;
private final String m_sID;
private final Currency m_aCurrency;
private final int m_nScale;
private final boolean m_bIsDeprecated;
private final IHasDisplayText m_aName;
private final ICommonsList m_aLocales = new CommonsArrayList <> ();
private final DecimalFormat m_aCurrencyFormat;
private final String m_sCurrencyPattern;
private final String m_sValuePattern;
private final DecimalFormat m_aValueFormat;
@CodingStyleguideUnaware
private RoundingMode m_eRoundingMode;
@Nonnull
@ReturnsMutableCopy
private static ICommonsList _getAsLocales (@Nonnull final String... aCountries)
{
return CollectionHelper.newListMapped (aCountries, sCountry -> LocaleCache.getInstance ().getLocale (sCountry));
}
private ECurrency (@Nonnull @Nonempty final String sCurrencyCode,
@Nonnull final ECurrencyName aName,
@Nonnull @Nonempty final String... aLocales)
{
this (sCurrencyCode, false, aName, aLocales);
}
private ECurrency (@Nonnull @Nonempty final String sCurrencyCode,
final boolean bIsDeprecated,
@Nonnull final ECurrencyName aName,
@Nonnull @Nonempty final String... aLocales)
{
ValueEnforcer.notEmpty (sCurrencyCode, "CurrencyCode");
ValueEnforcer.notNull (aName, "Name");
ValueEnforcer.notEmptyNoNullValue (aLocales, "Locales");
Locale aRelevantLocale = null;
for (final Locale aLocale : _getAsLocales (aLocales))
{
if (aLocale == null)
throw new IllegalArgumentException ("Passed locale is null!");
if (!CurrencyHelper.localeSupportsCurrencyRetrieval (aLocale))
throw new IllegalArgumentException ("Passed locale " + aLocale + " does not support currency retrieval!");
if (!m_aLocales.add (aLocale))
throw new IllegalArgumentException ("The locale " + aLocale + " is contained more than once.");
if (aRelevantLocale == null && aLocale.getLanguage ().length () > 0)
{
// Use the first locale with a language as the most relevant one
aRelevantLocale = aLocale;
}
}
if (m_aLocales.isEmpty ())
throw new IllegalArgumentException ("Passed currency is not valid in a single country (" +
Arrays.toString (aLocales) +
")");
if (aRelevantLocale == null)
{
// Fallback to the first locale
aRelevantLocale = m_aLocales.getFirst ();
}
m_sID = sCurrencyCode;
Currency aCurrency = null;
try
{
aCurrency = Currency.getInstance (sCurrencyCode);
}
catch (final IllegalArgumentException ex)
{
// Happens when an unsupported currency code is provided
LoggerFactory.getLogger (ECurrency.class).error ("Failed to resolve currency with currency code '" +
sCurrencyCode +
"' - " +
aName.getDisplayText (Locale.US));
}
m_aCurrency = aCurrency;
m_nScale = aCurrency == null ? DEFAULT_SCALE : aCurrency.getDefaultFractionDigits ();
m_bIsDeprecated = bIsDeprecated;
m_aName = aName;
// Note: Locale fr_FR formats locale with a trailing € whereas the locale
// de_DE formats the € at front!
m_aCurrencyFormat = (DecimalFormat) NumberFormat.getCurrencyInstance (aRelevantLocale);
// Extract value pattern from currency pattern (without currency symbol)
m_sCurrencyPattern = m_aCurrencyFormat.toPattern ();
String sVP = m_sCurrencyPattern;
sVP = StringHelper.removeAll (sVP, "\u00A4 ");
sVP = StringHelper.removeAll (sVP, " \u00A4");
sVP = StringHelper.removeAll (sVP, "\u00A4");
m_sValuePattern = sVP;
// Use the decimal symbols from the currency format
m_aValueFormat = new DecimalFormat (m_sValuePattern, m_aCurrencyFormat.getDecimalFormatSymbols ());
// By default the default rounding mode should be used
m_eRoundingMode = null;
}
/**
* @return The currency code of this currency used as the ID.
*/
@Nonnull
@Nonempty
public String getID ()
{
return m_sID;
}
public String getDisplayText (@Nonnull final Locale aContentLocale)
{
return m_aName.getDisplayText (aContentLocale);
}
/**
* @return this as {@link java.util.Currency}. May be null if the
* currency is not supported by the JDK! Before v3.3.8 the currency
* was non-null.
*/
@Nullable
public Currency getAsCurrency ()
{
return m_aCurrency;
}
@Nonnull
public String getCurrencySymbol ()
{
return m_aCurrencyFormat.getDecimalFormatSymbols ().getCurrencySymbol ();
}
/**
* @return true if this currency is deprecated and no longer
* exists.
*/
public boolean isDeprecated ()
{
return m_bIsDeprecated;
}
/**
* @return A list of all locales (as {@link Locale} objects) to which this
* currency applies.
*/
@Nonnull
@Nonempty
@ReturnsMutableCopy
public ICommonsList getAllMatchingLocales ()
{
return m_aLocales.getClone ();
}
/**
* @return The pattern to be used in {@link DecimalFormat} to format this
* currency. This pattern includes the currency string.
*/
@Nonnull
@Nonempty
public String getCurrencyPattern ()
{
return m_sCurrencyPattern;
}
/**
* @return The pattern to be used in {@link DecimalFormat} to format this
* currency. This pattern does NOT includes the currency string.
*/
@Nonnull
@Nonempty
public String getValuePattern ()
{
return m_sValuePattern;
}
/**
* @return The {@link DecimalFormat} used to format this currency. Always
* returns a copy of the contained formatter for thread-safety and
* modification.
*/
@Nonnull
public DecimalFormat getCurrencyFormat ()
{
// DecimalFormat is not thread safe - clone!
return (DecimalFormat) m_aCurrencyFormat.clone ();
}
@Nonnull
public String getCurrencyFormatted (@Nonnull final BigDecimal aValue)
{
return getCurrencyFormat ().format (aValue);
}
@Nonnull
public String getCurrencyFormatted (@Nonnull final BigDecimal aValue, @Nonnegative final int nFractionDigits)
{
final DecimalFormat aFormat = getCurrencyFormat ();
aFormat.setMaximumFractionDigits (nFractionDigits);
return aFormat.format (aValue);
}
/**
* @return The {@link DecimalFormat} object that formats an object like the
* {@link #getCurrencyFormat()} but without the currency sign. Always
* returns a copy of the contained formatter for thread-safety and
* modification.
*/
@Nonnull
public DecimalFormat getValueFormat ()
{
// DecimalFormat is not thread safe - clone!
return (DecimalFormat) m_aValueFormat.clone ();
}
@Nonnull
public String getValueFormatted (@Nonnull final BigDecimal aValue)
{
return getValueFormat ().format (aValue);
}
@Nonnull
public String getValueFormatted (@Nonnull final BigDecimal aValue, @Nonnegative final int nFractionDigits)
{
final DecimalFormat aFormat = getValueFormat ();
aFormat.setMaximumFractionDigits (nFractionDigits);
return aFormat.format (aValue);
}
/**
* @return The minimum fraction digits to be used for formatting.
*/
@Nonnegative
public int getMinimumFractionDigits ()
{
return m_aCurrencyFormat.getMinimumFractionDigits ();
}
/**
* Set the minimum fraction digits to be used for formatting. Applies to the
* currency-formatting and the value-formatting.
*
* @param nDecimals
* The new minimum fraction digits. May not be negative.
*/
public void setMinimumFractionDigits (@Nonnegative final int nDecimals)
{
ValueEnforcer.isGE0 (nDecimals, "Decimals");
m_aCurrencyFormat.setMinimumFractionDigits (nDecimals);
m_aValueFormat.setMinimumFractionDigits (nDecimals);
}
@Nullable
public EDecimalSeparator getDecimalSeparator ()
{
return EDecimalSeparator.getFromCharOrNull (m_aCurrencyFormat.getDecimalFormatSymbols ().getDecimalSeparator ());
}
@Nullable
public EGroupingSeparator getGroupingSeparator ()
{
return EGroupingSeparator.getFromCharOrNull (m_aCurrencyFormat.getDecimalFormatSymbols ().getGroupingSeparator ());
}
/**
* Adopt the passed text value according to the requested decimal separator.
*
* @param sTextValue
* The text to be manipulated. May be null.
* @param eDecimalSep
* The decimal separator that is required. May not be null
* .
* @param eGroupingSep
* The grouping separator that is required. May not be
* null .
* @return The manipulated text so that it matches the required decimal
* separator or the original text
*/
@Nullable
private static String _getTextValueForDecimalSeparator (@Nullable final String sTextValue,
@Nonnull final EDecimalSeparator eDecimalSep,
@Nonnull final EGroupingSeparator eGroupingSep)
{
ValueEnforcer.notNull (eDecimalSep, "DecimalSeparator");
ValueEnforcer.notNull (eGroupingSep, "GroupingSeparator");
final String ret = StringHelper.trim (sTextValue);
// Replace only, if the desired decimal separator is not present
if (ret != null && ret.indexOf (eDecimalSep.getChar ()) < 0)
switch (eDecimalSep)
{
case COMMA:
{
// Decimal separator is a ","
if (ret.indexOf ('.') > -1 && eGroupingSep.getChar () != '.')
{
// Currency expects "," but user passed "."
return StringHelper.replaceAll (ret, '.', eDecimalSep.getChar ());
}
break;
}
case POINT:
{
// Decimal separator is a "."
if (ret.indexOf (',') > -1 && eGroupingSep.getChar () != ',')
{
// Pattern contains no "," but value contains ","
return StringHelper.replaceAll (ret, ',', eDecimalSep.getChar ());
}
break;
}
default:
throw new IllegalStateException ("Unexpected decimal separator [" + eDecimalSep + "]");
}
return ret;
}
/**
* Try to parse a string value formatted by the {@link NumberFormat} object
* returned from {@link #getCurrencyFormat()}. E.g. € 5,00
*
* @param sTextValue
* The string value. It will be trimmed, and the decimal separator will
* be adopted.
* @param aDefault
* The default value to be used in case parsing fails. May be
* null.
* @return The {@link BigDecimal} value matching the string value or the
* passed default value.
*/
@Nullable
public BigDecimal parseCurrencyFormat (@Nullable final String sTextValue, @Nullable final BigDecimal aDefault)
{
final DecimalFormat aCurrencyFormat = getCurrencyFormat ();
// Adopt the decimal separator
final String sRealTextValue = _getTextValueForDecimalSeparator (sTextValue,
getDecimalSeparator (),
getGroupingSeparator ());
return CurrencyHelper.parseCurrency (sRealTextValue, aCurrencyFormat, aDefault, getRoundingMode ());
}
/**
* Try to parse a string value formatted by the {@link NumberFormat} object
* returned from {@link #getCurrencyFormat()}. E.g. € 5,00
*
* @param sTextValue
* The string value. It will be parsed unmodified!
* @param aDefault
* The default value to be used in case parsing fails. May be
* null.
* @return The {@link BigDecimal} value matching the string value or the
* passed default value.
*/
@Nullable
public BigDecimal parseCurrencyFormatUnchanged (@Nullable final String sTextValue,
@Nullable final BigDecimal aDefault)
{
final DecimalFormat aCurrencyFormat = getCurrencyFormat ();
return CurrencyHelper.parseCurrency (sTextValue, aCurrencyFormat, aDefault, getRoundingMode ());
}
/**
* Try to parse a string value formatted by the {@link DecimalFormat} object
* returned from {@link #getValueFormat()}
*
* @param sTextValue
* The string value. It will be trimmed, and the decimal separator will
* be adopted.
* @param aDefault
* The default value to be used in case parsing fails. May be
* null.
* @return The {@link BigDecimal} value matching the string value or the
* passed default value.
*/
@Nullable
public BigDecimal parseValueFormat (@Nullable final String sTextValue, @Nullable final BigDecimal aDefault)
{
final DecimalFormat aValueFormat = getValueFormat ();
// Adopt the decimal separator
final String sRealTextValue = _getTextValueForDecimalSeparator (sTextValue,
getDecimalSeparator (),
getGroupingSeparator ());
return CurrencyHelper.parseCurrency (sRealTextValue, aValueFormat, aDefault, getRoundingMode ());
}
/**
* Try to parse a string value formatted by the {@link DecimalFormat} object
* returned from {@link #getValueFormat()}
*
* @param sTextValue
* The string value. It will be parsed unmodified!
* @param aDefault
* The default value to be used in case parsing fails. May be
* null.
* @return The {@link BigDecimal} value matching the string value or the
* passed default value.
*/
@Nullable
public BigDecimal parseValueFormatUnchanged (@Nullable final String sTextValue, @Nullable final BigDecimal aDefault)
{
final DecimalFormat aValueFormat = getValueFormat ();
return CurrencyHelper.parseCurrency (sTextValue, aValueFormat, aDefault, getRoundingMode ());
}
/**
* @return The scaling to be used for BigDecimal operations. Always ≥ 0. If
* no underlying JDK currency is present, {@value #DEFAULT_SCALE} is
* returned.
*/
@Nonnegative
public int getScale ()
{
return m_nScale;
}
/**
* Special currency division method. This method solves the problem of
* dividing "1/3" as it would result in a never ending series of
* "0.33333333..." which results in an {@link ArithmeticException} thrown by
* the divide method!
* The default scaling of this currency is used.
*
* @param aDividend
* Dividend
* @param aDivisor
* Divisor
* @return The divided value with the correct scaling
*/
@Nonnull
@CheckReturnValue
public BigDecimal getDivided (@Nonnull final BigDecimal aDividend, @Nonnull final BigDecimal aDivisor)
{
return getDivided (aDividend, aDivisor, getScale ());
}
/**
* Special currency division method. This method solves the problem of
* dividing "1/3" as it would result in a never ending series of
* "0.33333333..." which results in an {@link ArithmeticException} thrown by
* the divide method!
* This method takes a custom scaling. If the default scaling of this currency
* should be used, than {@link #getDivided(BigDecimal, BigDecimal)} should be
* used instead.
*
* @param aDividend
* Dividend
* @param aDivisor
* Divisor
* @param nFractionDigits
* A custom scaling to be used.
* @return The divided value with the provided scaling
*/
@Nonnull
@CheckReturnValue
public BigDecimal getDivided (@Nonnull final BigDecimal aDividend,
@Nonnull final BigDecimal aDivisor,
@Nonnegative final int nFractionDigits)
{
ValueEnforcer.notNull (aDividend, "Dividend");
ValueEnforcer.notNull (aDivisor, "Divisor");
return aDividend.divide (aDivisor, nFractionDigits, getRoundingMode ());
}
/**
* Get the passed value rounded to the appropriate number of fraction digits,
* based on this currencies default fraction digits.
* The default scaling of this currency is used.
*
* @param aValue
* The value to be rounded. May not be null.
* @return The rounded value. Never null.
*/
@Nonnull
public BigDecimal getRounded (@Nonnull final BigDecimal aValue)
{
ValueEnforcer.notNull (aValue, "Value");
return aValue.setScale (getScale (), getRoundingMode ());
}
/**
* Get the passed value rounded to the appropriate number of fraction digits,
* based on this currencies default fraction digits.
* This method takes a custom scaling. If the default scaling of this currency
* should be used, than {@link #getRounded(BigDecimal)} should be used
* instead.
*
* @param aValue
* The value to be rounded. May not be null.
* @param nFractionDigits
* A custom scaling to be used.
* @return The rounded value. Never null.
*/
@Nonnull
public BigDecimal getRounded (@Nonnull final BigDecimal aValue, @Nonnegative final int nFractionDigits)
{
ValueEnforcer.notNull (aValue, "Value");
return aValue.setScale (nFractionDigits, getRoundingMode ());
}
/**
* @return The rounding mode of this currency. If non is specified,
* {@link #DEFAULT_ROUNDING_MODE} is returned instead. May not be
* null.
*/
@Nonnull
public RoundingMode getRoundingMode ()
{
return m_eRoundingMode != null ? m_eRoundingMode : DEFAULT_ROUNDING_MODE;
}
/**
* Change the rounding mode of this currency.
*
* @param eRoundingMode
* The rounding mode to be used. May not be null.
*/
public void setRoundingMode (@Nonnull final RoundingMode eRoundingMode)
{
m_eRoundingMode = ValueEnforcer.notNull (eRoundingMode, "RoundingMode");
}
@Nonnull
@ReturnsMutableCopy
public static ICommonsList getAllCurrencies ()
{
return getAllCurrencies (filterNotDeprecated ());
}
@Nonnull
@ReturnsMutableCopy
public static ICommonsList getAllCurrencies (@Nullable final Predicate aFilter)
{
return ArrayHelper.getAll (values (), aFilter);
}
@Nullable
public static ECurrency findFirst (@Nullable final Predicate aFilter)
{
return ArrayHelper.findFirst (values (), aFilter);
}
@Nullable
public static ECurrency getFromIDOrNull (@Nullable final String sCurrencyCode)
{
return EnumHelper.getFromIDOrNull (ECurrency.class, sCurrencyCode);
}
@Nullable
public static ECurrency getFromIDOrDefault (@Nullable final String sCurrencyCode, @Nullable final ECurrency eDefault)
{
return EnumHelper.getFromIDOrDefault (ECurrency.class, sCurrencyCode, eDefault);
}
@Nullable
public static ECurrency getFromLocaleOrNull (@Nullable final Locale aLocale)
{
if (aLocale == null)
return null;
return findFirst (filterNotDeprecated ().and (filterContainsLocale (aLocale)));
}
@Nonnull
public static IFilter filterDeprecated ()
{
return eCurrency -> eCurrency.isDeprecated ();
}
@Nonnull
public static IFilter filterNotDeprecated ()
{
return eCurrency -> !eCurrency.isDeprecated ();
}
@Nonnull
public static IFilter filterContainsLocale (@Nonnull final Locale aLocale)
{
ValueEnforcer.notNull (aLocale, "Locale");
return eCurrency -> eCurrency.m_aLocales.contains (aLocale);
}
@Nonnull
public static IFilter filterLocaleAny (@Nonnull final IFilter aLocaleFilter)
{
ValueEnforcer.notNull (aLocaleFilter, "LocaleFilter");
return eCurrency -> eCurrency.m_aLocales.containsAny (aLocaleFilter);
}
@Nonnull
public static IFilter filterLocaleAll (@Nonnull final IFilter aLocaleFilter)
{
ValueEnforcer.notNull (aLocaleFilter, "LocaleFilter");
return eCurrency -> eCurrency.m_aLocales.containsOnly (aLocaleFilter);
}
}
