Struct FollowRedirect 

pub struct FollowRedirect<P = AlwaysRedirect> { /* private fields */ }

Available on crate feature client only.

Layer for following HTTP redirect responses.

This layer should be added as an outer client layer so that each redirected target is applied before service discovery and load balancing run for the next hop.

Each redirect hop is sent as a new request to the redirected target. Origin-specific headers generated by the client, including Host, are updated for the next hop instead of preserving a client-level Host override across the whole redirect chain.

Only in-memory request bodies can be replayed. If a redirect would require resending a non-cloneable streaming body, the layer returns a client error.

When combined with HttpProxy, this layer must wrap the proxy layer so every follow-up hop re-enters the proxy. Prefer ClientBuilder::follow_redirects, which preserves this order for normally appended outer layers.

Implementations

impl FollowRedirect<AlwaysRedirect>

pub const fn new(max_redirects: usize) -> Self

Create a FollowRedirect layer that follows up to max_redirects redirects.

0 disables redirect following and returns redirect responses as-is.

impl<P> FollowRedirect<P>

pub fn when<Next>(self, predicate: Next) -> FollowRedirect<Next>

where Next: RedirectPredicate,

Set a predicate that decides which requests should enter redirect following.

Requests that do not match the predicate are passed through without cloning their request head for possible redirect replay. The predicate is also checked before each follow-up hop; if a redirect points to a target the predicate rejects, the redirect response is returned as-is.

pub const fn max_redirects(&self) -> usize

Return the maximum number of redirects this layer will follow.

Trait Implementations

impl<P: Clone> Clone for FollowRedirect<P>

fn clone(&self) -> FollowRedirect<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Copy> Copy for FollowRedirect<P>

impl<P: Debug> Debug for FollowRedirect<P>

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

Formats the value using the given formatter.

impl Default for FollowRedirect<AlwaysRedirect>

fn default() -> Self

Returns the “default value” for a type.

impl<S, P> Layer<S> for FollowRedirect<P>

where P: RedirectPredicate,

type Service = FollowRedirectService<S, P>

The wrapped service

fn layer(self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware. Consumes self.