JSR 354: API і гроші та валюти
JSR 354 надає API для представлення, транспортування та проведення комплексних розрахунків за допомогою грошей і валюти. Ви можете завантажити його за посиланням:
JSR 354: Завантажити API грошей та валюти
Специфікація складається з наступних речей:
- API для обробки, наприклад, грошових сум та валют
- API для підтримки взаємозамінних реалізацій
- Фабрики для створення екземплярів класів реалізації
- Функціональність для розрахунків, перерахунку та форматування грошових сум
- Java API для роботи з грошима та валютами, який планується включити в Java 9.
- Усі класи специфікацій та інтерфейси розміщені в пакеті javax.money. *.
Приклади прикладів JSR 354: API грошей та валюти:
Приклад створення MonetaryAmount та друку на консолі виглядає приблизно так:
MonetaryAmountFactory<?> amountFactory = Monetary.getDefaultAmountFactory();
MonetaryAmount monetaryAmount = amountFactory.setCurrency(Monetary.getCurrency("EUR")).setNumber(12345.67).create();
MonetaryAmountFormat format = MonetaryFormats.getAmountFormat(Locale.getDefault());
System.out.println(format.format(monetaryAmount));
Використовуючи API реалізації посилань, необхідний код набагато простіший:
MonetaryAmount monetaryAmount = Money.of(12345.67, "EUR");
MonetaryAmountFormat format = MonetaryFormats.getAmountFormat(Locale.getDefault());
System.out.println(format.format(monetaryAmount));
API також підтримує розрахунки з MonetaryAmounts:
MonetaryAmount monetaryAmount = Money.of(12345.67, "EUR");
MonetaryAmount otherMonetaryAmount = monetaryAmount.divide(2).add(Money.of(5, "EUR"));
ВалютаУніта та Грошова сума
// getting CurrencyUnits by locale
CurrencyUnit yen = MonetaryCurrencies.getCurrency(Locale.JAPAN);
CurrencyUnit canadianDollar = MonetaryCurrencies.getCurrency(Locale.CANADA);
MonetaryAmount має різні методи, що дозволяють отримати доступ до призначеної валюти, числову суму, її точність та багато іншого:
MonetaryAmount monetaryAmount = Money.of(123.45, euro);
CurrencyUnit currency = monetaryAmount.getCurrency();
NumberValue numberValue = monetaryAmount.getNumber();
int intValue = numberValue.intValue(); // 123
double doubleValue = numberValue.doubleValue(); // 123.45
long fractionDenominator = numberValue.getAmountFractionDenominator(); // 100
long fractionNumerator = numberValue.getAmountFractionNumerator(); // 45
int precision = numberValue.getPrecision(); // 5
// NumberValue extends java.lang.Number.
// So we assign numberValue to a variable of type Number
Number number = numberValue;
Грошові суми можна округлити за допомогою оператора округлення:
CurrencyUnit usd = MonetaryCurrencies.getCurrency("USD");
MonetaryAmount dollars = Money.of(12.34567, usd);
MonetaryOperator roundingOperator = MonetaryRoundings.getRounding(usd);
MonetaryAmount roundedDollars = dollars.with(roundingOperator); // USD 12.35
Під час роботи з колекціями MonetaryAmounts доступні деякі приємні корисні методи фільтрації, сортування та групування.
List<MonetaryAmount> amounts = new ArrayList<>();
amounts.add(Money.of(2, "EUR"));
amounts.add(Money.of(42, "USD"));
amounts.add(Money.of(7, "USD"));
amounts.add(Money.of(13.37, "JPY"));
amounts.add(Money.of(18, "USD"));
Спеціальні операції MonetaryAmount
// A monetary operator that returns 10% of the input MonetaryAmount
// Implemented using Java 8 Lambdas
MonetaryOperator tenPercentOperator = (MonetaryAmount amount) -> {
BigDecimal baseAmount = amount.getNumber().numberValue(BigDecimal.class);
BigDecimal tenPercent = baseAmount.multiply(new BigDecimal("0.1"));
return Money.of(tenPercent, amount.getCurrency());
};
MonetaryAmount dollars = Money.of(12.34567, "USD");
// apply tenPercentOperator to MonetaryAmount
MonetaryAmount tenPercentDollars = dollars.with(tenPercentOperator); // USD 1.234567
Ресурси:
Обробка грошей і валют на Java за допомогою JSR 354
Переглядаючи API 9 грошей та валюти Java 9 (JSR 354)
Див. Також: JSR 354 - Валюта та гроші