Skip to main content

HttpRequestRetryOverride

qubit_http

Struct HttpRequestRetryOverride 

Source 
pub struct HttpRequestRetryOverride { /* private fields */ }
Expand description

Per-request overrides for the client retry strategy.

This type allows callers to:

  • force-enable retry even when client-level retry is disabled;
  • force-disable retry for one request;
  • override the retryable-method policy for one request;
  • optionally honor Retry-After on 429 Too Many Requests.

Implementations§

Source§

impl HttpRequestRetryOverride

Source

pub fn new() -> Self

Creates an empty override that follows client-level retry settings.

§Returns

New HttpRequestRetryOverride with all per-request overrides disabled.

Source

pub fn force_enable(self) -> Self

Enables force-retry for this request and clears force-disable.

§Returns

Updated override for chaining.

Source

pub fn force_disable(self) -> Self

Enables force-disable for this request and clears force-enable.

§Returns

Updated override for chaining.

Source

pub fn with_method_policy(self, policy: HttpRetryMethodPolicy) -> Self

Sets the per-request retryable-method policy override.

§Parameters
  • policy: Method policy to use for this request.
§Returns

Updated override for chaining.

Source

pub fn with_honor_retry_after(self, enabled: bool) -> Self

Enables or disables honoring Retry-After for this request.

§Parameters
  • enabled: true to honor Retry-After on 429 responses.
§Returns

Updated override for chaining.

Source

pub fn is_force_enable(&self) -> bool

Returns whether force-enable is active for this request.

§Returns

true when retry is force-enabled at request level.

Source

pub fn is_force_disable(&self) -> bool

Returns whether force-disable is active for this request.

§Returns

true when retry is force-disabled at request level.

Source

pub fn method_policy(&self) -> Option<HttpRetryMethodPolicy>

Returns the per-request method-policy override, if present.

§Returns

Optional override for HttpRetryMethodPolicy.

Source

pub fn should_honor_retry_after(&self) -> bool

Returns whether Retry-After should be honored for this request.

§Returns

true when this request should honor Retry-After on 429.

Trait Implementations§

Source§

impl Clone for HttpRequestRetryOverride

Source§

fn clone(&self) -> HttpRequestRetryOverride

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for HttpRequestRetryOverride

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for HttpRequestRetryOverride

Source§

fn default() -> HttpRequestRetryOverride

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

impl PartialEq for HttpRequestRetryOverride

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Eq for HttpRequestRetryOverride

Source§

impl StructuralPartialEq for HttpRequestRetryOverride

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

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

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

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

fn clone_into(&self, target: &mut T)

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

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more