Package software.amazon.lambda.durable.retry

Class RetryStrategies

java.lang.Object

software.amazon.lambda.durable.retry.RetryStrategies

public class RetryStrategies
extends Object

Factory class for creating common retry strategies.

This class provides preset retry strategies for common use cases, as well as factory methods for creating custom retry strategies with exponential or linear backoff and jitter.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RetryStrategies.Presets	Preset retry strategies for common use cases.

Constructor Summary

Constructors

Constructor	Description
RetryStrategies()

Method Summary

Modifier and Type	Method	Description
static RetryStrategy	exponentialBackoff(int maxAttempts, Duration initialDelay, Duration maxDelay, double backoffRate, JitterStrategy jitter)	Creates an exponential backoff retry strategy.
static RetryStrategy	fixedDelay(int maxAttempts, Duration fixedDelay)	Creates a simple retry strategy that retries a fixed number of times with a fixed delay.
static RetryStrategy	linearBackoff(int maxAttempts, Duration initialDelay, Duration increment)	Creates a linear backoff retry strategy.
static RetryStrategy	linearBackoff(int maxAttempts, Duration initialDelay, Duration maxDelay, Duration increment, JitterStrategy jitter)	Creates a linear backoff retry strategy.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RetryStrategies

public RetryStrategies()

Method Details

exponentialBackoff

public static RetryStrategy exponentialBackoff(int maxAttempts,
 Duration initialDelay,
 Duration maxDelay,
 double backoffRate,
 JitterStrategy jitter)

Creates an exponential backoff retry strategy.

The delay calculation follows the formula: baseDelay = min(initialDelay × backoffRate^(attempt-1), maxDelay)

Parameters:

maxAttempts - Maximum number of attempts (including initial attempt)

initialDelay - Initial delay before first retry

maxDelay - Maximum delay between retries

backoffRate - Multiplier for exponential backoff

jitter - Jitter strategy to apply to delays

Returns:

RetryStrategy implementing exponential backoff with jitter

linearBackoff

public static RetryStrategy linearBackoff(int maxAttempts,
 Duration initialDelay,
 Duration increment)

Creates a linear backoff retry strategy.

The delay calculation follows the formula: delay = initialDelay + increment × (attempt-1)

Parameters:

maxAttempts - Maximum number of attempts (including initial attempt)

initialDelay - Initial delay before first retry

increment - Amount to add to the delay after each retry attempt

Returns:

RetryStrategy implementing linear backoff

linearBackoff

public static RetryStrategy linearBackoff(int maxAttempts,
 Duration initialDelay,
 Duration maxDelay,
 Duration increment,
 JitterStrategy jitter)

Creates a linear backoff retry strategy.

The delay calculation follows the formula: baseDelay = min(initialDelay + increment × (attempt-1), maxDelay)

Parameters:

maxAttempts - Maximum number of attempts (including initial attempt)

initialDelay - Initial delay before first retry

maxDelay - Maximum delay between retries

increment - Amount to add to the delay after each retry attempt

jitter - Jitter strategy to apply to delays

Returns:

RetryStrategy implementing linear backoff with jitter

fixedDelay

public static RetryStrategy fixedDelay(int maxAttempts,
 Duration fixedDelay)

Creates a simple retry strategy that retries a fixed number of times with a fixed delay.

Parameters:

maxAttempts - Maximum number of attempts (including initial attempt)

fixedDelay - Fixed delay between retries

Returns:

RetryStrategy with fixed delay