Package org.cyclos.impl.banking

Class TransactionServiceImpl

java.lang.Object

org.cyclos.impl.AbstractServerComponent

org.cyclos.impl.AbstractNetworkedServerComponent

org.cyclos.impl.BaseServiceImpl

org.cyclos.impl.banking.TransactionServiceImpl

All Implemented Interfaces:

TransactionServiceLocal, TransactionService, Service

@Component
public class TransactionServiceImpl
extends BaseServiceImpl
implements TransactionServiceLocal

Implementation for TransactionService

Field Summary

Fields inherited from class org.cyclos.impl.AbstractNetworkedServerComponent

authHandler, conversionHandler, entityManagerHandler, groupsHandler, productsHandler, restBeanPropertyMapping, userLocatorHandler

Fields inherited from class org.cyclos.impl.AbstractServerComponent

accountHandler, configurationHandler, dataTranslationHandler, notificationHandler, profileFieldHandler, transactionHandler, translationHandler

Fields inherited from interface org.cyclos.impl.banking.TransactionServiceLocal

ATTR_AUTHORIZATION_LEVEL, ATTR_AUTHORIZATION_TYPE, ATTR_FROM_ACCOUNT, ATTR_FROM_OWNER, ATTR_FROM_OWNER_RESULT, ATTR_INSTALLMENT, ATTR_NEW_STATUS, ATTR_OLD_STATUS, ATTR_PAYMENT_TYPE, ATTR_PERFORM_TRANSACTION, ATTR_PREVIEW, ATTR_TO_ACCOUNT, ATTR_TO_OWNER, ATTR_TO_OWNER_RESULT, ATTR_TRANSACTION, FOR_POS

Constructor Summary

Constructors

Constructor	Description
TransactionServiceImpl()

Method Summary

Modifier and Type	Method	Description
void	check(LocateAccountOwnerResult from, LocateAccountOwnerResult to)	Performs security checks for the given transaction parameters
void	check(LocateAccountOwnerResult from, LocateAccountOwnerResult to, TransferType transferType)	Performs security checks for the given transaction parameters, taking into account the current session data channel and principal type
void	check(PerformInternalTransactionDTO parameters)	Performs security checks for the given transaction parameters
void	checkIgnoringSessionData(LocateAccountOwnerResult from, LocateAccountOwnerResult to, TransferType transferType)	Performs security checks for the given transaction parameters, ignoring the current session data channel and principal type
void	checkPaymentParameters(LocateAccountOwnerResult from, LocateAccountOwnerResult to, PaymentCreationType creationType, PaymentTransferType paymentType)	Checks that a payment can be performed from / to the given owners, with the given payment type
OperatorVO	convertToOperatorVO(Operator operator)	If it's a user trying to viewing another user operator returns the display of the operator and the user.
DeviceConfirmationVO	createDeviceConfirmationForReceive(@NotNull PerformInternalTransactionDTO parameters)	Creates a new pending for approval device confirmation for the payer.
SerializableInputStream	deviceConfirmationBarcodeForReceive(InternalAccountOwner from, DeviceConfirmationBarcodeParams params)	Generates a two-dimensional barcode (QR code), only if the confirmation was not already approved nor rejected for the given payer.
protected com.mysema.commons.lang.CloseableIterator<Installment>	doIterate(BaseInstallmentQuery params)
protected com.mysema.commons.lang.CloseableIterator<Transaction>	doIterate(BaseTransactionQuery params)
FileInfo	exportInstallments(@NotNull ExportFormatVO formatVO, @NotNull InstallmentQuery query)	Exports a installments search results to file
FileInfo	exportInstallmentsOverview(@NotNull ExportFormatVO formatVO, @NotNull InstallmentOverviewQuery query)	Exports an installments overview search results to file
FileInfo	exportOverview(@NotNull ExportFormatVO formatVO, @NotNull TransactionOverviewQuery query)	Exports a transaction overview search results to file
FileInfo	exportTransaction(@NotNull ExportFormatVO formatVO, @NotNull TransactionVO transactionVO)	Exports the details of a given transaction to file
FileInfo	exportTransactions(@NotNull ExportFormatVO formatVO, @NotNull TransactionQuery query)	Exports a transactions search results to file
<D extends TransactionData> D	fill(D data, Transaction transaction)	Fills a data instance with basic data
void	fill(Transaction transaction, TransferType type, PaymentCreationType creationType, Account from, Account to, BasicUser receiver, String fromName, String toName, BigDecimal amount, String description, Collection<CustomFieldValueDTO> customValues)	Fills data in a transaction
PaymentTransferType	fill(AbstractPaymentTypeData data, LocateAccountOwnerResult from, LocateAccountOwnerResult to, PaymentTransferType paymentType)	Fills in the given payment type data from / to the given owners, using the given payment type
Transaction	findByTransactionNumber(String transactionNumber)	Returns a transaction by transaction number, or throws EntityNotFoundException if not found
Map<String,Object>	getCustomFieldValidationBindings(LocateAccountOwnerResult from, LocateAccountOwnerResult to, PaymentTransferType paymentType)	Returns a map to be used as bindings on dynamic custom field validation
TransactionData	getData(TransactionVO vo)	Returns data for a transaction
Transaction	getGeneratedBy(Transaction transaction)	Returns the transaction that generated the given transaction
InstallmentOverviewSearchData	getInstallmentsOverviewSearchData()	Returns data for searching installments overview
InstallmentSearchData	getInstallmentsSearchData(InternalAccountOwner owner)	Returns data for searching installments from an account owner perspective
Page<MaturityTableItemData>	getMaturityTable(MaturityTableQuery query)	returns the maturity table which the user can view in case of paying with a zero d-rate of an earlier account state, when MaturityPolicy.HISTORY is valid.
TransactionOverviewSearchData	getOverviewSearchData(boolean pendingMyAuthorization)	Returns data used to search for transaction overview
PerformPaymentData	getPaymentData(InternalAccountOwner fromParam, InternalAccountOwner toParam, TransferTypeVO paymentTypeVO)	Returns data used to prepare a payment matching the given from / to account owners.
PerformPaymentToOwnerData	getPaymentToOwnerData(InternalAccountOwner from, InternalAccountOwner to, TransferTypeVO transferTypeVO)	Returns simplified data used to prepare a payment matching the given arguments
PerformPaymentTypeData	getPaymentTypeData(InternalAccountOwner from, InternalAccountOwner to, TransferTypeVO transferTypeVO)	Returns the data related to a payment type for a payment
ReceivePaymentData	getReceivePaymentData()	Returns data used to receive a payment
ReceivePaymentFromUserData	getReceivePaymentFromUserData(UserLocatorVO locator, TransferTypeVO paymentTypeVO)	Returns data used to receive a payment from a specific user.
PerformPaymentTypeData	getReceivePaymentTypeData(UserLocatorVO locator, TransferTypeVO transferTypeVO)	Returns the data related to a payment type for receiving a payment from a specific user and payment type
TransactionSearchData	getSearchData(InternalAccountOwner owner)	Returns data used to search for transactions for the given owner
Set<TransactionNature>	getVisibleNatures(InternalAccountOwner owner)	Returns the visible transaction natures for the logged user over the given optional owner.
void	initialize()
boolean	isAccessible(InternalAccountOwner owner, TransactionNature nature)	Returns whether the logged user has basic accessibility for transactions of the given nature for the given owner.
boolean	isCheckConfirmationPassword(PaymentTransferType paymentType, InternalAccountOwner owner, BigDecimal amount, Date date)	It returns true if the confirmation password must be required because the payment's amount is greater than or equals to the maximum for a pin-less payment.
boolean	isVisible(InternalAccountOwner owner, TransactionNature nature)	Returns whether the logged user can see transactions of the given nature for the given optional owner.
List<PaymentTransferType>	listPaymentTypes(LocateAccountOwnerResult from, LocateAccountOwnerResult to, Currency currency, boolean receive)	Returns the possible payment, optionally in a currency, types between the given owners
TransactionVO	load(Long id)	Loads a transaction details by id, returning a proper detailed implementation (for example, PaymentVO or ScheduledPaymentVO).
TransactionVO	loadByTransactionNumber(String transactionNumber)	Returns a transfer by transaction number, or throws EntityNotFoundException if not found
LocateAccountOwnerResult	locateForPayment(InternalAccountOwner owner)	Locate the receiver when performing a payment using the principal types allowed to perform a payment.
LocateAccountOwnerResult	locateForReceiving(InternalAccountOwner owner)	Locate the payer when receiving a payment using the principal types allowed to receive a payment. Additionally, it checks if the BuiltInChannel.POS channel is accessible for the located payer.
<D extends TransactionData> D	newData(Transaction transaction)	Returns a new instance of the Data for the specific transaction, filled-in with basic data
void	persist(Transaction transaction)	Persists the given transaction and immediately performs additional actions, such as calling the CustomFieldValueHandler.processAfterSave(org.cyclos.entities.system.EntityWithCustomValues) method.
org.cyclos.impl.banking.TransactionValidationData	prepareValidation(PrepareValidationParameter parameter)	Returns a validator filled with all common validations, plus some other data which was already loaded.
TransferVO	processInstallment(InstallmentActionDTO action)	Settles an installment.
<T> T	receive(InternalAccountOwner from, Callable<T> action)	Sets up the session data for receiving a transaction from the given user, invoking the given Callable in it.
protected void	registerNetworkMappings(NetworkPathRegistry networkPathRegistry)	Needs to be overridden by subclasses to register the path up to the network
void	removeDeviceConfirmationForReceive(String deviceConfirmationId, @NotNull PerformInternalTransactionDTO parameters)	Removes a confirmation for the payer.
void	requestNewOTPForReceive(PerformInternalTransactionDTO parameters, SendMedium medium)	Generates a new OTP (removing any previous password, if any) and sends it to the payer by the specified medium using the confirmation password type for the BuiltInChannel.POS channel for the specified payer. It has the same security controls as for PaymentService.receive(PerformPaymentDTO), that is the logged user must be allowed to receive payments from the specified payer.
PaymentTransferType	resolvePaymentType(InternalAccountOwner from, AccountOwner to, Currency currency, Channel channel, PrincipalType principalType, PaymentCreationType creationType)	Returns the payment type matching the from, to, and optionally, currency according to the given payment operation.
Page<TransactionResultVO>	search(TransactionQuery params)	Searches for transactions from the point-of-view of a given account owner, according to the given query
Page<InstallmentResultVO>	searchInstallments(@NotNull InstallmentQuery params)	Searches for installments from an account owner perspective, according to the given query
Page<InstallmentResultVO>	searchInstallmentsOverview(@NotNull InstallmentOverviewQuery params)	Searches for installments overview, according to the given query
Page<TransactionResultVO>	searchOverview(@NotNull TransactionOverviewQuery params)	Searches for transactions, according to the given query
ExtensionPointAccessor	setStatusAndGetExtensionPoint(Installment installment, InstallmentStatus newStatus)	Creates a ExtensionPointAccessor for a status change, fires the validated event and sets new status
<T extends Transaction & HasTransactionStatus<S>,S extends TransactionStatus> ExtensionPointAccessor	setStatusAndGetExtensionPoint(T transaction, S newStatus)	Creates a ExtensionPointAccessor for a status change, fires the validated event and sets new status
void	settleInstallment(InstallmentActionDTO action)	Settles an installment.
void	updatePreviewAndPayment(BasePaymentPreviewVO preview, PerformTransactionDTO dto, LocateAccountOwnerResult from, LocateAccountOwnerResult to, TransferType paymentType, SessionData receiverSessionData)	Updates the given preview BasePaymentPreviewVO and set the given paymentDTO PerformTransactionDTO after make it suitable to be returned again after a preview
void	validateMinTimeBetweenPayments(LocateAccountOwnerResult owner, PaymentTransferType paymentType)	Validates the minimum time between payments
void	validatePaymentAmount(LocateAccountOwnerResult from, LocateAccountOwnerResult to, PaymentTransferType paymentType, BigDecimal amount, Date date)	Validates an amount to be paid from the given account.
DeviceConfirmationVO	viewDeviceConfirmationForReceive(String deviceConfirmationId, @NotNull PerformInternalTransactionDTO parameters)	Loads the details of a confirmation belonging to the payment payer.

Methods inherited from class org.cyclos.impl.BaseServiceImpl

initializeNetworkMappings

Methods inherited from class org.cyclos.impl.AbstractNetworkedServerComponent

canManage, checkManagesUser, checkPermission, checkRelatesToUser, checkValue, clearAlreadyValidated, getBaseEntityManagerHandler, getConfiguration, getLoggedBasicUser, getLoggedUser, getProducts, getTranslatedName, getTranslatedValue, hasPermission, hasValue, inSameNetwork, inSameNetworkOrGlobal, isAdmin, isAlreadyValidated, isBroker, isGlobalAdmin, isGlobalAdminInNetwork, isGuest, isLoggedIn, isMember, isMemberOnly, isNetworkAdmin, isOperator, isRelatedToUser, isSystem, isUserManager, isUserManagerOf, message, message, permission, permission, permissionOptionalValue, permissionOptionalValue, setAlreadyValidated, toDate, toDateTime, validate

Methods inherited from class org.cyclos.impl.AbstractServerComponent

dataTranslationProxy, dataTranslationProxy, delete, detach, doDataTranslationProxy, find, flush, from, getApplicationContext, getFormatter, getFormatter, getFormatter, getLogger, getRemoteAddress, getSessionData, mailContentBuilder, message, message, persist, processBatch, processBatch, refresh, remove, selectFrom, subQuery, update

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionServiceImpl

public TransactionServiceImpl()

Method Detail

check

public void check(LocateAccountOwnerResult from,
                  LocateAccountOwnerResult to)

Description copied from interface: TransactionServiceLocal

Performs security checks for the given transaction parameters

Specified by:

check in interface TransactionServiceLocal

check

public void check(LocateAccountOwnerResult from,
                  LocateAccountOwnerResult to,
                  TransferType transferType)

Description copied from interface: TransactionServiceLocal

Performs security checks for the given transaction parameters, taking into account the current session data channel and principal type

Specified by:

check in interface TransactionServiceLocal

check

public void check(PerformInternalTransactionDTO parameters)

Description copied from interface: TransactionServiceLocal

Performs security checks for the given transaction parameters

Specified by:

check in interface TransactionServiceLocal

checkIgnoringSessionData

public void checkIgnoringSessionData(LocateAccountOwnerResult from,
                                     LocateAccountOwnerResult to,
                                     TransferType transferType)

Description copied from interface: TransactionServiceLocal

Performs security checks for the given transaction parameters, ignoring the current session data channel and principal type

Specified by:

checkIgnoringSessionData in interface TransactionServiceLocal

checkPaymentParameters

public void checkPaymentParameters(LocateAccountOwnerResult from,
                                   LocateAccountOwnerResult to,
                                   PaymentCreationType creationType,
                                   PaymentTransferType paymentType)

Description copied from interface: TransactionServiceLocal

Checks that a payment can be performed from / to the given owners, with the given payment type

Specified by:

checkPaymentParameters in interface TransactionServiceLocal

convertToOperatorVO

public OperatorVO convertToOperatorVO(Operator operator)

Description copied from interface: TransactionServiceLocal

If it's a user trying to viewing another user operator returns the display of the operator and the user. Otherwise it use BasicUserVOConverter. If the logged user is not related to the operator returns null; This code is relying in BasicUserVOConverter management for operators.

Specified by:

convertToOperatorVO in interface TransactionServiceLocal

createDeviceConfirmationForReceive

public DeviceConfirmationVO createDeviceConfirmationForReceive(@NotNull
                                                               @NotNull PerformInternalTransactionDTO parameters)
                                                        throws FrameworkException

Description copied from interface: TransactionService

Creates a new pending for approval device confirmation for the payer. It has the same security controls as for PaymentService.receive(PerformPaymentDTO), that is the logged user must be allowed to receive payments from the specified payer.

Specified by:

createDeviceConfirmationForReceive in interface TransactionService

Throws:

FrameworkException

deviceConfirmationBarcodeForReceive

public SerializableInputStream deviceConfirmationBarcodeForReceive(InternalAccountOwner from,
                                                                   DeviceConfirmationBarcodeParams params)
                                                            throws FrameworkException

Description copied from interface: TransactionService

Generates a two-dimensional barcode (QR code), only if the confirmation was not already approved nor rejected for the given payer. The logged use must be allowed to locate for receive the payer.

Specified by:

deviceConfirmationBarcodeForReceive in interface TransactionService

Throws:

FrameworkException

exportInstallments

public FileInfo exportInstallments(@NotNull
                                   @NotNull ExportFormatVO formatVO,
                                   @NotNull
                                   @NotNull InstallmentQuery query)

Description copied from interface: TransactionService

Exports a installments search results to file

Specified by:

exportInstallments in interface TransactionService

exportInstallmentsOverview

public FileInfo exportInstallmentsOverview(@NotNull
                                           @NotNull ExportFormatVO formatVO,
                                           @NotNull
                                           @NotNull InstallmentOverviewQuery query)

Description copied from interface: TransactionService

Exports an installments overview search results to file

Specified by:

exportInstallmentsOverview in interface TransactionService

exportOverview

public FileInfo exportOverview(@NotNull
                               @NotNull ExportFormatVO formatVO,
                               @NotNull
                               @NotNull TransactionOverviewQuery query)

Description copied from interface: TransactionService

Exports a transaction overview search results to file

Specified by:

exportOverview in interface TransactionService

exportTransaction

public FileInfo exportTransaction(@NotNull
                                  @NotNull ExportFormatVO formatVO,
                                  @NotNull
                                  @NotNull TransactionVO transactionVO)
                           throws FrameworkException

Description copied from interface: TransactionService

Exports the details of a given transaction to file

Specified by:

exportTransaction in interface TransactionService

Throws:

FrameworkException

exportTransactions

public FileInfo exportTransactions(@NotNull
                                   @NotNull ExportFormatVO formatVO,
                                   @NotNull
                                   @NotNull TransactionQuery query)

Description copied from interface: TransactionService

Exports a transactions search results to file

Specified by:

exportTransactions in interface TransactionService

fill

public PaymentTransferType fill(AbstractPaymentTypeData data,
                                LocateAccountOwnerResult from,
                                LocateAccountOwnerResult to,
                                PaymentTransferType paymentType)

Description copied from interface: TransactionServiceLocal

Fills in the given payment type data from / to the given owners, using the given payment type

Specified by:

fill in interface TransactionServiceLocal

fill

public <D extends TransactionData> D fill(D data,
                                          Transaction transaction)

Description copied from interface: TransactionServiceLocal

Fills a data instance with basic data

Specified by:

fill in interface TransactionServiceLocal

fill

public void fill(Transaction transaction,
                 TransferType type,
                 PaymentCreationType creationType,
                 Account from,
                 Account to,
                 BasicUser receiver,
                 String fromName,
                 String toName,
                 BigDecimal amount,
                 String description,
                 Collection<CustomFieldValueDTO> customValues)

Description copied from interface: TransactionServiceLocal

Fills data in a transaction

Specified by:

fill in interface TransactionServiceLocal

findByTransactionNumber

public Transaction findByTransactionNumber(String transactionNumber)
                                    throws FrameworkException

Description copied from interface: TransactionServiceLocal

Returns a transaction by transaction number, or throws EntityNotFoundException if not found

Specified by:

findByTransactionNumber in interface TransactionServiceLocal

Throws:

FrameworkException

getCustomFieldValidationBindings

public Map<String,Object> getCustomFieldValidationBindings(LocateAccountOwnerResult from,
                                                                 LocateAccountOwnerResult to,
                                                                 PaymentTransferType paymentType)

Description copied from interface: TransactionServiceLocal

Returns a map to be used as bindings on dynamic custom field validation

Specified by:

getCustomFieldValidationBindings in interface TransactionServiceLocal

getData

public TransactionData getData(TransactionVO vo)
                        throws FrameworkException

Description copied from interface: TransactionService

Returns data for a transaction

Specified by:

getData in interface TransactionService

Throws:

FrameworkException

getGeneratedBy

public Transaction getGeneratedBy(Transaction transaction)

Description copied from interface: TransactionServiceLocal

Returns the transaction that generated the given transaction

Specified by:

getGeneratedBy in interface TransactionServiceLocal

getInstallmentsOverviewSearchData

public InstallmentOverviewSearchData getInstallmentsOverviewSearchData()
                                                                throws FrameworkException

Description copied from interface: TransactionService

Returns data for searching installments overview

Specified by:

getInstallmentsOverviewSearchData in interface TransactionService

Throws:

FrameworkException

getInstallmentsSearchData

public InstallmentSearchData getInstallmentsSearchData(InternalAccountOwner owner)
                                                throws FrameworkException

Description copied from interface: TransactionService

Returns data for searching installments from an account owner perspective

Specified by:

getInstallmentsSearchData in interface TransactionService

Throws:

FrameworkException

getMaturityTable

public Page<MaturityTableItemData> getMaturityTable(MaturityTableQuery query)

Description copied from interface: TransactionService

returns the maturity table which the user can view in case of paying with a zero d-rate of an earlier account state, when MaturityPolicy.HISTORY is valid.

Specified by:

getMaturityTable in interface TransactionService

getOverviewSearchData

public TransactionOverviewSearchData getOverviewSearchData(boolean pendingMyAuthorization)
                                                    throws FrameworkException

Description copied from interface: TransactionService

Returns data used to search for transaction overview

Specified by:

getOverviewSearchData in interface TransactionService

Throws:

FrameworkException

getPaymentData

public PerformPaymentData getPaymentData(InternalAccountOwner fromParam,
                                         InternalAccountOwner toParam,
                                         TransferTypeVO paymentTypeVO)

Description copied from interface: TransactionService

Returns data used to prepare a payment matching the given from / to account owners. The given payment type is optional. If not passed in, will return detailed data for the first available payment type. If passed in, will return detailed data for that payment type, and must be valid.

Specified by:

getPaymentData in interface TransactionService

getPaymentToOwnerData

public PerformPaymentToOwnerData getPaymentToOwnerData(InternalAccountOwner from,
                                                       InternalAccountOwner to,
                                                       TransferTypeVO transferTypeVO)
                                                throws FrameworkException

Description copied from interface: TransactionService

Returns simplified data used to prepare a payment matching the given arguments

Specified by:

getPaymentToOwnerData in interface TransactionService

Throws:

FrameworkException

getPaymentTypeData

public PerformPaymentTypeData getPaymentTypeData(InternalAccountOwner from,
                                                 InternalAccountOwner to,
                                                 TransferTypeVO transferTypeVO)

Description copied from interface: TransactionService

Returns the data related to a payment type for a payment

Specified by:

getPaymentTypeData in interface TransactionService

getReceivePaymentData

public ReceivePaymentData getReceivePaymentData()
                                         throws FrameworkException

Description copied from interface: TransactionService

Returns data used to receive a payment

Specified by:

getReceivePaymentData in interface TransactionService

Throws:

FrameworkException

getReceivePaymentFromUserData

public ReceivePaymentFromUserData getReceivePaymentFromUserData(UserLocatorVO locator,
                                                                TransferTypeVO paymentTypeVO)
                                                         throws FrameworkException

Description copied from interface: TransactionService

Returns data used to receive a payment from a specific user. The given payment type is optional. If not passed in, will return detailed data for the first available payment type. If passed in, will return detailed data for that payment type, and must be valid.

Specified by:

getReceivePaymentFromUserData in interface TransactionService

Throws:

FrameworkException

getReceivePaymentTypeData

public PerformPaymentTypeData getReceivePaymentTypeData(UserLocatorVO locator,
                                                        TransferTypeVO transferTypeVO)
                                                 throws FrameworkException

Description copied from interface: TransactionService

Returns the data related to a payment type for receiving a payment from a specific user and payment type

Specified by:

getReceivePaymentTypeData in interface TransactionService

Throws:

FrameworkException

getSearchData

public TransactionSearchData getSearchData(InternalAccountOwner owner)
                                    throws FrameworkException

Description copied from interface: TransactionService

Returns data used to search for transactions for the given owner

Specified by:

getSearchData in interface TransactionService

Throws:

FrameworkException

getVisibleNatures

public Set<TransactionNature> getVisibleNatures(InternalAccountOwner owner)

Description copied from interface: TransactionServiceLocal

Returns the visible transaction natures for the logged user over the given optional owner. When no owner is given, returns whether can view transactions of that nature, regardless of the owner.

Specified by:

getVisibleNatures in interface TransactionServiceLocal

initialize

@PostConstruct
public void initialize()

isAccessible

public boolean isAccessible(InternalAccountOwner owner,
                            TransactionNature nature)

Description copied from interface: TransactionServiceLocal

Returns whether the logged user has basic accessibility for transactions of the given nature for the given owner. When no owner is given, assumes the current user's owner. The basic difference between view and access is that access doesn't check any view permission for own transactions.

Specified by:

isAccessible in interface TransactionServiceLocal

isCheckConfirmationPassword

public boolean isCheckConfirmationPassword(PaymentTransferType paymentType,
                                           InternalAccountOwner owner,
                                           BigDecimal amount,
                                           Date date)

Description copied from interface: TransactionServiceLocal

It returns true if the confirmation password must be required because the payment's amount is greater than or equals to the maximum for a pin-less payment. This method always check the maximum per transaction and (optionally) the maximum per day.

Specified by:

isCheckConfirmationPassword in interface TransactionServiceLocal

Parameters:

paymentType - the type used for the payment.

date - if null then the method will only check the maximum per transaction for a pin-less payment.
Otherwise it will check both maximums: per transaction and per day (for the specified date).
Note: To check the maximum per day for the current day you can use DateHelper.now() as the last parameter.

isVisible

public boolean isVisible(InternalAccountOwner owner,
                         TransactionNature nature)

Description copied from interface: TransactionServiceLocal

Returns whether the logged user can see transactions of the given nature for the given optional owner. When no owner is given, returns whether can view transactions of that nature, regardless of the owner.

Specified by:

isVisible in interface TransactionServiceLocal

listPaymentTypes

public List<PaymentTransferType> listPaymentTypes(LocateAccountOwnerResult from,
                                                  LocateAccountOwnerResult to,
                                                  Currency currency,
                                                  boolean receive)

Description copied from interface: TransactionServiceLocal

Returns the possible payment, optionally in a currency, types between the given owners

Specified by:

listPaymentTypes in interface TransactionServiceLocal

load

public TransactionVO load(Long id)
                   throws FrameworkException

Description copied from interface: TransactionService

Loads a transaction details by id, returning a proper detailed implementation (for example, PaymentVO or ScheduledPaymentVO).

Specified by:

load in interface TransactionService

Throws:

FrameworkException

loadByTransactionNumber

public TransactionVO loadByTransactionNumber(String transactionNumber)
                                      throws FrameworkException

Description copied from interface: TransactionService

Returns a transfer by transaction number, or throws EntityNotFoundException if not found

Specified by:

loadByTransactionNumber in interface TransactionService

Throws:

FrameworkException

locateForPayment

public LocateAccountOwnerResult locateForPayment(InternalAccountOwner owner)

Description copied from interface: TransactionServiceLocal

Locate the receiver when performing a payment using the principal types allowed to perform a payment.

Specified by:

locateForPayment in interface TransactionServiceLocal

locateForReceiving

public LocateAccountOwnerResult locateForReceiving(InternalAccountOwner owner)

Description copied from interface: TransactionServiceLocal

Locate the payer when receiving a payment using the principal types allowed to receive a payment.
Additionally, it checks if the BuiltInChannel.POS channel is accessible for the located payer.

Specified by:

locateForReceiving in interface TransactionServiceLocal

newData

public <D extends TransactionData> D newData(Transaction transaction)

Description copied from interface: TransactionServiceLocal

Returns a new instance of the Data for the specific transaction, filled-in with basic data

Specified by:

newData in interface TransactionServiceLocal

persist

public void persist(Transaction transaction)

Description copied from interface: TransactionServiceLocal

Persists the given transaction and immediately performs additional actions, such as calling the CustomFieldValueHandler.processAfterSave(org.cyclos.entities.system.EntityWithCustomValues) method.

Specified by:

persist in interface TransactionServiceLocal

prepareValidation

public org.cyclos.impl.banking.TransactionValidationData prepareValidation(PrepareValidationParameter parameter)
                                                                    throws FrameworkException

Description copied from interface: TransactionServiceLocal

Returns a validator filled with all common validations, plus some other data which was already loaded.

Specified by:

prepareValidation in interface TransactionServiceLocal

Throws:

FrameworkException

processInstallment

public TransferVO processInstallment(InstallmentActionDTO action)
                              throws FrameworkException

Description copied from interface: TransactionService

Settles an installment. Currently only scheduled payment installments can be settled.

Specified by:

processInstallment in interface TransactionService

Throws:

FrameworkException

receive

public <T> T receive(InternalAccountOwner from,
                     Callable<T> action)
              throws FrameworkException

Description copied from interface: TransactionServiceLocal

Sets up the session data for receiving a transaction from the given user, invoking the given Callable in it.

Specified by:

receive in interface TransactionServiceLocal

Throws:

FrameworkException

removeDeviceConfirmationForReceive

public void removeDeviceConfirmationForReceive(String deviceConfirmationId,
                                               @NotNull
                                               @NotNull PerformInternalTransactionDTO parameters)
                                        throws FrameworkException

Description copied from interface: TransactionService

Removes a confirmation for the payer. It has the same security controls as for PaymentService.receive(PerformPaymentDTO), that is the logged user must be allowed to receive payments from the specified payer.

Specified by:

removeDeviceConfirmationForReceive in interface TransactionService

Throws:

FrameworkException

requestNewOTPForReceive

public void requestNewOTPForReceive(PerformInternalTransactionDTO parameters,
                                    SendMedium medium)
                             throws FrameworkException,
                                    SmsSendingException

Description copied from interface: TransactionService

Generates a new OTP (removing any previous password, if any) and sends it to the payer by the specified medium using the confirmation password type for the BuiltInChannel.POS channel for the specified payer.
It has the same security controls as for PaymentService.receive(PerformPaymentDTO), that is the logged user must be allowed to receive payments from the specified payer.

Specified by:

requestNewOTPForReceive in interface TransactionService

Parameters:

parameters - the payment to be received.

medium - the medium used to send the OTP.

Throws:

SmsSendingException - only if medium is SendMedium.SMS and the OTP could not be sent to any enabled for sms phone.

FrameworkException

resolvePaymentType

public PaymentTransferType resolvePaymentType(InternalAccountOwner from,
                                              AccountOwner to,
                                              Currency currency,
                                              Channel channel,
                                              PrincipalType principalType,
                                              PaymentCreationType creationType)
                                       throws FrameworkException

Description copied from interface: TransactionServiceLocal

Returns the payment type matching the from, to, and optionally, currency according to the given payment operation. If none or more than one exists, returns null.

Specified by:

resolvePaymentType in interface TransactionServiceLocal

Throws:

FrameworkException

search

public Page<TransactionResultVO> search(TransactionQuery params)
                                 throws FrameworkException

Description copied from interface: TransactionService

Searches for transactions from the point-of-view of a given account owner, according to the given query

Specified by:

search in interface TransactionService

Throws:

FrameworkException

searchInstallments

public Page<InstallmentResultVO> searchInstallments(@NotNull
                                                    @NotNull InstallmentQuery params)
                                             throws FrameworkException

Description copied from interface: TransactionService

Searches for installments from an account owner perspective, according to the given query

Specified by:

searchInstallments in interface TransactionService

Throws:

FrameworkException

searchInstallmentsOverview

public Page<InstallmentResultVO> searchInstallmentsOverview(@NotNull
                                                            @NotNull InstallmentOverviewQuery params)
                                                     throws FrameworkException

Description copied from interface: TransactionService

Searches for installments overview, according to the given query

Specified by:

searchInstallmentsOverview in interface TransactionService

Throws:

FrameworkException

searchOverview

public Page<TransactionResultVO> searchOverview(@NotNull
                                                @NotNull TransactionOverviewQuery params)
                                         throws FrameworkException

Description copied from interface: TransactionService

Searches for transactions, according to the given query

Specified by:

searchOverview in interface TransactionService

Throws:

FrameworkException

setStatusAndGetExtensionPoint

public ExtensionPointAccessor setStatusAndGetExtensionPoint(Installment installment,
                                                            InstallmentStatus newStatus)

Description copied from interface: TransactionServiceLocal

Creates a ExtensionPointAccessor for a status change, fires the validated event and sets new status

Specified by:

setStatusAndGetExtensionPoint in interface TransactionServiceLocal

setStatusAndGetExtensionPoint

public <T extends Transaction & HasTransactionStatus<S>,S extends TransactionStatus> ExtensionPointAccessor setStatusAndGetExtensionPoint(T transaction,
                                                                                                                                                S newStatus)

Description copied from interface: TransactionServiceLocal

Creates a ExtensionPointAccessor for a status change, fires the validated event and sets new status

Specified by:

setStatusAndGetExtensionPoint in interface TransactionServiceLocal

settleInstallment

public void settleInstallment(InstallmentActionDTO action)
                       throws FrameworkException

Description copied from interface: TransactionService

Settles an installment. Currently only scheduled payment installments can be settled.

Specified by:

settleInstallment in interface TransactionService

Throws:

FrameworkException

updatePreviewAndPayment

public void updatePreviewAndPayment(BasePaymentPreviewVO preview,
                                    PerformTransactionDTO dto,
                                    LocateAccountOwnerResult from,
                                    LocateAccountOwnerResult to,
                                    TransferType paymentType,
                                    SessionData receiverSessionData)

Description copied from interface: TransactionServiceLocal

Updates the given preview BasePaymentPreviewVO and set the given paymentDTO PerformTransactionDTO after make it suitable to be returned again after a preview

Specified by:

updatePreviewAndPayment in interface TransactionServiceLocal

validateMinTimeBetweenPayments

public void validateMinTimeBetweenPayments(LocateAccountOwnerResult owner,
                                           PaymentTransferType paymentType)
                                    throws FrameworkException,
                                           TransferException

Description copied from interface: TransactionServiceLocal

Validates the minimum time between payments

Specified by:

validateMinTimeBetweenPayments in interface TransactionServiceLocal

Throws:

FrameworkException

TransferException

validatePaymentAmount

public void validatePaymentAmount(LocateAccountOwnerResult from,
                                  LocateAccountOwnerResult to,
                                  PaymentTransferType paymentType,
                                  BigDecimal amount,
                                  Date date)
                           throws FrameworkException,
                                  TransferException

Description copied from interface: TransactionServiceLocal

Validates an amount to be paid from the given account.

Specified by:

validatePaymentAmount in interface TransactionServiceLocal

Throws:

FrameworkException

TransferException

viewDeviceConfirmationForReceive

public DeviceConfirmationVO viewDeviceConfirmationForReceive(String deviceConfirmationId,
                                                             @NotNull
                                                             @NotNull PerformInternalTransactionDTO parameters)
                                                      throws FrameworkException

Description copied from interface: TransactionService

Loads the details of a confirmation belonging to the payment payer. It has the same security controls as for PaymentService.receive(PerformPaymentDTO), that is the logged user must be allowed to receive payments from the specified payer.

Specified by:

viewDeviceConfirmationForReceive in interface TransactionService

Throws:

FrameworkException

doIterate

protected com.mysema.commons.lang.CloseableIterator<Installment> doIterate(BaseInstallmentQuery params)

doIterate

protected com.mysema.commons.lang.CloseableIterator<Transaction> doIterate(BaseTransactionQuery params)

registerNetworkMappings

protected void registerNetworkMappings(NetworkPathRegistry networkPathRegistry)

Description copied from class: BaseServiceImpl

Needs to be overridden by subclasses to register the path up to the network

Specified by:

registerNetworkMappings in class BaseServiceImpl