Struct TxOptions 

pub struct TxOptions {
    pub isolation: IsolationLevel,
    pub read_only: bool,
    pub deferrable: bool,
    pub max_attempts: u32,
    pub initial_backoff: Duration,
    pub max_backoff: Duration,
}

Options for Db::tx_with: isolation level, access mode, and the automatic retry policy for transient serialization failures.

TxOptions::default is byte-for-byte equivalent to today’s Db::tx: READ COMMITTED, read-write, a single attempt, and no retry.

use autumn_web::db::{TxOptions, IsolationLevel};

let opts = TxOptions::serializable().read_only().max_attempts(8);
assert_eq!(opts.isolation, IsolationLevel::Serializable);
assert!(opts.read_only);
assert_eq!(opts.max_attempts, 8);

Fields

isolation: IsolationLevel

Requested isolation level.

read_only: bool

Run the transaction READ ONLY.

deferrable: bool

Add DEFERRABLE (only meaningful for SERIALIZABLE READ ONLY).

max_attempts: u32

Total attempts including the first. 1 disables retry.

initial_backoff: Duration

Backoff before the first retry; doubles each subsequent retry.

max_backoff: Duration

Upper bound on any single backoff delay.

Implementations

impl TxOptions

pub fn new() -> Self

READ COMMITTED, no retry — identical to Db::tx.

pub fn read_committed() -> Self

READ COMMITTED (the default), no retry.

pub fn repeatable_read() -> Self

REPEATABLE READ with automatic retry (serialization_failure can occur at this level too).

pub fn serializable() -> Self

SERIALIZABLE with automatic retry. This is the correctness-critical default: conflicts surface as 40001 and are retried transparently.

pub const fn isolation(self, level: IsolationLevel) -> Self

Set the isolation level, keeping the other options.

pub const fn read_only(self) -> Self

Run the transaction READ ONLY.

pub const fn deferrable(self) -> Self

Add DEFERRABLE (for SERIALIZABLE READ ONLY).

pub const fn max_attempts(self, attempts: u32) -> Self

Set the maximum number of attempts (clamped to at least 1). A value of 1 disables retry.

pub const fn initial_backoff(self, delay: Duration) -> Self

Set the backoff before the first retry.

pub const fn max_backoff(self, delay: Duration) -> Self

Set the ceiling on any single backoff delay.

Trait Implementations

impl Clone for TxOptions

fn clone(&self) -> TxOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TxOptions

impl Debug for TxOptions

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

Formats the value using the given formatter.

impl Default for TxOptions

fn default() -> Self

Returns the “default value” for a type.