Struct ReconnectOptions 

#[non_exhaustive]
pub struct ReconnectOptions {
    pub initial_delay: Duration,
    pub max_delay: Duration,
    pub multiplier: BackoffMultiplier,
    pub jitter: Jitter,
    pub stop_on_fatal_rejection: bool,
}

Configuration for automatic reconnection with exponential backoff.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

initial_delay: Duration

Initial delay before the first reconnection attempt.

max_delay: Duration

Maximum delay between reconnection attempts.

multiplier: BackoffMultiplier

Multiplicative factor applied after each failed attempt.

jitter: Jitter

Random jitter fraction applied to each delay.

stop_on_fatal_rejection: bool

Whether a CONNACK rejection that needs operator intervention (unsupported protocol version, invalid client id, bad credentials, not authorized, banned) stops the reconnect loop with a final Rejected status. Defaults to false: such rejections are often fixed server-side, so the client keeps retrying with backoff.

Implementations

impl ReconnectOptions

pub const fn new() -> Self

Creates options with sensible defaults: 1 s initial delay, 30 s maximum delay, 2x multiplier, 25% jitter, retry on every rejection.

pub const fn initial_delay(self, delay: Duration) -> Self

Sets the initial delay before the first reconnection attempt.

pub const fn max_delay(self, delay: Duration) -> Self

Sets the maximum delay between reconnection attempts.

pub const fn multiplier(self, multiplier: BackoffMultiplier) -> Self

Sets the multiplicative factor applied after each failed attempt.

pub const fn jitter(self, jitter: Jitter) -> Self

Sets the random jitter fraction applied to each delay.

pub const fn stop_on_fatal_rejection(self, stop: bool) -> Self

Sets whether a fatal CONNACK rejection stops the reconnect loop (see stop_on_fatal_rejection).

Trait Implementations

impl Default for ReconnectOptions

fn default() -> Self

Returns the “default value” for a type.