org.javamoney.moneta.spi.base.BaseMonetaryConversionsSingletonSpi Maven / Gradle / Ivy
Show all versions of moneta-bp Show documentation
/*
* CREDIT SUISSE IS WILLING TO LICENSE THIS SPECIFICATION TO YOU ONLY UPON THE CONDITION THAT YOU
* ACCEPT ALL OF THE TERMS CONTAINED IN THIS AGREEMENT. PLEASE READ THE TERMS AND CONDITIONS OF THIS
* AGREEMENT CAREFULLY. BY DOWNLOADING THIS SPECIFICATION, YOU ACCEPT THE TERMS AND CONDITIONS OF
* THE AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY IT, SELECT THE "DECLINE" BUTTON AT THE
* BOTTOM OF THIS PAGE. Specification: JSR-354 Money and Currency API ("Specification") Copyright
* (c) 2012-2015, Credit Suisse All rights reserved.
*/
package org.javamoney.moneta.spi.base;
import javax.money.CurrencyUnit;
import javax.money.MonetaryException;
import javax.money.convert.ConversionQuery;
import javax.money.convert.ConversionQueryBuilder;
import javax.money.convert.CurrencyConversion;
import javax.money.convert.ExchangeRateProvider;
import javax.money.spi.MonetaryConversionsSingletonSpi;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.List;
import java.util.Objects;
/**
* SPI (conversion) that implements the functionality provided by the
* {@code MonetaryConversions} singleton accessor. It should be registered as a
* service using the JDK {@code ServiceLoader}. Hereby only one instance can be
* registered at a time.
*
* This interface is designed to support also contextual behaviour, e.g. in Java
* EE containers each application may provide its own
* {@link javax.money.convert.ExchangeRateProvider} instances, e.g. by registering them as CDI
* beans. An EE container can register an according
* {@link BaseMonetaryConversionsSingletonSpi} that manages the different application
* contexts transparently. In a SE environment this class is expected to behave
* like an ordinary singleton, loading its SPIs from the {@link java.util.ServiceLoader}.
*
* Instances of this class must be thread safe. It is not a requirement that
* they are serializable.
*
* Only one instance can be registered using the {@link java.util.ServiceLoader}. When
* registering multiple instances the {@link javax.money.convert.MonetaryConversions} accessor will
* not work.
*
* @author Anatole Tresch
* @author Werner Keil
*/
public abstract class BaseMonetaryConversionsSingletonSpi implements MonetaryConversionsSingletonSpi{
/**
* Allows to quickly check, if a {@link javax.money.convert.ExchangeRateProvider} is accessible for the given
* {@link javax.money.convert.ConversionQuery}.
*
* @param conversionQuery the {@link javax.money.convert.ConversionQuery} determining the type of conversion
* required, not null.
* @return {@code true}, if such a conversion is supported, meaning an according
* {@link javax.money.convert.ExchangeRateProvider} can be
* accessed.
* @see #getExchangeRateProvider(javax.money.convert.ConversionQuery)
* @see #getExchangeRateProvider(String...)}
*/
public boolean isExchangeRateProviderAvailable(ConversionQuery conversionQuery) {
try {
return getExchangeRateProvider(conversionQuery) != null;
} catch (Exception e) {
return false;
}
}
/**
* Allows to quickly check, if a {@link javax.money.convert.CurrencyConversion} is accessible for the given
* {@link javax.money.convert.ConversionQuery}.
*
* @param conversionQuery the {@link javax.money.convert.ConversionQuery} determining the type of conversion
* required, not null.
* @return {@code true}, if such a conversion is supported, meaning an according
* {@link javax.money.convert.CurrencyConversion} can be
* accessed.
* @see #getConversion(javax.money.convert.ConversionQuery)
* @see #getConversion(javax.money.CurrencyUnit, String...)}
*/
public boolean isConversionAvailable(ConversionQuery conversionQuery) {
try {
return getConversion(conversionQuery) != null;
} catch (Exception e) {
return false;
}
}
/**
* Allows to quickly check, if a {@link javax.money.convert.CurrencyConversion} is accessible for the given
* {@link javax.money.convert.ConversionQuery}.
*
* @param termCurrency the terminating/target currency unit, not null.
* @param providers the provider names defines a corresponding
* provider chain that must be encapsulated by the resulting {@link javax
* .money.convert.CurrencyConversion}. By default the provider
* chain as defined by #getDefaultRoundingProviderChain will be used.
* @return {@code true}, if such a conversion is supported, meaning an according
* {@link javax.money.convert.CurrencyConversion} can be
* accessed.
* @see #getConversion(javax.money.convert.ConversionQuery)
* @see #getConversion(javax.money.CurrencyUnit, String...)}
*/
public boolean isConversionAvailable(CurrencyUnit termCurrency, String... providers) {
return isConversionAvailable(
ConversionQueryBuilder.of().setTermCurrency(termCurrency).setProviderNames(providers).build());
}
/**
* Access the current registered {@link javax.money.convert.ExchangeRateProvider} instances. If no provider
* names are passed ALL current registered providers are returned in undefined order.
*
* @param providers the provider names of hte providers to be accessed
* @return the list of providers, in the same order as requested.
* @throws javax.money.MonetaryException if a provider could not be resolved.
*/
public List getExchangeRateProviders(String... providers) {
List provInstances = new ArrayList<>();
Collection providerNames = Arrays.asList(providers);
if (providerNames.isEmpty()) {
providerNames = getProviderNames();
}
for (String provName : providerNames) {
ExchangeRateProvider provider = getExchangeRateProvider(provName);
if(provider==null){
throw new MonetaryException("Unsupported conversion/rate provider: " + provName);
}
provInstances.add(provider);
}
return provInstances;
}
/**
* Access a compound instance of an {@link javax.money.convert.ExchangeRateProvider} based on the given provider chain.
*
* @param providers the {@link javax.money.convert.ConversionQuery} provider names defines a corresponding
* provider chain that must be
* encapsulated by the resulting {@link javax.money.convert.ExchangeRateProvider}. By default
* the default
* provider changes as defined in #getDefaultRoundingProviderChain will be used.
* @return an {@link javax.money.convert.ExchangeRateProvider} built up with the given sub
* providers, never {@code null}.
* @throws javax.money.MonetaryException if a provider listed could not be found.
* @see #getProviderNames()
* @see #isExchangeRateProviderAvailable(javax.money.convert.ConversionQuery)
*/
public ExchangeRateProvider getExchangeRateProvider(String... providers) {
return getExchangeRateProvider(ConversionQueryBuilder.of().setProviderNames(providers).build());
}
/**
* Access an instance of {@link javax.money.convert.CurrencyConversion}.
*
* @param conversionQuery the {@link javax.money.convert.ConversionQuery} determining the type of conversion
* required, not null.
* @return the corresponding conversion, not null.
* @throws javax.money.MonetaryException if no matching conversion could be found.
* @see #isConversionAvailable(javax.money.convert.ConversionQuery)
*/
public CurrencyConversion getConversion(ConversionQuery conversionQuery) {
return getExchangeRateProvider(conversionQuery).getCurrencyConversion(
Objects.requireNonNull(conversionQuery.getCurrency(), "Terminating Currency is required.")
);
}
/**
* Access an instance of {@link javax.money.convert.CurrencyConversion}.
*
* @param termCurrency the terminating/target currency unit, not null.
* @param providers the {@link javax.money.convert.ConversionQuery} provider names defines a corresponding
* provider chain that must be encapsulated by the resulting {@link javax
* .money.convert.CurrencyConversion}. By default the default
* provider chain as defined by #getDefaultRoundingProviderChain will be used.
* @return the corresponding conversion, not null.
* @throws javax.money.MonetaryException if no matching conversion could be found.
* @see #isConversionAvailable(javax.money.convert.ConversionQuery)
*/
public CurrencyConversion getConversion(CurrencyUnit termCurrency, String... providers) {
return getConversion(ConversionQueryBuilder.of().setTermCurrency(termCurrency).setProviderNames(providers).build());
}
}