Trait diesel::r2d2::ManageConnection [−][src]
pub trait ManageConnection: 'static + Send + Sync { type Connection: 'static + Send; type Error: 'static + Error; fn connect(&self) -> Result<Self::Connection, Self::Error>; fn is_valid(&self, conn: &mut Self::Connection) -> Result<(), Self::Error>; fn has_broken(&self, conn: &mut Self::Connection) -> bool; }
Expand description
A trait which provides connection-specific functionality.
Associated Types
type Connection: 'static + Send
type Connection: 'static + Send
The connection type this manager deals with.
Required methods
fn connect(&self) -> Result<Self::Connection, Self::Error>
fn connect(&self) -> Result<Self::Connection, Self::Error>
Attempts to create a new connection.
Determines if the connection is still connected to the database.
A standard implementation would check if a simple query like SELECT 1
succeeds.
fn has_broken(&self, conn: &mut Self::Connection) -> bool
fn has_broken(&self, conn: &mut Self::Connection) -> bool
Quickly determines if the connection is no longer usable.
This will be called synchronously every time a connection is returned
to the pool, so it should not block. If it returns true
, the
connection will be discarded.
For example, an implementation might check if the underlying TCP socket
has disconnected. Implementations that do not support this kind of
fast health check may simply return false
.