Struct ProxyRouteFailureCache 

pub struct ProxyRouteFailureCache { /* private fields */ }

Available on crate feature net only.

Shared negative cache for temporarily failing proxy routes.

The cache is bounded and safe to clone across connector services. Healthy routes create only transient state while an attempt is in flight; a success or non-cacheable failure removes it, so retained entries represent negative backoff state. State transitions for one route key use atomics and do not contend with unrelated proxy routes or destinations. After a backoff expires, at most one caller receives a half-open probe permit for that key.

Keys contain the proxy protocol and address, an optional Basic routing username, and optionally the final destination protocol and address. Basic passwords and bearer tokens are never retained in a key.

Implementations

impl ProxyRouteFailureCache

pub fn try_new( config: ProxyRouteFailureCacheConfig, ) -> Result<ProxyRouteFailureCache, Box<dyn Error + Send + Sync>>

Create a failure cache using the given validated configuration.

pub fn config(&self) -> &ProxyRouteFailureCacheConfig

Return the configured cache policy.

pub fn entry_count(&self) -> u64

Return an approximate number of retained cache entries.

pub fn invalidate_all(&self)

Clear every retained proxy failure and backoff state.

Trait Implementations

impl Clone for ProxyRouteFailureCache

fn clone(&self) -> ProxyRouteFailureCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyRouteFailureCache

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

Formats the value using the given formatter.

impl Default for ProxyRouteFailureCache

fn default() -> ProxyRouteFailureCache

Returns the “default value” for a type.