Struct ProxyRoutesLayer 

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

Available on crate feature net only.

Resolve and materialize the route decision for downstream middleware.

Place every route-selection layer before this one, then place middleware that consumes ProxyRoute after it. This is the sole middleware boundary that needs to understand both route forms. The most recently inserted input decision wins. An optional configured plan supplies defaults unless Self::with_overwrite makes it authoritative. The selected plan publishes its first route (or direct for an empty plan) to middleware and remains authoritative for ProxyRoutesConnector, which still owns fallback attempts.

Credentials and route-specific extensions are omitted from the middleware view of a multi-route plan. One HTTP header cannot safely authenticate every fallback and could leak to a later direct route, while publishing the first route’s extensions would contaminate later attempts. The connector retains the original per-route state and applies it to isolated attempts.

Implementations

impl ProxyRoutesLayer

pub const fn new() -> ProxyRoutesLayer

Create a route materialization layer without configured defaults.

pub fn with_routes(routes: impl Into<ProxyRoutes>) -> ProxyRoutesLayer

Create a route materialization layer with an ordered default plan.

An input ProxyRoute or ProxyRoutes decision takes precedence by default. Use Self::with_overwrite when this plan is authoritative.

pub const fn with_overwrite(self, overwrite: bool) -> ProxyRoutesLayer

Let the configured route plan take precedence over an input route decision.

Trait Implementations

impl Clone for ProxyRoutesLayer

fn clone(&self) -> ProxyRoutesLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyRoutesLayer

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

Formats the value using the given formatter.

impl Default for ProxyRoutesLayer

fn default() -> ProxyRoutesLayer

Returns the “default value” for a type.

impl<S> Layer<S> for ProxyRoutesLayer

type Service = ProxyRoutesService<S>

The service produced by the layer.

fn layer(&self, inner: S) -> <ProxyRoutesLayer as Layer<S>>::Service

Wrap the given service with the middleware, returning a new service.

fn into_layer(self, inner: S) -> <ProxyRoutesLayer as Layer<S>>::Service

Same as layer but consuming self after the service was created.