org.apache.solr.schema

Class FileExchangeRateProvider

java.lang.Object

org.apache.solr.schema.FileExchangeRateProvider

All Implemented Interfaces:

ExchangeRateProvider

class FileExchangeRateProvider
extends java.lang.Object
implements ExchangeRateProvider

Configuration for currency. Provides currency exchange rates.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	currencyConfigFile
private ResourceLoader	loader
static org.slf4j.Logger	log
protected static java.lang.String	PARAM_CURRENCY_CONFIG
private java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>>	rates

Constructor Summary

Constructors

Constructor and Description
FileExchangeRateProvider()

Method Summary

Modifier and Type	Method and Description
private void	addRate(java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>> ratesMap, java.lang.String sourceCurrencyCode, java.lang.String targetCurrencyCode, double rate) Registers the specified exchange rate.
boolean	equals(java.lang.Object o)
double	getExchangeRate(java.lang.String sourceCurrencyCode, java.lang.String targetCurrencyCode) Returns the currently known exchange rate between two currencies.
int	hashCode()
void	inform(ResourceLoader loader) Passes a ResourceLoader, used to read config files from e.g.
void	init(java.util.Map<java.lang.String,java.lang.String> params) Initializes the provider by passing in a set of key/value configs as a map.
java.util.Set<java.lang.String>	listAvailableCurrencies() List all configured currency codes which are valid as source/target for this Provider
private java.lang.Double	lookupRate(java.lang.String sourceCurrencyCode, java.lang.String targetCurrencyCode) Looks up the current known rate, if any, between the source and target currencies.
boolean	reload() Ask the currency provider to explicitly reload/refresh its configuration.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

log

public static org.slf4j.Logger log

PARAM_CURRENCY_CONFIG

protected static final java.lang.String PARAM_CURRENCY_CONFIG

See Also:

Constant Field Values

rates

private java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>> rates

currencyConfigFile

private java.lang.String currencyConfigFile

loader

private ResourceLoader loader

Constructor Detail

FileExchangeRateProvider

FileExchangeRateProvider()

Method Detail

getExchangeRate

public double getExchangeRate(java.lang.String sourceCurrencyCode,
                              java.lang.String targetCurrencyCode)

Returns the currently known exchange rate between two currencies. If a direct rate has been loaded, it is used. Otherwise, if a rate is known to convert the target currency to the source, the inverse exchange rate is computed.

Specified by:

getExchangeRate in interface ExchangeRateProvider

Parameters:

sourceCurrencyCode - The source currency being converted from.

targetCurrencyCode - The target currency being converted to.

Returns:

The exchange rate.

Throws:

an - exception if the requested currency pair cannot be found

lookupRate

private java.lang.Double lookupRate(java.lang.String sourceCurrencyCode,
                                    java.lang.String targetCurrencyCode)

Looks up the current known rate, if any, between the source and target currencies.

Parameters:

sourceCurrencyCode - The source currency being converted from.

targetCurrencyCode - The target currency being converted to.

Returns:

The exchange rate, or null if no rate has been registered.

addRate

private void addRate(java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.Double>> ratesMap,
                     java.lang.String sourceCurrencyCode,
                     java.lang.String targetCurrencyCode,
                     double rate)

Registers the specified exchange rate.

Parameters:

ratesMap - The map to add rate to

sourceCurrencyCode - The source currency.

targetCurrencyCode - The target currency.

rate - The known exchange rate.

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

listAvailableCurrencies

public java.util.Set<java.lang.String> listAvailableCurrencies()

Description copied from interface: ExchangeRateProvider

List all configured currency codes which are valid as source/target for this Provider

Specified by:

listAvailableCurrencies in interface ExchangeRateProvider

Returns:

a Set of ISO 4217 currency code strings

reload

public boolean reload()
               throws SolrException

Description copied from interface: ExchangeRateProvider

Ask the currency provider to explicitly reload/refresh its configuration. If this does not make sense for a particular provider, simply do nothing

Specified by:

reload in interface ExchangeRateProvider

Returns:

true if reload of rates succeeded, else false

Throws:

SolrException - if there is a problem reloading

init

public void init(java.util.Map<java.lang.String,java.lang.String> params)
          throws SolrException

Description copied from interface: ExchangeRateProvider

Initializes the provider by passing in a set of key/value configs as a map. Note that the map also contains other fieldType parameters, so make sure to avoid name clashes.

Important: Custom config params must be removed from the map before returning

Specified by:

init in interface ExchangeRateProvider

Parameters:

params - a @Map of key/value config params to initialize the provider

Throws:

SolrException

inform

public void inform(ResourceLoader loader)
            throws SolrException

Description copied from interface: ExchangeRateProvider

Passes a ResourceLoader, used to read config files from e.g. ZooKeeper. Implementations not needing resource loader can implement this as NOOP.

Typically called after init

Specified by:

inform in interface ExchangeRateProvider

Parameters:

loader - a @ResourceLoader instance

Throws:

SolrException