initTransactionCancel(final ITransactionCancelRequest, final CallerInformation) method

Syntax

InitTransactionResult initTransactionCancel ( final ITransactionCancelRequest request , final CallerInformation caller ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• request – the transactioncancel request
• caller – the actor (authenticated user)

Returns

a InitTransactionResult with the parameters from the main Transaction

Exceptions

• MobiliserServiceException – if initialising the transaction fails for some reason (business rules)
• DataAccessException – if some error occurs communicating / writing / reading persistent storage
• TransactionException – if some error occurs while handling the transactions related to persistent storage

Usage

Creates and initializes the

TransactionCancel

transaction in the database with the values from the request, performing various checks in the process.

Notes on transactional semantics:

If a business logic exception occurs, a

MobiliserServiceException

will be thrown which will trigger a rollback. Any other exception will also trigger a rollback of the database transaction.

a InitTransactionResult with the parameters from the main Transaction