Struct RetryConfig

#[non_exhaustive]
pub struct RetryConfig { /* private fields */ }

Retry configuration for requests.

Implementations

impl RetryConfig

pub fn standard() -> Self

Creates a default RetryConfig with RetryMode::Standard and max attempts of three.

pub fn adaptive() -> Self

Creates a default RetryConfig with RetryMode::Adaptive and max attempts of three.

pub fn disabled() -> Self

Creates a RetryConfig that has retries disabled.

pub fn with_retry_mode(self, retry_mode: RetryMode) -> Self

Set this config’s retry mode.

pub fn with_max_attempts(self, max_attempts: u32) -> Self

Set the maximum number of times a request should be tried, including the initial attempt. This value must be greater than zero.

pub fn with_reconnect_mode(self, reconnect_mode: ReconnectMode) -> Self

Set the ReconnectMode for the retry strategy

By default, when a transient error is encountered, the connection in use will be poisoned. This prevents reusing a connection to a potentially bad host but may increase the load on the server.

This behavior can be disabled by setting ReconnectMode::ReuseAllConnections instead.

pub fn with_initial_backoff(self, initial_backoff: Duration) -> Self

Set the multiplier used when calculating backoff times as part of an exponential backoff with jitter strategy. Most services should work fine with the default duration of 1 second, but if you find that your requests are taking too long due to excessive retry backoff, try lowering this value.

Example

For a request that gets retried 3 times, when initial_backoff is 1 seconds:

• the first retry will occur after 0 to 1 seconds
• the second retry will occur after 0 to 2 seconds
• the third retry will occur after 0 to 4 seconds

For a request that gets retried 3 times, when initial_backoff is 30 milliseconds:

• the first retry will occur after 0 to 30 milliseconds
• the second retry will occur after 0 to 60 milliseconds
• the third retry will occur after 0 to 120 milliseconds

pub fn with_max_backoff(self, max_backoff: Duration) -> Self

Set the maximum backoff time.

pub fn with_use_static_exponential_base( self, use_static_exponential_base: bool, ) -> Self

Hint to the retry strategy whether to use a static exponential base.

When a retry strategy uses exponential backoff, it calculates a random base. This causes the retry delay to be slightly random, and helps prevent “thundering herd” scenarios. However, it’s often useful during testing to know exactly how long the delay will be.

Therefore, if you’re writing a test and asserting an expected retry delay, set this to true.

pub fn mode(&self) -> RetryMode

Returns the retry mode.

pub fn reconnect_mode(&self) -> ReconnectMode

Returns the ReconnectMode

pub fn max_attempts(&self) -> u32

Returns the max attempts.

pub fn initial_backoff(&self) -> Duration

Returns the backoff multiplier duration.

pub fn max_backoff(&self) -> Duration

Returns the max backoff duration.

pub fn has_retry(&self) -> bool

Returns true if retry is enabled with this config

pub fn use_static_exponential_base(&self) -> bool

Returns true if retry strategies should use a static exponential base instead of the default random base.

To set this value, the test-util feature must be enabled.

Trait Implementations

impl Clone for RetryConfig

fn clone(&self) -> RetryConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RetryConfig

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

Formats the value using the given formatter.

impl PartialEq for RetryConfig

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Storable for RetryConfig

type Storer = StoreReplace<RetryConfig>

Specify how an item is stored in the config bag, e.g. StoreReplace and StoreAppend

impl StructuralPartialEq for RetryConfig