Struct TransactionConfig 

pub struct TransactionConfig { /* private fields */ }

Options for starting a PostgreSQL transaction: isolation level, access mode and DEFERRABLE.

The default leaves every choice to the server. Use Self::builder when the choices are known in code; it only offers .deferrable() after .serializable().read_only(), the only combination where PostgreSQL gives DEFERRABLE a meaning. Use the setters on this type for choices made at runtime.

Examples

use drizzle_postgres::{AccessMode, IsolationLevel, TransactionConfig};

let config = TransactionConfig::builder()
    .serializable()
    .read_only()
    .deferrable()
    .build();
assert_eq!(config.isolation(), Some(IsolationLevel::Serializable));
assert_eq!(config.access(), Some(AccessMode::ReadOnly));
assert!(config.is_deferrable());

// Runtime choices:
let config = TransactionConfig::new().isolation_level(IsolationLevel::RepeatableRead);
assert_eq!(config.access(), None); // server default

Compile-time checks

use drizzle_postgres::TransactionConfig;

// DEFERRABLE only has meaning for a serializable, read-only transaction.
let _ = TransactionConfig::builder()
    .serializable()
    .read_write()
    .deferrable();

Implementations

impl TransactionConfig

pub const fn new() -> Self

Uses server defaults for every option.

pub const fn builder() -> ConfigBuilder

Starts a ConfigBuilder, which checks option combinations at compile time.

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

Sets the isolation level.

Any level other than SERIALIZABLE turns DEFERRABLE off.

pub const fn access_mode(self, mode: AccessMode) -> Self

Sets the access mode.

READ WRITE turns DEFERRABLE off.

pub const fn deferrable(self) -> Self

Makes the transaction SERIALIZABLE READ ONLY DEFERRABLE.

DEFERRABLE only has a meaning for a serializable, read-only transaction, so this also sets those two options. Prefer the builder when the choices are known in code.

pub const fn isolation(&self) -> Option<IsolationLevel>

Returns the isolation level, or None for the server default.

pub const fn access(&self) -> Option<AccessMode>

Returns the access mode, or None for the server default.

pub const fn is_deferrable(&self) -> bool

Returns true if DEFERRABLE is set.

Trait Implementations

impl Clone for TransactionConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TransactionConfig

impl Debug for TransactionConfig

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

Formats the value using the given formatter.

impl Default for TransactionConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TransactionConfig

impl From<PostgresTransactionType> for TransactionConfig

fn from(tx_type: PostgresTransactionType) -> Self

Converts to this type from the input type.

impl PartialEq for TransactionConfig

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for TransactionConfig