JSR 354定義了一個(gè)用于處理貨幣和貨幣的新Java API，計(jì)劃將其包含在Java 9中。在本文中，我們將研究參考實(shí)現(xiàn)的當(dāng)前狀態(tài)：
JavaMoney 。

就像我關(guān)于Java 8日期/時(shí)間API的帖子一樣，該帖子將主要由顯示新API的代碼驅(qū)動(dòng)。

但是在開(kāi)始之前，我想引用一下規(guī)范中的一小部分，以總結(jié)一下此新API的動(dòng)機(jī)：

貨幣價(jià)值是許多應(yīng)用程序的關(guān)鍵功能，但是JDK提供的支持很少或沒(méi)有。 現(xiàn)有的java.util.Currency類(lèi)嚴(yán)格來(lái)說(shuō)是一種用于表示當(dāng)前ISO 4217貨幣的結(jié)構(gòu)，但不是關(guān)聯(lián)值或自定義貨幣。 JDK還不支持貨幣算術(shù)或貨幣轉(zhuǎn)換，也不支持代表貨幣金額的標(biāo)準(zhǔn)值類(lèi)型。

如果使用Maven，則可以通過(guò)將以下依賴(lài)項(xiàng)添加到項(xiàng)目中來(lái)輕松嘗試參考實(shí)現(xiàn)的當(dāng)前狀態(tài)：

<dependency><groupId>org.javamoney</groupId><artifactId>moneta</artifactId><version>0.9</version> </dependency>

所有規(guī)范類(lèi)和接口都位于javax.money。*包中。

我們將從兩個(gè)核心接口CurrencyUnit和MonetaryAmount開(kāi)始。 之后，我們將研究匯率，貨幣轉(zhuǎn)換和格式。

貨幣單位和貨幣金額

CurrencyUnit為貨幣建模。 CurrencyUnit與現(xiàn)有的java.util.Currency類(lèi)非常相似，不同之處在于它允許自定義實(shí)現(xiàn)。 根據(jù)規(guī)范，java.util.Currency應(yīng)該可以實(shí)現(xiàn)CurrencyUnit。 可以使用MonetaryCurrencies工廠獲取CurrencyUnit實(shí)例：

//?getting?CurrencyUnits?by?currency?code CurrencyUnit?euro?=?MonetaryCurrencies.getCurrency("EUR"); CurrencyUnit?usDollar?=?MonetaryCurrencies.getCurrency("USD");//?getting?CurrencyUnits?by?locale CurrencyUnit?yen?=?MonetaryCurrencies.getCurrency(Locale.JAPAN); CurrencyUnit?canadianDollar?=?MonetaryCurrencies.getCurrency(Locale.CANADA);

MontetaryAmount表示貨幣金額的具體數(shù)字表示。 MonetaryAmount始終綁定到CurrencyUnit。 與CurrencyUnit一樣，MonetaryAmount是支持不同實(shí)現(xiàn)的接口。 CurrencyUnit和MonetaryAmount實(shí)現(xiàn)必須是不可變的，線程安全的，可序列化的和可比較的。

//?get?MonetaryAmount?from?CurrencyUnit CurrencyUnit?euro?=?MonetaryCurrencies.getCurrency("EUR"); MonetaryAmount?fiveEuro?=?Money.of(5,?euro);//?get?MonetaryAmount?from?currency?code MonetaryAmount?tenUsDollar?=?Money.of(10,?"USD");//?FastMoney?is?an?alternative?MonetaryAmount?factory?that?focuses?on?performance MonetaryAmount?sevenEuro?=?FastMoney.of(7,?euro);

Money和FastMoney是JavaMoney的兩個(gè)MonetaryAmount實(shí)現(xiàn)。 Money是使用BigDecimal存儲(chǔ)數(shù)字值的默認(rèn)實(shí)現(xiàn)。 FastMoney是一種將金額存儲(chǔ)在長(zhǎng)字段中的替代實(shí)現(xiàn)。 根據(jù)文檔，與Money相比，FastMoney的運(yùn)行速度快10到15倍。 但是，FastMoney受long類(lèi)型的大小和精度的限制。

請(qǐng)注意，Money和FastMoney是實(shí)現(xiàn)特定的類(lèi)（位于org.javamoney.moneta。*而不是javax.money。*中）。 如果要避免實(shí)現(xiàn)特定的類(lèi)，則必須獲取MonetaryAmountFactory來(lái)創(chuàng)建MonetaryAmount實(shí)例：

MonetaryAmount?specAmount?=?MonetaryAmounts.getDefaultAmountFactory().setNumber(123.45).setCurrency("USD").create();

如果實(shí)現(xiàn)類(lèi)，貨幣單位和數(shù)值相等，則認(rèn)為兩個(gè)MontetaryAmount實(shí)例相等：

MonetaryAmount?oneEuro?=?Money.of(1,?MonetaryCurrencies.getCurrency("EUR")); boolean?isEqual?=?oneEuro.equals(Money.of(1,?"EUR"));?//?true boolean?isEqualFast?=?oneEuro.equals(FastMoney.of(1,?"EUR"));?//?false

MonetaryAmount具有多種方法，可用于訪問(wèn)分配的貨幣，數(shù)字量，其精度等：

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;

使用MonetaryAmounts

可以使用MonetaryAmount執(zhí)行數(shù)學(xué)運(yùn)算：

MonetaryAmount?twelveEuro?=?fiveEuro.add(sevenEuro);?//?"EUR?12" MonetaryAmount?twoEuro?=?sevenEuro.subtract(fiveEuro);?//?"EUR?2" MonetaryAmount?sevenPointFiveEuro?=?fiveEuro.multiply(1.5);?//?"EUR?7.5"//?MonetaryAmount?can?have?a?negative?NumberValue MonetaryAmount?minusTwoEuro?=?fiveEuro.subtract(sevenEuro);?//?"EUR?-2"//?some?useful?utility?methods boolean?greaterThan?=?sevenEuro.isGreaterThan(fiveEuro);?//?true boolean?positive?=?sevenEuro.isPositive();?//?true boolean?zero?=?sevenEuro.isZero();?//?false//?Note?that?MonetaryAmounts?need?to?have?the?same?CurrencyUnit?to?do?mathematical?operations //?this?fails?with:?javax.money.MonetaryException:?Currency?mismatch:?EUR/USD fiveEuro.add(tenUsDollar);

四舍五入是使用金錢(qián)時(shí)的另一個(gè)重要部分。 可以使用舍入運(yùn)算符舍入MonetaryAmount：

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

在這里，12.3456美元使用該貨幣的默認(rèn)舍入取整。

當(dāng)使用MonetaryAmounts的集合時(shí)，可以使用一些不錯(cuò)的實(shí)用程序方法進(jìn)行過(guò)濾，排序和分組。 這些方法可以與Java 8 Stream API一起使用。

考慮以下集合：

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"));

現(xiàn)在，我們可以按CurrencyUnit過(guò)濾金額：

CurrencyUnit?yen?=?MonetaryCurrencies.getCurrency("JPY"); CurrencyUnit?dollar?=?MonetaryCurrencies.getCurrency("USD");//?filter?by?currency,?get?only?dollars //?result?is?[USD?18,?USD?7,?USD?42] List<MonetaryAmount>?onlyDollar?=?amounts.stream().filter(MonetaryFunctions.isCurrency(dollar)).collect(Collectors.toList());//?filter?by?currency,?get?only?dollars?and?yen //?[USD?18,?USD?7,?JPY?13.37,?USD?42] List<MonetaryAmount>?onlyDollarAndYen?=?amounts.stream().filter(MonetaryFunctions.isCurrency(dollar,?yen)).collect(Collectors.toList());

我們還可以過(guò)濾出小于或大于特定閾值的MonetaryAmounts：

MonetaryAmount?tenDollar?=?Money.of(10,?dollar);//?[USD?42,?USD?18] List<MonetaryAmount>?greaterThanTenDollar?=?amounts.stream().filter(MonetaryFunctions.isCurrency(dollar)).filter(MonetaryFunctions.isGreaterThan(tenDollar)).collect(Collectors.toList());

排序的工作方式類(lèi)似：

//?Sorting?dollar?values?by?number?value //?[USD?7,?USD?18,?USD?42] List<MonetaryAmount>?sortedByAmount?=?onlyDollar.stream().sorted(MonetaryFunctions.sortNumber()).collect(Collectors.toList());//?Sorting?by?CurrencyUnit //?[EUR?2,?JPY?13.37,?USD?42,?USD?7,?USD?18] List<MonetaryAmount>?sortedByCurrencyUnit?=?amounts.stream().sorted(MonetaryFunctions.sortCurrencyUnit()).collect(Collectors.toList());

分組功能：

//?Grouping?by?CurrencyUnit //?{USD=[USD?42,?USD?7,?USD?18],?EUR=[EUR?2],?JPY=[JPY?13.37]} Map<CurrencyUnit,?List<MonetaryAmount>>?groupedByCurrency?=?amounts.stream().collect(MonetaryFunctions.groupByCurrencyUnit());//?Grouping?by?summarizing?MonetaryAmounts Map<CurrencyUnit,?MonetarySummaryStatistics>?summary?=?amounts.stream().collect(MonetaryFunctions.groupBySummarizingMonetary()).get();//?get?summary?for?CurrencyUnit?USD MonetarySummaryStatistics?dollarSummary?=?summary.get(dollar); MonetaryAmount?average?=?dollarSummary.getAverage();?//?"USD?22.333333333333333333.." MonetaryAmount?min?=?dollarSummary.getMin();?//?"USD?7" MonetaryAmount?max?=?dollarSummary.getMax();?//?"USD?42" MonetaryAmount?sum?=?dollarSummary.getSum();?//?"USD?67" long?count?=?dollarSummary.getCount();?//?3

MonetaryFunctions還提供歸約函數(shù)，可用于獲取MonetaryAmount集合的最大值，最小值和總和：

List<MonetaryAmount>?amounts?=?new?ArrayList<>(); amounts.add(Money.of(10,?"EUR")); amounts.add(Money.of(7.5,?"EUR")); amounts.add(Money.of(12,?"EUR"));Optional<MonetaryAmount>?max?=?amounts.stream().reduce(MonetaryFunctions.max());?//?"EUR?7.5" Optional<MonetaryAmount>?min?=?amounts.stream().reduce(MonetaryFunctions.min());?//?"EUR?12" Optional<MonetaryAmount>?sum?=?amounts.stream().reduce(MonetaryFunctions.sum());?//?"EUR?29.5"

自定義MonetaryAmount操作

MonetaryAmount提供了一個(gè)很好的擴(kuò)展點(diǎn)，稱(chēng)為MonetaryOperator。 MonetaryOperator是一個(gè)功能接口，它將MonetaryAmount作為輸入并根據(jù)輸入創(chuàng)建一個(gè)新的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

一些標(biāo)準(zhǔn)API功能被實(shí)現(xiàn)為MonetaryOperator。 例如，我們?cè)谏厦婵吹降纳崛牍δ鼙粚?shí)現(xiàn)為MonetaryOperator。

匯率

可以使用ExchangeRateProvider獲得貨幣匯率。 JavaMoney帶有多個(gè)不同的ExchangeRateProvider實(shí)現(xiàn)。 兩個(gè)最重要的實(shí)現(xiàn)是ECBCurrentRateProvider和IMFRateProvider。

ECBCurrentRateProvider查詢(xún)歐洲中央銀行（ECB）數(shù)據(jù)供稿以獲取當(dāng)前匯率，而IMFRateProvider使用國(guó)際貨幣基金組織（IMF）轉(zhuǎn)換率。

//?get?the?default?ExchangeRateProvider?(CompoundRateProvider) ExchangeRateProvider?exchangeRateProvider?=?MonetaryConversions.getExchangeRateProvider();//?get?the?names?of?the?default?provider?chain //?[IDENT,?ECB,?IMF,?ECB-HIST] List<String>?defaultProviderChain?=?MonetaryConversions.getDefaultProviderChain();//?get?a?specific?ExchangeRateProvider?(here?ECB) ExchangeRateProvider?ecbExchangeRateProvider?=?MonetaryConversions.getExchangeRateProvider("ECB");

如果未請(qǐng)求特定的ExchangeRateProvider，則將返回CompoundRateProvider。 CompoundRateProvider將匯率請(qǐng)求委托給一系列ExchangeRateProviders，并從第一個(gè)返回足夠結(jié)果的提供程序返回結(jié)果。

//?get?the?exchange?rate?from?euro?to?us?dollar ExchangeRate?rate?=?exchangeRateProvider.getExchangeRate("EUR",?"USD");NumberValue?factor?=?rate.getFactor();?//?1.2537?(at?time?writing) CurrencyUnit?baseCurrency?=?rate.getBaseCurrency();?//?EUR CurrencyUnit?targetCurrency?=?rate.getCurrency();?//?USD

貨幣轉(zhuǎn)換

貨幣之間的轉(zhuǎn)換是通過(guò)從ExchangeRateProviders獲得的CurrencyConversions完成的：

//?get?the?CurrencyConversion?from?the?default?provider?chain CurrencyConversion?dollarConversion?=?MonetaryConversions.getConversion("USD");//?get?the?CurrencyConversion?from?a?specific?provider CurrencyConversion?ecbDollarConversion?=?ecbExchangeRateProvider.getCurrencyConversion("USD");MonetaryAmount?tenEuro?=?Money.of(10,?"EUR");//?convert?10?euro?to?us?dollar? MonetaryAmount?inDollar?=?tenEuro.with(dollarConversion); //?"USD?12.537"?(at?the?time?writing)

請(qǐng)注意，CurrencyConversion實(shí)現(xiàn)MonetaryOperator。 像其他運(yùn)算符一樣，可以使用MonetaryAmount.with（）來(lái)應(yīng)用它。

格式化和解析

MonetaryAmounts可以使用MonetaryAmountFormat從字符串解析/格式化為字符串：

//?formatting?by?locale?specific?formats MonetaryAmountFormat?germanFormat?=?MonetaryFormats.getAmountFormat(Locale.GERMANY); MonetaryAmountFormat?usFormat?=?MonetaryFormats.getAmountFormat(Locale.CANADA);MonetaryAmount?amount?=?Money.of(12345.67,?"USD");String?usFormatted?=?usFormat.format(amount);?//?"USD12,345.67" String?germanFormatted?=?germanFormat.format(amount);?//?12.345,67?USD//?A?MonetaryAmountFormat?can?also?be?used?to?parse?MonetaryAmounts?from?strings MonetaryAmount?parsed?=?germanFormat.parse("12,4?USD");

使用AmountFormatQueryBuilder可以創(chuàng)建自定義格式：

//?Creating?a?custom?MonetaryAmountFormat MonetaryAmountFormat?customFormat?=?MonetaryFormats.getAmountFormat(AmountFormatQueryBuilder.of(Locale.US).set(CurrencyStyle.NAME).set("pattern",?"00,00,00,00.00?¤").build());//?results?in?"00,01,23,45.67?US?Dollar" String?formatted?=?customFormat.format(amount);

請(qǐng)注意，¤符號(hào)（\ u00A）用作模式字符串內(nèi)的貨幣占位符。

摘要

我們研究了新的Money and Currency API的許多部分。 該實(shí)現(xiàn)看起來(lái)已經(jīng)很可靠了（但是肯定需要更多文檔）。 我期待在Java 9中看到此API！

• 您可以在GitHub上找到此處顯示的所有示例。

翻譯自: https://www.javacodegeeks.com/2014/12/looking-into-the-java-9-money-and-currency-api-jsr-354.html

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來(lái)咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的研究Java 9 Money and Currency API（JSR 354）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。