Package dev.restate.sdk.endpoint.definition

Class InvocationRetryPolicy

java.lang.Object

dev.restate.sdk.endpoint.definition.InvocationRetryPolicy

public final class InvocationRetryPolicy
extends Object

Retry policy used by Restate when retrying failed handler invocations.

This policy controls an exponential backoff with optional capping and a terminal action:

• initialInterval: delay before the first retry attempt.
• exponentiationFactor: multiplier applied to the previous delay to compute the next delay.
• maxInterval: upper bound for any computed delay.
• maxAttempts: maximum number of attempts (initial call counts as the first attempt).
• onMaxAttempts: what to do when maxAttempts is reached.

Unset fields inherit the corresponding defaults from the Restate server configuration. Implementations may also enforce system-wide minimum/maximum bounds.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InvocationRetryPolicy.Builder
static enum	InvocationRetryPolicy.OnMaxAttempts	Behavior when retry policy reaches maxAttempts() attempts.

Method Summary

Modifier and Type	Method	Description
static InvocationRetryPolicy.Builder	builder()
boolean	equals(Object o)
@Nullable Double	exponentiationFactor()	Exponential backoff multiplier used to compute the next retry delay.
int	hashCode()
@Nullable Duration	initialInterval()	Initial delay before the first retry attempt.
@Nullable Integer	maxAttempts()	Maximum number of attempts before giving up retrying.
@Nullable Duration	maxInterval()	Upper bound for the computed retry delay.
@Nullable InvocationRetryPolicy.OnMaxAttempts	onMaxAttempts()	Behavior when the configured maxAttempts() is reached.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Details

initialInterval

public @Nullable Duration initialInterval()

Initial delay before the first retry attempt.

If unset, the server default is used.

exponentiationFactor

public @Nullable Double exponentiationFactor()

Exponential backoff multiplier used to compute the next retry delay.

For attempt n, the next delay is roughly previousDelay * exponentiationFactor, capped by maxInterval() if set.

maxInterval

public @Nullable Duration maxInterval()

Upper bound for the computed retry delay.

If set, any computed delay will not exceed this value.

maxAttempts

public @Nullable Integer maxAttempts()

Maximum number of attempts before giving up retrying.

The initial call counts as the first attempt; retries increment the count by 1. When giving up, the behavior defined with onMaxAttempts() will be applied.

See Also:

• InvocationRetryPolicy.OnMaxAttempts

onMaxAttempts

public @Nullable InvocationRetryPolicy.OnMaxAttempts onMaxAttempts()

Behavior when the configured maxAttempts() is reached.

See Also:

• InvocationRetryPolicy.OnMaxAttempts

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

builder

public static InvocationRetryPolicy.Builder builder()

Returns:

a new InvocationRetryPolicy.Builder to configure an InvocationRetryPolicy.