Struct TenantConn 

pub struct TenantConn { /* private fields */ }

A database handle bound to the request’s tenant.

Obtained only as an axum extractor, and only on a route the resolution layer covers. There is no constructor:

use cratefield_core::TenantConn;
// No public constructor: a handler cannot build a handle for a
// tenant it was not given.
let _conn = TenantConn { tenant: todo!(), db: db() };

Naming it is fine, which is what keeps a handler signature writable:

use cratefield_core::TenantConn;
async fn handler(_db: TenantConn) {}

Implementations

impl TenantConn

pub fn tenant(&self) -> &Tenant

The tenant this handle belongs to.

Trait Implementations

impl Clone for TenantConn

fn clone(&self) -> TenantConn

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Database for TenantConn

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, stmt: &'life1 Statement, ) -> Pin<Box<dyn Future<Output = Result<u64, DbError>> + Send + 'async_trait>>

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

fn query<'life0, 'life1, 'async_trait>( &'life0 self, stmt: &'life1 Statement, ) -> Pin<Box<dyn Future<Output = Result<Rows, DbError>> + Send + 'async_trait>>

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

fn batch_atomic<'life0, 'life1, 'async_trait>( &'life0 self, stmts: &'life1 [Statement], ) -> Pin<Box<dyn Future<Output = Result<(), DbError>> + Send + 'async_trait>>

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

impl Debug for TenantConn

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

Names the tenant and never the handle. Display for DbError already scrubs a DSN out of a message (#135), but Debug derives raw, and a database handle has no business being printed at all — so this does not derive.

impl<S> FromRequestParts<S> for TenantConn

where S: Send + Sync,

type Rejection = Problem

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

fn from_request_parts( parts: &mut Parts, _state: &S, ) -> impl Future<Output = Result<Self, Self::Rejection>> + Send

Perform the extraction.