org.cyclos.impl.banking

Interface RateHandler

public interface RateHandler

Service interface for rates. This service contains all common rates methods. The methods are not specific for a particular rate, but apply for all rates enabled. Methods particular for specific rates are delegated to RateTypeHandler and its child classes.

Author:

rinke

Method Summary

Methods

Modifier and Type	Method and Description
<T extends Transfer> void	applyTransfer(T transfer) Applies a transfer, that is: gets the rate from the fromAccount sets those to the transfer There is nothing saved to any accounts, as this happens only at account closing.
<T extends ObservableBean> org.cyclos.impl.utils.BigDecimalScaleResolver<T>	bigDecimalResolverForRates(Property<java.math.BigDecimal,? super T> property) provides a standard BigDecimalScaleResolver for rates.
void	copy(HasRates source, HasRates destination) Copies rate fields from one HasRates to another.
void	copy(RatedEntity source, RatedEntity destination) copies all rate fields from one RatedEntity to another.
org.cyclos.impl.banking.FromRatesData	getFromRates(Account fromAccount, TransferType transferType, java.math.BigDecimal amount, java.util.Date date, RateVisibility visibility) gets the rates of a from account for a transaction.
org.cyclos.impl.banking.RatesData	getRates(Account account, java.util.Date time, RateVisibility visibility) gets the rates of the account on the given date, according to the RateVisibility param.
boolean	isAnyRateEnabled(Currency currency, java.util.Date time) Checks if any rate is enabled on the given date/time and for the given currency.
boolean	isVisible(Currency currency, java.util.Date date) Determines if any rate is to be shown to users.
void	resetCurrency(Currency entity) Resets the currency entity to its RateParameters.
void	resolveValidator(org.cyclos.impl.utils.validation.Validator validator, CurrencyDTO dto) gets the nested validator for the currency's rateparameters.
void	setRateParametersToCurrencyDTO(CurrencyDTO result) sets the RateParameters correctly to the currencyDTO, by: gets the specific RateParametersDTO from the CurrencyDTO if it exists, sets the enabledOnForm property of the RateParametersDTO to true.
void	toEntity(Currency target, CurrencyDTO dto) sets the RateParameters entities to the Currency entity

Method Detail

applyTransfer

<T extends Transfer> void applyTransfer(T transfer)
                   throws FrameworkException

Applies a transfer, that is:

• gets the rate from the fromAccount
• sets those to the transfer

There is nothing saved to any accounts, as this happens only at account closing.

Parameters:

transfer - the transfer to be applied.

Throws:

FrameworkException

bigDecimalResolverForRates

<T extends ObservableBean> org.cyclos.impl.utils.BigDecimalScaleResolver<T> bigDecimalResolverForRates(Property<java.math.BigDecimal,? super T> property)

provides a standard BigDecimalScaleResolver for rates. This needs to be set for any rate BigDecimal property of any ObservableBean model class which is displayed in the user interface.

copy

void copy(HasRates source,
        HasRates destination)
          throws FrameworkException

Copies rate fields from one HasRates to another.

Throws:

FrameworkException

copy

void copy(RatedEntity source,
        RatedEntity destination)

copies all rate fields from one RatedEntity to another.

getFromRates

org.cyclos.impl.banking.FromRatesData getFromRates(Account fromAccount,
                                                 TransferType transferType,
                                                 java.math.BigDecimal amount,
                                                 java.util.Date date,
                                                 RateVisibility visibility)

gets the rates of a from account for a transaction. It takes into account:
* null rates are replaced by init values
* if the balance isn't sufficient creation values are applied for the unsufficient part, and the rateBalanceCorrection and virtualRatedBalance are updated. In this case, FromRatesData.changedDueToCreation is set to true. This does NOT happen in case of an unlimited account.
* transfer type defaults are applied if needed.

Parameters:

fromAccount - the account which is the from account of the transfer

transferType - the transfertype of the transfer

amount - the transfer amount

date - the processing date of the transfer; if null, now is used.

visibility - the visibility to be applied. This is usually RateVisibility.PARAMS in case the result is to be shown directly to users, or RateVisibility.ALL in case it is further processed in a transfer.

getRates

org.cyclos.impl.banking.RatesData getRates(Account account,
                                         java.util.Date time,
                                         RateVisibility visibility)
                                           throws FrameworkException

gets the rates of the account on the given date, according to the RateVisibility param. All fields are updated, also virtualRatedBalance and RateBalanceCorrection. Always returns a non null result, even when no rates available. Fields of rates not visible or not enabled are null.

Parameters:

account - the account. May not be null

visibility -

Throws:

FrameworkException

isAnyRateEnabled

boolean isAnyRateEnabled(Currency currency,
                       java.util.Date time)
                         throws FrameworkException

Checks if any rate is enabled on the given date/time and for the given currency.

Parameters:

currency - - If null then it checks it for all the currencies available on the network, and will return true if any of those currencies is found with any of the rates enabled.

time - - if null checks it for now.

Returns:

false if no rate at all is enabled, otherwise true.

Throws:

FrameworkException

isVisible

boolean isVisible(Currency currency,
                java.util.Date date)

Determines if any rate is to be shown to users. Checks the following:
* currency must have any rate enabled
* user must be admin, or rateParameters must be have flag showToUser set as true.

This method can be used if no account is known, or even if no currency is known. If the account was known, it would correspond with isVisible(account, date, RateVisibility.PARAM).

Parameters:

currency - - If null then it checks it for all the currencies available on the network, and will return true if any of those currencies applies.

date - - if null checks it for now.

Returns:

false if no rate at all is visible to the users, otherwise true.

resetCurrency

void resetCurrency(Currency entity)
                   throws FrameworkException

Resets the currency entity to its RateParameters. This is needed after saving a transient currency.

Throws:

FrameworkException

resolveValidator

void resolveValidator(org.cyclos.impl.utils.validation.Validator validator,
                    CurrencyDTO dto)
                      throws FrameworkException

gets the nested validator for the currency's rateparameters.

Throws:

FrameworkException

setRateParametersToCurrencyDTO

void setRateParametersToCurrencyDTO(CurrencyDTO result)
                                    throws FrameworkException

sets the RateParameters correctly to the currencyDTO, by:

• gets the specific RateParametersDTO from the CurrencyDTO
• if it exists, sets the enabledOnForm property of the RateParametersDTO to true. This is needed for a correct handling on the currency details form.

Throws:

FrameworkException

toEntity

void toEntity(Currency target,
            CurrencyDTO dto)
              throws FrameworkException

sets the RateParameters entities to the Currency entity

Parameters:

target - the Currency entity to which the RateParameters must be set

dto - the CurrencyDTO from which the currency was retrieved, and which is used to read the RateParametersDTO

Throws:

FrameworkException