Struct ConnectionGuard 

pub struct ConnectionGuard { /* private fields */ }

RAII guard for pooled connections.

Automatically removes an unreleased connection from the pool on drop. Drop applies replacement cooldown because unreleased guards represent unknown or backend-error state. Use retire_without_cooldown for known client-side dirty sockets that should not throttle backend replacement.

Follows the same pattern as CommandGuard from src/router/mod.rs.

Implementations

impl ConnectionGuard

pub const fn new( conn: Object<TcpManager>, provider: DeadpoolConnectionProvider, ) -> Self

Create a new guard (removes from pool on drop unless released).

pub fn release(self) -> Object<TcpManager>

Return connection to pool (healthy).

Connection will be returned to the pool normally when the returned Object is dropped. The guard is consumed — no cleanup happens.

Panics

Panics if the guard has already been consumed (double-release).

pub fn retire_without_cooldown(self)

Close and remove the connection without applying replacement cooldown.

Use this when the socket is dirty from a client-side abort, but the backend did not fail and should not have its pool capacity reduced.

Panics

Panics if the guard has already been consumed.

pub fn retire_with_cooldown(self)

Close and remove the connection, applying replacement cooldown.

Use this only when the backend connection itself failed or is known to be in a backend-error state. Client-side disconnects and local dirty-socket retirement should use retire_without_cooldown.

Panics

Panics if the guard has already been consumed.

pub const fn get_mut(&mut self) -> &mut Object<TcpManager>

Get mutable reference to the connection

Panics

Panics if the guard has already been consumed.

pub const fn get(&self) -> &Object<TcpManager>

Get shared reference to the connection

Panics

Panics if the guard has already been consumed.

pub fn connection_type(&self) -> &'static str

pub fn pending_bytes_len(&self) -> usize

pub fn provider_status_counts(&self) -> DeadpoolStatusCounts

pub fn provider_name(&self) -> &str

Trait Implementations

impl Deref for ConnectionGuard

type Target = Object<TcpManager>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for ConnectionGuard

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for ConnectionGuard

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.