Interface BackOff (1.43.0)

public interface BackOff

Back-off policy when retrying an operation.

Static Fields

STOP

public static final long STOP

Indicates that no more retries should be made for use in #nextBackOffMillis().

Field Value
TypeDescription
long

STOP_BACKOFF

public static final BackOff STOP_BACKOFF

Fixed back-off policy that always returns #STOP for #nextBackOffMillis(), meaning that the operation should not be retried.

Field Value
TypeDescription
BackOff

ZERO_BACKOFF

public static final BackOff ZERO_BACKOFF

Fixed back-off policy whose back-off time is always zero, meaning that the operation is retried immediately without waiting.

Field Value
TypeDescription
BackOff

Methods

nextBackOffMillis()

public abstract long nextBackOffMillis()

Gets the number of milliseconds to wait before retrying the operation or #STOP to indicate that no retries should be made.

Example usage:

long backOffMillis = backoff.nextBackOffMillis(); if (backOffMillis == Backoff.STOP) { // do not retry operation } else { // sleep for backOffMillis milliseconds and retry operation }

Returns
TypeDescription
long
Exceptions
TypeDescription
IOException

reset()

public abstract void reset()

Reset to initial state.

Exceptions
TypeDescription
IOException