Struct LazyProxyAddressLayer 

pub struct LazyProxyAddressLayer { /* private fields */ }

Available on crate feature net only.

Lazily resolve and apply a proxy address to any input with extensions.

Existing routes are preserved by default, in which case the loader is not consulted if a ProxyRoute or ProxyRoutes decision exists. Otherwise, its result is cached and shared by every clone of the layer and service. This is useful for environment configuration that may never be needed.

Implementations

impl LazyProxyAddressLayer

pub fn new<F>(loader: F) -> LazyProxyAddressLayer

where F: Fn() -> Result<Option<ProxyAddress>, Box<dyn Error + Sync + Send>> + Send + Sync + 'static,

Create a lazy layer backed by a synchronous, non-blocking loader.

The loader runs at most once, on the first request that does not already have a preserved route decision. Both success and failure are cached.

pub fn from_env_default() -> LazyProxyAddressLayer

Lazily read and parse the http_proxy environment variable on the first request without a preserved route.

Uppercase HTTP_PROXY is deliberately not accepted by default because CGI derives it from an incoming Proxy header. Use ProxyEnvLayer for curl-compatible HTTP, HTTPS, and all-protocol environment selection.

pub fn from_env(key: impl Into<String>) -> LazyProxyAddressLayer

Lazily read and parse a proxy address from the named environment variable on the first request without a preserved route.

pub fn with_load_error_sink(self, sink: impl ErrorSink) -> LazyProxyAddressLayer

Handle a loader error through an ErrorSink and continue without selecting a proxy. By default loader errors reject the request.

The sink is invoked at most once because the handled result is cached and shared by every clone of this layer and its service.

pub fn set_load_error_sink( &mut self, sink: impl ErrorSink, ) -> &mut LazyProxyAddressLayer

Handle a loader error through an ErrorSink and continue without selecting a proxy. By default loader errors reject the request.

The sink is invoked at most once because the handled result is cached and shared by every clone of this layer and its service.

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

Replace an existing ProxyRoute or ProxyRoutes decision. Existing routes are preserved by default.

pub fn set_overwrite(&mut self, overwrite: bool) -> &mut LazyProxyAddressLayer

Replace an existing ProxyRoute or ProxyRoutes decision. Existing routes are preserved by default.

Trait Implementations

impl Clone for LazyProxyAddressLayer

fn clone(&self) -> LazyProxyAddressLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LazyProxyAddressLayer

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

Formats the value using the given formatter.

impl<S> Layer<S> for LazyProxyAddressLayer

type Service = LazyProxyAddressService<S>

The service produced by the layer.

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

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

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

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