Struct ProxyRoutes 

pub struct ProxyRoutes { /* private fields */ }

Available on crate feature net only.

Ordered proxy routes to try while establishing a client connection.

An empty route collection has the same meaning as a single ProxyRoute::Direct route.

Each route can optionally carry route-specific Extensions. The ProxyRoutesConnector installs those only on that route’s isolated connection attempt. Collect (route, extensions) pairs to attach them without exposing an entry wrapper in the public API.

Implementations

impl ProxyRoutes

pub fn new(routes: impl IntoIterator<Item = ProxyRoute>) -> ProxyRoutes

Create an ordered collection from the given proxy routes.

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

Allow this route collection to take precedence over an existing singular ProxyRoute.

Overwriting is disabled by default.

pub const fn overwrite(&self) -> bool

Return whether this collection may overwrite a singular route.

pub const fn as_slice(&self) -> &[ProxyRoute]

Return the explicitly configured routes in their preferred order.

pub fn iter(&self) -> impl Iterator<Item = &ProxyRoute>

Iterate over the explicitly configured routes in preferred order.

pub fn route_extensions(&self, index: usize) -> Option<&Extensions>

Return the extensions attached to the route at index, when present.

Trait Implementations

impl Clone for ProxyRoutes

fn clone(&self) -> ProxyRoutes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyRoutes

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

Formats the value using the given formatter.

impl Default for ProxyRoutes

fn default() -> ProxyRoutes

Returns the “default value” for a type.

impl Extension for ProxyRoutes

impl From<Box<[ProxyRoute]>> for ProxyRoutes

fn from(value: Box<[ProxyRoute]>) -> ProxyRoutes

Converts to this type from the input type.

impl From<ProxyAddress> for ProxyRoutes

fn from(value: ProxyAddress) -> ProxyRoutes

Converts to this type from the input type.

impl From<ProxyRoute> for ProxyRoutes

fn from(value: ProxyRoute) -> ProxyRoutes

Converts to this type from the input type.

impl From<Vec<ProxyRoute>> for ProxyRoutes

fn from(value: Vec<ProxyRoute>) -> ProxyRoutes

Converts to this type from the input type.

impl<E> FromIterator<(ProxyRoute, E)> for ProxyRoutes

where E: Into<Option<Extensions>>,

Collect direct or proxied routes with optional route-specific extensions.

fn from_iter<I>(iter: I) -> ProxyRoutes

where I: IntoIterator<Item = (ProxyRoute, E)>,

Creates a value from an iterator.

impl<T, E> FromIterator<(T, E)> for ProxyRoutes

where T: Into<ProxyAddress>, E: Into<Option<Extensions>>,

Collect proxy-address-like values with optional route-specific extensions.

fn from_iter<I>(iter: I) -> ProxyRoutes

where I: IntoIterator<Item = (T, E)>,

Creates a value from an iterator.

impl FromIterator<ProxyRoute> for ProxyRoutes

fn from_iter<I>(iter: I) -> ProxyRoutes

where I: IntoIterator<Item = ProxyRoute>,

Creates a value from an iterator.

impl<T> FromIterator<T> for ProxyRoutes

where T: Into<ProxyAddress>,

Collect proxy-address-like values into ordered proxy routes.

fn from_iter<I>(iter: I) -> ProxyRoutes

where I: IntoIterator<Item = T>,

Creates a value from an iterator.

impl<'a> IntoIterator for &'a ProxyRoutes

type Item = &'a ProxyRoute

The type of the elements being iterated over.

type IntoIter = Iter<'a, ProxyRoute>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a ProxyRoutes as IntoIterator>::IntoIter

Creates an iterator from a value.

impl NetExtension for ProxyRoutes

impl ProxyExtension for ProxyRoutes