Type Alias Pool

pub type Pool<C> = Pool<AsyncDieselConnectionManager<C>>;

Type alias for using deadpool::managed::Pool with [diesel-async]

This is not equal to deadpool::managed::Pool. It already uses the correct connection manager and expects only the connection type as generic argument

Aliased Type

struct Pool<C> { /* private fields */ }

Implementations

impl<M, W> Pool<M, W>

where M: Manager, W: From<Object<M>>,

pub fn builder(manager: M) -> PoolBuilder<M, W>

Instantiates a builder for a new Pool.

This is the only way to create a Pool instance.

pub async fn get(&self) -> Result<W, PoolError<<M as Manager>::Error>>

Retrieves an Object from this Pool or waits for one to become available.

Errors

See PoolError for details.

pub async fn timeout_get( &self, timeouts: &Timeouts, ) -> Result<W, PoolError<<M as Manager>::Error>>

Retrieves an Object from this Pool using a different timeout than the configured one.

Errors

See PoolError for details.

pub fn resize(&self, max_size: usize)

Resize the pool. This change the max_size of the pool dropping excess objects and/or making space for new ones.

If the pool is closed this method does nothing. The Pool::status method always reports a max_size of 0 for closed pools.

pub fn retain(&self, f: impl Fn(&<M as Manager>::Type, Metrics) -> bool)

Retains only the objects specified by the given function.

This function is typically used to remove objects from the pool based on their current state or metrics.

Caution: This function blocks the entire pool while it is running. Therefore the given function should not block.

The following example starts a background task that runs every 30 seconds and removes objects from the pool that haven’t been used for more than one minute.

let interval = Duration::from_secs(30);
let max_age = Duration::from_secs(60);
tokio::spawn(async move {
    loop {
        tokio::time::sleep(interval).await;
        pool.retain(|_, metrics| metrics.last_used() < max_age);
    }
});

pub fn timeouts(&self) -> Timeouts

Get current timeout configuration

pub fn close(&self)

Closes this Pool.

All current and future tasks waiting for Objects will return PoolError::Closed immediately.

This operation resizes the pool to 0.

pub fn is_closed(&self) -> bool

Indicates whether this Pool has been closed.

pub fn status(&self) -> Status

Retrieves Status of this Pool.

pub fn manager(&self) -> &M

Returns Manager of this Pool.

Trait Implementations

impl<M, W> Clone for Pool<M, W>

where M: Manager, W: From<Object<M>>,

fn clone(&self) -> Pool<M, W>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M, W> Debug for Pool<M, W>

where M: Debug + Manager, <M as Manager>::Type: Debug, W: From<Object<M>>,

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

Formats the value using the given formatter.

impl<M: DeadManager, C> Pool for Pool<M, C>

where M::Type: Send, C: Send + Sync + 'static + From<Object<M>>, M::Error: Error,

type Error = Error<PoolError<<M as Manager>::Error>>

The error type returned by Self::init() and Self::get().

type Connection = C

The connection type managed by this pool, returned by Self::get().

fn init<'life0, 'async_trait>( figment: &'life0 Figment, ) -> Pin<Box<dyn Future<Output = Result<Self, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Constructs a pool from a Value.

fn get<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Self::Connection, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Asynchronously retrieves a connection from the factory or pool.

fn close<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Shutdown the connection pool, disallowing any new connections from being retrieved and waking up any tasks with active connections.