org.javamoney.moneta.convert

Class ECBHistoricRateProvider

java.lang.Object

org.javamoney.moneta.spi.base.BaseExchangeRateProvider

org.javamoney.moneta.spi.AbstractRateProvider

org.javamoney.moneta.convert.ECBHistoricRateProvider

All Implemented Interfaces:

ExchangeRateProvider, LoaderService.LoaderListener

public class ECBHistoricRateProvider
extends AbstractRateProvider

This class implements an ExchangeRateProvider that loads data from the European Central Bank data feed (XML). It loads the current exchange rates, as well as historic rates for the past 1500 days. The provider loads all data up to 1999 into its historic data cache. The default date is yesterday or the most recent day of week. To uses exchange rate from a specific date, you can use this way: CurrencyUnit termCurrency = ...; LocalDate localDate = ...; ConversionQuery conversionQuery = ConversionQueryBuilder.of().setTermCurrency(euro).set(localDate).build();v CurrencyConversion currencyConversion = provider.getCurrencyConversion(conversionQuery); MonetaryAmount money = ...; MonetaryAmount result = currencyConversion.apply(money);

Author:

Anatole Tresch, Werner Keil, otaviojava

Field Summary

Fields

Modifier and Type	Field and Description
static CurrencyUnit	BASE_CURRENCY Base currency of the loaded rates is always EUR.
protected CountDownLatch	loadLock
protected String	loadState
protected Map<LocalDate,Map<String,ExchangeRate>>	rates Historic exchange rates, rate timestamp as UTC long.

Fields inherited from class org.javamoney.moneta.spi.AbstractRateProvider

LOGGER

Constructor Summary

Constructors

Constructor and Description
ECBHistoricRateProvider()

Method Summary

Modifier and Type	Method and Description
String	getDataId()
ExchangeRate	getExchangeRate(ConversionQuery query)
protected LocalDate[]	getTargetDates(ConversionQuery query)
void	newDataLoaded(String data, InputStream is) Callback called from the LoaderService, when new data was read for a given data item.

Methods inherited from class org.javamoney.moneta.spi.AbstractRateProvider

divide, divide, formatLocalDate, getContext, getCurrencyConversion, multiply

Methods inherited from class org.javamoney.moneta.spi.base.BaseExchangeRateProvider

getCurrencyConversion, getCurrencyConversion, getExchangeRate, getExchangeRate, getReversed, isAvailable, isAvailable, isAvailable

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BASE_CURRENCY

public static final CurrencyUnit BASE_CURRENCY

Base currency of the loaded rates is always EUR.

rates

protected final Map<LocalDate,Map<String,ExchangeRate>> rates

Historic exchange rates, rate timestamp as UTC long.

loadState

protected volatile String loadState

loadLock

protected volatile CountDownLatch loadLock

Constructor Detail

ECBHistoricRateProvider

public ECBHistoricRateProvider()
                        throws MalformedURLException

Throws:

MalformedURLException

Method Detail

getDataId

public String getDataId()

newDataLoaded

public void newDataLoaded(String data,
                          InputStream is)

Description copied from interface: LoaderService.LoaderListener

Callback called from the LoaderService, when new data was read for a given data item.

Specified by:

newDataLoaded in interface LoaderService.LoaderListener

Parameters:

data - the resource id

is - the input stream for accessing the data

getTargetDates

protected LocalDate[] getTargetDates(ConversionQuery query)

getExchangeRate

public ExchangeRate getExchangeRate(ConversionQuery query)

Specified by:

getExchangeRate in interface ExchangeRateProvider

Specified by:

getExchangeRate in class AbstractRateProvider