Struct TlsConnectionReuse 

pub struct TlsConnectionReuse<P> { /* private fields */ }

Available on crate feature boring only.

Reuse rules published by the connector that performed a TLS handshake.

Capture request overrides before applying connector defaults, and publish only after a successful handshake. Pools derive the next request’s key from its extensions; callers need not configure the provider on the pool. Connector defaults, including credentials and hooks, remain fixed for the lifetime of its pool. Custom components supply stable value or instance identities.

Implementations

impl<P> TlsConnectionReuse<P>

where P: TlsClientConfigProvider + 'static,

pub fn new(provider: P, request: &Extensions) -> TlsConnectionReuse<P>

Capture request overrides relative to this connector’s fixed defaults.

pub fn policy_scope(&self) -> ConnectionPolicyScope

Classify the original caller policy, including validated derived settings. Tunnel policies do not describe the origin and remain unclassified here.

pub fn for_derived_settings( self, request: &Extensions, ) -> Option<TlsDerivedPolicy>

Keep the caller’s reuse identity when a layer derives TLS settings on a pool miss. Call this after installing those settings, then insert the returned extension in the same request.

The scope is bound to this provider and the actual derived settings. Later changes invalidate it. It retains only policy keys, not settings, sessions or the provider. Opaque derived settings and tunnel policies cannot be scoped; their existing reuse behavior remains authoritative.

This does not establish compatibility between derived configurations. The deriving layer must also partition its configurations or publish its own ConnectionReusePolicy, while retaining inner restrictions.

pub fn tunnel(provider: P, request: &Extensions) -> TlsConnectionReuse<P>

Capture fixed proxy TLS policy, independently of origin TLS overrides.

The pool’s route key identifies the proxy. Caller-supplied tunnel settings must match on later requests; route-generated settings remain fixed for that route and are distinct from the caller’s overrides.

pub fn publish(self, connection: &Extensions)

Publish this handshake’s rules while retaining restrictions from inner layers.

Trait Implementations

impl<P> ConnectionReusePolicy for TlsConnectionReuse<P>

where P: TlsClientConfigProvider + 'static,

fn classifier(&self) -> ReuseKey

Identity of Self::request_key: policies with equal classifiers must derive equal keys for every request.

fn connection_key(&self) -> Option<ReuseKey>

This connection’s key, captured when it was established, or None if the connection must not be retained after its establishing request.

fn request_key(&self, input: &Extensions) -> Option<ReuseKey>

The key a connection needs to serve input, or None if no connection of this classifier may serve it.

impl<P> Debug for TlsConnectionReuse<P>

where P: Debug,

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

Formats the value using the given formatter.