Struct xitca_postgres::transaction::Transaction

pub struct Transaction<'a, C>
where
    C: Prepare + Query + ClientBorrowMut,
{ /* private fields */ }

Implementations

impl<C> Transaction<'_, C>

where C: Prepare + Query + ClientBorrowMut,

pub fn builder() -> TransactionBuilder

pub async fn prepare( &self, query: &str, types: &[Type], ) -> Result<StatementGuarded<'_, C>, Error>

function the same as Client::prepare

pub fn query<'a>( &self, stmt: &'a Statement, params: &[&(dyn ToSql + Sync)], ) -> Result<RowStream<'a>, Error>

function the same as Client::query

pub fn query_raw<'a, I>( &self, stmt: &'a Statement, params: I, ) -> Result<RowStream<'a>, Error>

where I: AsParams,

function the same as Client::query_raw

pub async fn bind<'p>( &'p self, statement: &'p Statement, params: &[&(dyn ToSql + Sync)], ) -> Result<Portal<'p, C>, Error>

Binds a statement to a set of parameters, creating a Portal which can be incrementally queried.

Portals only last for the duration of the transaction in which they are created, and can only be used on the connection that created them.

pub async fn bind_raw<'p, I>( &'p self, statement: &'p Statement, params: I, ) -> Result<Portal<'p, C>, Error>

where I: AsParams,

A maximally flexible version of Transaction::bind.

pub async fn transaction(&mut self) -> Result<Transaction<'_, C>, Error>

Like Client::transaction, but creates a nested transaction via a savepoint.

pub async fn save_point<I>( &mut self, name: I, ) -> Result<Transaction<'_, C>, Error>

where I: Into<String>,

Like Client::transaction, but creates a nested transaction via a savepoint with the specified name.

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

Consumes the transaction, committing all changes made within it.

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

Rolls the transaction back, discarding all changes made within it.

This is equivalent to Transaction’s Drop implementation, but provides any error encountered to the caller.

Trait Implementations

impl<C> Drop for Transaction<'_, C>

where C: Prepare + Query + ClientBorrowMut,

fn drop(&mut self)

Executes the destructor for this type.