initWebTransaction(final Long, final IWebStartRequest, final IWebStartResponse, final CallerInformation) method

Syntax

void initWebTransaction ( final Long authorisationId , final IWebStartRequest request , final IWebStartResponse response , final CallerInformation caller ) throws MobiliserServiceException, DataAccessException, TransactionException

Parameters

• authorisationId – the id of the Authorisation transaction to initialize
• request – the web start request to process
• response – the web start response, which might get filled with additional data during processing.
• caller – the actor (authenticated user)

Exceptions

• MobiliserServiceException – if the initialization of 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

This method complements

IWebActions#createWebTransactions(IWebStartRequest, Long)

. After successfully creating the transactions, this action can be used to actually initialize all relevant fields in the

Authorisation

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.