initAuthorisation(final Long, final IGenericAuthorisationRequest, final CallerInformation) method

Syntax

void initAuthorisation ( final Long authorisationId , final IGenericAuthorisationRequest request , final CallerInformation caller ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• authorisationId – the id of the authorization transaction to initialize
• request – the authorisation request
• caller – the actor (authenticated user)

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

Actually initializes the

Authorisation

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 and both transactions will be marked with the error code from the exception and the database transaction committed. Any other exception will trigger a rollback of the database transaction followed by a fresh transaction inside of which the

Authorisation

transaction will be marked with an error code.