initCaptureCancel(final ICaptureCancelRequest, final CallerInformation) method

Syntax

InitTransactionResult initCaptureCancel ( final ICaptureCancelRequest request , final CallerInformation caller ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• request – the capture-cancel request
• caller – the actor (authenticated user)

Returns

a InitTransactionResult holding the id of the newly created CaptureCancel transaction along with the parameters from the main Transaction

Exceptions

• MobiliserServiceException – if initializing 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

CaptureCancel

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 holding the id of the newly created CaptureCancel transaction along with the parameters from the main Transaction