Java 9中新的货币API

2015-1-9 09:00| 发布者: joejoe0332| 查看: 3837| 评论: 0|原作者: Java译站|来自: Java译站

摘要: 此前，Oracle公布Java 9首个增强计划集（众所周知的JEPs）确定会在2016年早些时候发布。而目前，JSR 354定义了一套新的Java货币API，计划会在Java 9中正式引入。JSR 354定义了一套新的Java货币API，计划会在Java 9中 ...

MonetaryFunctions还提供了归约函数，可以用来获取最大值，最小值，以及求和：

[java] view plaincopy
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()); //  

自定义的MonetaryAmount操作

MonetaryAmount还提供了一个非常友好的扩展点叫作MonetaryOperator。MonetaryOperator是一个函数式接口，它接收一个MonetaryAmount入参并返回一个新的MonetaryAmount对象。

[java] view plaincopy
// 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  

标准的API特性都是通过MonetaryOperator的接口来实现的。比方说，前面看到的舍入操作就是以MonetaryOperator接口的形式来提供的。

汇率

货币兑换率可以通过ExchangeRateProvider来获取。JavaMoney自带了多个不同的ExchangeRateProvider的实现。其中最重要的两个是ECBCurrentRateProvider与 IMFRateProvider。

ECBCurrentRateProvider查询的是欧洲中央银行(European Central Bank,ECB)的数据而IMFRateProvider查询的是国际货币基金组织（International Monetary Fund，IMF）的汇率。

[java] view plaincopy
// 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");  

如果没有指定ExchangeRateProvider的话返回的就是CompoundRateProvider。CompoundRateProvider会将汇率转换请求委派给一个ExchangeRateProvider链并将第一个返回准确结果的提供商的数据返回。

[java] view plaincopy
// 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  

货币转换

不同货币间的转换可以通过ExchangeRateProvider返回的CurrencyConversions来完成。

[java] view plaincopy
// 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)  

请注意CurrencyConversion也实现了MonetaryOperator接口。正如其它操作一样，它也能通过MonetaryAmount.with()方法来调用。

格式化及解析

MonetaryAmount可以通过MonetaryAmountFormat来与字符串进行解析/格式化。

[java] view plaincopy
// 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来生成自定义的格式。

[java] view plaincopy
// 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);  