Struct VitrailTransaction 

pub struct VitrailTransaction { /* private fields */ }

Explicit Postgres transaction handle for executing Vitrail operations atomically.

VitrailTransaction mirrors the core query and write methods on crate::VitrailClient, which makes it straightforward to begin a transaction, pass &VitrailTransaction through service layers, and then explicitly commit() or rollback() when the workflow is complete.

A transaction owns a single database connection. Queries executed through the same transaction therefore run serially on that one connection, even if user code attempts to poll multiple futures concurrently.

Dropping an open transaction rolls it back through the underlying sqlx transaction behavior, but explicit commit() or rollback() should remain the primary application control flow.

Implementations

impl VitrailTransaction

pub async fn find_many<Q>( &self, query: Q, ) -> Result<Vec<<Q as QuerySpec>::Output>, Error>

where Q: QuerySpec,

pub async fn find_optional<Q>( &self, query: Q, ) -> Result<Option<<Q as QuerySpec>::Output>, Error>

where Q: QuerySpec,

pub async fn find_first<Q>( &self, query: Q, ) -> Result<<Q as QuerySpec>::Output, Error>

where Q: QuerySpec,

pub async fn insert<I>( &self, insert: I, ) -> Result<<I as InsertSpec>::Output, Error>

where I: InsertSpec,

pub async fn update_many<U>( &self, update: U, ) -> Result<<U as UpdateSpec>::Output, Error>

where U: UpdateSpec,

pub async fn delete_many<D>( &self, delete: D, ) -> Result<<D as DeleteSpec>::Output, Error>

where D: DeleteSpec,

pub async fn commit(self) -> Result<(), Error>

Commits the transaction.

This consumes the transaction handle so it cannot be reused afterward.

pub async fn rollback(self) -> Result<(), Error>

Rolls the transaction back.

This consumes the transaction handle so it cannot be reused afterward.

Trait Implementations

impl Debug for VitrailTransaction

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

Formats the value using the given formatter.