Skip to main content

PooledConnection

Struct PooledConnection 

Source
pub struct PooledConnection { /* private fields */ }
Expand description

连接池中的连接条目,记录创建时间和最后使用时间

  • created_at:连接的原始创建时间,随 acquire/release 重置, 用于 max_lifetime 过期判定。
  • last_used_at:上次归还到池的时间,用于 idle_timeout 空闲超时判定。
  • pool:归属的连接池引用,Drop 时自动归还。None 表示无需归还 (已通过 release()/into_inner() 显式处理)。

Implementations§

Source§

impl PooledConnection

Source

pub fn created_at(&self) -> Instant

连接的原始创建时间(不随 acquire/release 重置)

Source

pub fn into_inner(self) -> Box<dyn Connection>

提取内部连接(消费 PooledConnection)

用于将连接传递给 Transaction::new 等消费连接的 API。 调用此方法后,连接不再属于池,调用方需自行管理其生命周期。

Trait Implementations§

Source§

impl Deref for PooledConnection

Source§

type Target = dyn Connection

The resulting type after dereferencing.
Source§

fn deref(&self) -> &<PooledConnection as Deref>::Target

Dereferences the value.
Source§

impl DerefMut for PooledConnection

Source§

fn deref_mut(&mut self) -> &mut <PooledConnection as Deref>::Target

Mutably dereferences the value.
Source§

impl Drop for PooledConnection

PooledConnection 的 Drop 实现:自动归还连接到池中

修复 Critical Bug:之前 PooledConnection 未实现 Drop,连接在 drop 时 丢失,不归还池中,导致池耗尽。

实现策略:

  1. 如果 poolSome(未显式 release/into_inner),取出连接并放入 ClosedConnection 占位符
  2. 在 tokio runtime 中 spawn 异步 release(Drop 不能 await)
  3. 如果不在 tokio runtime 中(P0 修复):手动递减 total_count, 避免池容量被耗尽;连接随 pooled drop 自然释放(依赖底层连接 Drop)
Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

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. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more