Struct TxOutcome 

pub struct TxOutcome { /* private fields */ }

Outcome returned by committing or rolling back a backend transaction.

Most backends do not need to surface anything after commit/rollback, but SQLite consumes the pooled connection for the transaction and needs to hand it back (with its translation flag) so callers can keep using the pooled wrapper.

If you started a raw SQLite transaction, continue using the connection from the returned outcome instead of the pre-transaction wrapper to preserve the translation flag and pool state.

Implementations

impl TxOutcome

pub fn without_restored_connection() -> Self

Outcome with no connection to restore (common for Postgres, Turso, MSSQL).

pub fn with_restored_connection(conn: MiddlewarePoolConnection) -> Self

Outcome that includes a connection restored to its pooled wrapper.

pub fn restored_connection(&self) -> Option<&MiddlewarePoolConnection>

Borrow the restored connection, if present.

pub fn into_restored_connection(self) -> Option<MiddlewarePoolConnection>

Consume the outcome and take ownership of the restored connection, if present.

pub fn restore_into(self, conn_slot: &mut MiddlewarePoolConnection)

Restore any pooled connection contained in this outcome back into the caller’s slot.

This is primarily useful for SQLite, where the transaction API consumes the pooled wrapper and returns it on commit/rollback. Other backends return an empty outcome, making this a no-op.

pub fn into_sqlite_parts(self) -> Option<(SqliteConnection, bool)>

Consume the outcome and unwrap the SQLite connection + translation flag.

Trait Implementations

impl Debug for TxOutcome

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

Formats the value using the given formatter.

impl Default for TxOutcome

fn default() -> TxOutcome

Returns the “default value” for a type.