Struct DatabaseTransaction

pub struct DatabaseTransaction { /* private fields */ }

Defines a database transaction, whether it is an open transaction and the type of backend to use

Implementations

impl DatabaseTransaction

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

Commit a transaction atomically

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

rolls back a transaction in case error are encountered during the operation

Trait Implementations

impl AsRef<DatabaseTransaction> for OpenTransaction

fn as_ref(&self) -> &DatabaseTransaction

Converts this type into a shared reference of the (usually inferred) input type.

impl ConnectionTrait for DatabaseTransaction

fn get_database_backend(&self) -> DatabaseBackend

Fetch the database backend as specified in [DbBackend]. This depends on feature flags enabled.

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

where 'life0: 'async_trait, DatabaseTransaction: 'async_trait,

Execute a [Statement]

fn execute_unprepared<'life0, 'life1, 'async_trait>( &'life0 self, sql: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ExecResult, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, DatabaseTransaction: 'async_trait,

Execute a unprepared [Statement]

fn query_one<'life0, 'async_trait>( &'life0 self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<Option<QueryResult>, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, DatabaseTransaction: 'async_trait,

Execute a [Statement] and return a query

fn query_all<'life0, 'async_trait>( &'life0 self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<Vec<QueryResult>, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, DatabaseTransaction: 'async_trait,

Execute a [Statement] and return a collection Vec<[QueryResult]> on success

fn support_returning(&self) -> bool

Check if the connection supports RETURNING syntax on insert and update

fn is_mock_connection(&self) -> bool

Check if the connection is a test connection for the Mock database

impl Debug for DatabaseTransaction

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

Formats the value using the given formatter.

impl Drop for DatabaseTransaction

fn drop(&mut self)

Executes the destructor for this type.

impl From<OpenTransaction> for DatabaseTransaction

fn from(value: OpenTransaction) -> Self

Converts to this type from the input type.

impl<'c> IntoSchemaManagerConnection<'c> for &'c DatabaseTransaction

fn into_schema_manager_connection(self) -> SchemaManagerConnection<'c>

impl StreamTrait for DatabaseTransaction

type Stream<'a> = TransactionStream<'a>

Create a stream for the [QueryResult]

fn stream<'a>( &'a self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<<DatabaseTransaction as StreamTrait>::Stream<'a>, DbErr>> + Send + 'a>>

Execute a [Statement] and return a stream of results

impl TransactionTrait for DatabaseTransaction

fn transaction<'life0, 'async_trait, F, T, E>( &'life0 self, _callback: F, ) -> Pin<Box<dyn Future<Output = Result<T, TransactionError<E>>> + Send + 'async_trait>>

where 'life0: 'async_trait, F: for<'c> FnOnce(&'c DatabaseTransaction) -> Pin<Box<dyn Future<Output = Result<T, E>> + Send + 'c>> + Send + 'async_trait, T: Send + 'async_trait, E: Error + Send + 'async_trait, DatabaseTransaction: 'async_trait,

Execute the function inside a transaction. If the function returns an error, the transaction will be rolled back. If it does not return an error, the transaction will be committed.

fn transaction_with_config<'life0, 'async_trait, F, T, E>( &'life0 self, _callback: F, isolation_level: Option<IsolationLevel>, access_mode: Option<AccessMode>, ) -> Pin<Box<dyn Future<Output = Result<T, TransactionError<E>>> + Send + 'async_trait>>

where 'life0: 'async_trait, F: for<'c> FnOnce(&'c DatabaseTransaction) -> Pin<Box<dyn Future<Output = Result<T, E>> + Send + 'c>> + Send + 'async_trait, T: Send + 'async_trait, E: Error + Send + 'async_trait, DatabaseTransaction: 'async_trait,

Execute the function inside a transaction with isolation level and/or access mode. If the function returns an error, the transaction will be rolled back. If it does not return an error, the transaction will be committed.

fn begin<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<DatabaseTransaction, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, DatabaseTransaction: 'async_trait,

Execute SQL BEGIN transaction. Returns a Transaction that can be committed or rolled back

fn begin_with_config<'life0, 'async_trait>( &'life0 self, isolation_level: Option<IsolationLevel>, access_mode: Option<AccessMode>, ) -> Pin<Box<dyn Future<Output = Result<DatabaseTransaction, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, DatabaseTransaction: 'async_trait,

Execute SQL BEGIN transaction with isolation level and/or access mode. Returns a Transaction that can be committed or rolled back