run

Runs supplied transactional logic until success or failure.

The supplied transactional logic will be run if necessary multiple times, until either:

• The transaction successfully commits

• The transactional logic requests an explicit rollback

• The transaction times out.

• An exception is thrown, either inside the transaction library or by the supplied transaction logic, that cannot be handled.

The transaction logic {@link Consumer} is provided an {@link TransactionAttemptContext}, which contains methods allowing it to read, mutate, insert and delete documents, as well as commit or rollback the transaction.

If the transaction logic performs a commit or rollback it must be the last operation performed. Else a TransactionFailedException will be thrown. Similarly, there cannot be a commit followed by a rollback, or vice versa - this will also raise a TransactionFailedException.

If the transaction logic does not perform an explicit commit or rollback, then a commit will be performed anyway.

Return

The value returned by the transaction logic, along with diagnostic information.

Parameters

Throws