Struct ClientConfigCache 

pub struct ClientConfigCache { /* private fields */ }

Available on crate features quic and std only.

Reuse native TLS configuration and session state when opening QUIC connections.

A cache belongs to one provider and fixed QUIC TLS options. Clones share its state: one protected default entry and up to 64 recently used override entries. Shared custom components retain session state. Request policies explicitly marked non-reusable bypass caching. Failed builds are never retained. Providers must identify changed defaults, or keep them fixed for the cache’s lifetime.

This does not pool connections or apply request overrides. Supply the final TLS configuration to Self::client_config, then customize transport settings on the returned ClientConfig as needed; each result is an independent clone sharing the native TLS configuration and its session state.

Implementations

impl ClientConfigCache

pub fn new( provider: Arc<dyn QuicClientConfigProvider>, options: TlsOptions, ) -> ClientConfigCache

Bind cached configurations to one provider and its QUIC TLS options.

pub fn provider(&self) -> &Arc<dyn QuicClientConfigProvider>

The provider used both to classify policies and to construct configurations.

pub fn client_config( &self, config: &TlsClientConfig, overrides: &Extensions, ) -> Result<ClientConfig, TlsConfigError>

Build or reuse the final TLS configuration, classified by this cache’s provider.

overrides contains request settings before connector defaults are applied. It selects the protected default slot or bounded override cache and makes explicitly non-reusable request policies bypass caching even if masked later. The key combines the request identity with the effective configuration identity, including final application requirements such as ALPN. Defaults are checked on each call; any defaults omitted from the identity must remain fixed. Provider classification must cover every relevant setting.

Provider code runs outside the cache lock. Concurrent equivalent builds may do redundant work, but converge on the same retained configuration.

Trait Implementations

impl Clone for ClientConfigCache

fn clone(&self) -> ClientConfigCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfigCache

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

Formats the value using the given formatter.