com.amazonaws.services.simpleworkflow.flow.annotations

Annotation Type ExponentialRetry

@Target(value=METHOD)
@Retention(value=RUNTIME)
public @interface ExponentialRetry

This annotation can be used for retrying failures on any asynchronous executions.

For retrying based on dynamic retry policy use RetryDecorator. Both @ExponentialRetry annotation and RetryDecorator should not be used simultaneously on the same asynchronous method call.

To allow retries for an individual activity, place the annotation on the desired activity method in the corresponding @Activities interface. Since a new activity instance is started per retry, any timeouts configured on the

Author:

fateev, samar

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
long	initialRetryIntervalSeconds Interval to wait after the initial failure, before triggering a retry.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
double	backoffCoefficient Coefficient to use for exponential retry policy.
Class<? extends Throwable>[]	exceptionsToRetry Default is Throwable which means that all exceptions are retried.
Class<? extends Throwable>[]	excludeExceptions What exceptions that match exceptionsToRetry list should be not retried.
int	maximumAttempts Number of maximum retry attempts (including the initial attempt).
long	maximumRetryIntervalSeconds Maximum interval to wait between retry attempts.
long	retryExpirationSeconds Total duration across all attempts before giving up and attempting no further retries.

Element Detail

initialRetryIntervalSeconds

public abstract long initialRetryIntervalSeconds

Interval to wait after the initial failure, before triggering a retry.

This value should not be greater than values specified for maximumRetryPeriod or retryExpirationPeriod.

maximumRetryIntervalSeconds

public abstract long maximumRetryIntervalSeconds

Maximum interval to wait between retry attempts.

This value should not be less than value specified for initialRetryPeriod. Default value is unlimited.

Default:

-1L

retryExpirationSeconds

public abstract long retryExpirationSeconds

Total duration across all attempts before giving up and attempting no further retries.

This duration is measured relative to the initial attempt's starting time. and

This value should not be less than value specified for initialRetryPeriod. Default value is unlimited.

Default:

-1L

backoffCoefficient

public abstract double backoffCoefficient

Coefficient to use for exponential retry policy.

The retry interval will be multiplied by this coefficient after each subsequent failure. Default is 2.0.

Default:

2.0

maximumAttempts

public abstract int maximumAttempts

Number of maximum retry attempts (including the initial attempt). Default value is no limit.

Default:

-1

exceptionsToRetry

public abstract Class<? extends Throwable>[] exceptionsToRetry

Default is Throwable which means that all exceptions are retried.

Default:

java.lang.Throwable.class

excludeExceptions

public abstract Class<? extends Throwable>[] excludeExceptions

What exceptions that match exceptionsToRetry list should be not retried. Default is empty list.

Default:

{}