Struct BackoffRetryPolicy

pub struct BackoffRetryPolicy {
    pub retries: usize,
    pub initial_backoff: Duration,
    pub multiplier: f64,
    pub max_backoff: Duration,
}

A retry policy that implements exponential backoff.

This policy will retry failed operations with increasing delays between attempts, using an exponential backoff algorithm with a configurable multiplier.

Fields

• retries - Maximum number of retry attempts
• initial_backoff - Initial delay duration before first retry
• multiplier - Factor by which the delay increases after each attempt
• max_backoff - Maximum delay duration between retries

Example

let policy = BackoffRetryPolicy {
    retries: 5,
    initial_backoff: Duration::from_secs(1),
    multiplier: 2.0,
    max_backoff: Duration::from_secs(60),
};

Fields

retries: usize

Maximum number of retry attempts

initial_backoff: Duration

Initial delay duration before first retry

multiplier: f64

Factor by which the delay increases after each attempt

max_backoff: Duration

Maximum delay duration between retries

Trait Implementations

impl Clone for BackoffRetryPolicy

fn clone(&self) -> BackoffRetryPolicy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BackoffRetryPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BackoffRetryPolicy

Default configuration for retry policy

fn default() -> Self

Returns the “default value” for a type.

impl<T, Res, Ctx> Policy<Request<T, Ctx>, Res, Error> for BackoffRetryPolicy

where T: Clone, Ctx: Clone,

type Future = Sleep

The Future type returned by [Policy::retry].

fn retry( &mut self, req: &mut Request<T, Ctx>, result: &mut Result<Res, Error>, ) -> Option<Self::Future>

Check the policy if a certain request should be retried.

fn clone_request(&mut self, req: &Request<T, Ctx>) -> Option<Request<T, Ctx>>

Tries to clone a request before being passed to the inner service.