pub struct RetryDelay { /* private fields */ }
Expand description

An implementation for retrying a remote operation based on a decorrelated jitter schedule.

The algorithm used here has several desirable properties:

  • It is randomized, so that multiple timeouts don’t have a danger of getting synchronized with each other and hammering the same servers all at once.
  • It tends on average to wait longer and longer over time, so that if the server is down, it won’t get pummeled by a zillion failing clients when it comes back up.
  • It has a chance of retrying promptly, which results in better client performance on average.

For a more full specification, see dir-spec.txt.

Implementations

Construct a new RetryDelay from a given base delay in milliseconds.

The base delay defines the lowest possible interval that can be returned.

Limitations

If the base delay is less than 1000, a base delay of 1000 is used instead, since that’s what the C tor implementation does.

Construct a new RetryDelay from a given base delay.

See from_msec for more information.

Return the next delay to be used (as a Duration), according to a given random number generator.

Return this RetryDelay to its original state.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Returns the “default value” for a type. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.