org.dellroad.stuff.spring

Interface RetryTransactionProvider

public interface RetryTransactionProvider

Interface implemented by the RetryTransactionAspect, which implements the RetryTransaction functionality.

See Also:

RetryTransaction

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	RetryTransactionProvider.RetrySetup<T> Holds the configuration information that is required when applying retry logic.

Method Summary

Modifier and Type	Method and Description
int	getAttemptNumber() Get the current transaction attempt number in the inner-most active transaction.
int	getAttemptNumber(String transactionManagerName) Get the current transaction attempt number for the specified transaction manager.
long	getInitialDelayDefault() Get the aspect-wide default for RetryTransaction.initialDelay().
long	getMaximumDelayDefault() Get the aspect-wide default for RetryTransaction.maximumDelay().
int	getMaxRetriesDefault() Get the aspect-wide default for RetryTransaction.maxRetries().
PersistenceExceptionTranslator	getPersistenceExceptionTranslator() Get the configured exception translator.
<T> T	retry(RetryTransactionProvider.RetrySetup<T> setup) Perform a transaction, retrying as necessary.

Method Detail

getPersistenceExceptionTranslator

PersistenceExceptionTranslator getPersistenceExceptionTranslator()

Get the configured exception translator.

Returns:

exception translator used to determine which transactions are retryable

getMaxRetriesDefault

int getMaxRetriesDefault()

Get the aspect-wide default for RetryTransaction.maxRetries().

Returns:

default maximum number of transaction retry attempts

getInitialDelayDefault

long getInitialDelayDefault()

Get the aspect-wide default for RetryTransaction.initialDelay().

Returns:

default initial delay between retry attempts in milliseconds

getMaximumDelayDefault

long getMaximumDelayDefault()

Get the aspect-wide default for RetryTransaction.maximumDelay().

Returns:

default maximum delay between retry attempts in milliseconds

getAttemptNumber

int getAttemptNumber()

Get the current transaction attempt number in the inner-most active transaction.

Equivalent to getAttemptNumber(null).

Returns:

transaction attempt number, or zero if the aspect is not active in the current thread

getAttemptNumber

int getAttemptNumber(String transactionManagerName)

Get the current transaction attempt number for the specified transaction manager.

Parameters:

transactionManagerName - transaction manager name, or null to match all

Returns:

transaction attempt number, or zero if the aspect is not active in the current thread for the transaction manager

retry

<T> T retry(RetryTransactionProvider.RetrySetup<T> setup)

Perform a transaction, retrying as necessary.

This method provides a way to apply retry logic directly without going through a method woven with the aspect.

Type Parameters:

T - transaction return type

Parameters:

setup - retryable transaction setup

Returns:

result from transaction

Throws:

IllegalArgumentException - if setup is null