Struct BackoffPolicy 

pub struct BackoffPolicy { /* private fields */ }

A deterministic, jitter-free backoff schedule.

Every delay is derived only from the fingerprinted policy and the retry ordinal, so a restart reproduces the same schedule.

Implementations

impl BackoffPolicy

pub const fn none() -> BackoffPolicy

Returns the immediate-retry schedule.

pub fn fixed(delay: Duration) -> Result<BackoffPolicy, FaultPolicyError>

Returns a constant-delay schedule.

Errors

Returns FaultPolicyError::BackoffDelayTooLong above 24 hours.

pub fn exponential( initial: Duration, multiplier: u32, maximum: Duration, ) -> Result<BackoffPolicy, FaultPolicyError>

Returns an integer exponential schedule capped at maximum.

Errors

Rejects a zero multiplier, a delay above 24 hours, and a maximum below the initial delay.

pub const fn kind(self) -> BackoffKind

Returns the selected backoff family.

pub const fn initial(self) -> Duration

Returns the first-retry delay.

pub const fn multiplier(self) -> u32

Returns the integer growth factor.

pub const fn maximum(self) -> Duration

Returns the schedule ceiling.

pub fn delay_for(self, ordinal: RetryOrdinal) -> Duration

Returns the delay that precedes the retry identified by ordinal.

The initial call never waits. Arithmetic is checked and capped at the configured maximum, so a large ordinal cannot overflow or exceed the declared bound.

Trait Implementations

impl Clone for BackoffPolicy

fn clone(&self) -> BackoffPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BackoffPolicy

impl Debug for BackoffPolicy

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

Formats the value using the given formatter.

impl Eq for BackoffPolicy

impl Hash for BackoffPolicy

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BackoffPolicy

fn eq(&self, other: &BackoffPolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BackoffPolicy