Trait Connection 

pub trait Connection: Executor {
    // Required methods
    fn connect(
        driver: &Self::Driver,
        url: Cow<'static, str>,
    ) -> impl Future<Output = Result<<Self::Driver as Driver>::Connection>> + Send
       where Self: Sized;
    fn begin(
        &mut self,
    ) -> impl Future<Output = Result<<Self::Driver as Driver>::Transaction<'_>>> + Send;

    // Provided methods
    fn sanitize_url(
        driver: &Self::Driver,
        url: Cow<'static, str>,
    ) -> Result<Url>
       where Self: Sized { ... }
    fn disconnect(self) -> impl Future<Output = Result<()>> + Send
       where Self: Sized { ... }
}

A live database handle capable of executing queries and spawning transactions.

Extends Executor with connection and transaction management.

Lifecycle

• connect creates (or fetches) an underlying connection. It may eagerly establish network I/O; always await it.
• begin starts a transaction scope. Commit/rollback MUST be awaited to guarantee resource release.

Required Methods

fn connect( driver: &Self::Driver, url: Cow<'static, str>, ) -> impl Future<Output = Result<<Self::Driver as Driver>::Connection>> + Send

where Self: Sized,

Establishes a connection (or pool) to the database specified by the URL.

Implementations may perform I/O or validation during connect. Callers should treat this as a potentially expensive operation.

fn begin( &mut self, ) -> impl Future<Output = Result<<Self::Driver as Driver>::Transaction<'_>>> + Send

Starts a new transaction on this connection.

Must await commit or rollback to finalize the scope and release resources.

Provided Methods

fn sanitize_url(driver: &Self::Driver, url: Cow<'static, str>) -> Result<Url>

where Self: Sized,

Validates and normalizes the connection URL, handling special cases like in-memory databases.

fn disconnect(self) -> impl Future<Output = Result<()>> + Send

where Self: Sized,

Closes the connection and releases any session resources.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl<S: Connection> Connection for &mut S

fn connect( driver: &Self::Driver, url: Cow<'static, str>, ) -> impl Future<Output = Result<<Self::Driver as Driver>::Connection>> + Send

where Self: Sized,

fn begin( &mut self, ) -> impl Future<Output = Result<<Self::Driver as Driver>::Transaction<'_>>> + Send

fn disconnect(self) -> impl Future<Output = Result<()>> + Send

where Self: Sized,

Implementors

impl<D: Driver> Connection for PooledConnection<D>