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

Syntax

void initAuthorisation ( final Long authId , final IWebContinueRequest request , final CallerInformation caller )

Parameters

• authId – the id of the authorization transaction to initialize
• request – the web-continue 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.