Struct TransactionModeHandler 

pub struct TransactionModeHandler { /* private fields */ }

Transaction mode handler

In transaction mode, connections are held for the duration of a transaction and returned to the pool after COMMIT or ROLLBACK.

Benefits:

• Good balance between connection sharing and compatibility
• Works with most PostgreSQL features within a transaction
• Supports prepared statements (with tracking/recreation)

Limitations:

• LISTEN/NOTIFY listeners are lost between transactions
• Session-level settings may need to be re-applied
• Temp tables persist but may not be on same connection

Implementations

impl TransactionModeHandler

pub fn new() -> Self

Create a new transaction mode handler

pub fn with_prepared_tracking() -> Self

Create with prepared statement tracking enabled

pub fn create_lease( &self, connection: PooledConnection, client_id: ClientId, ) -> ConnectionLease

Create a lease for this mode

pub fn on_statement_complete( &mut self, lease: &mut ConnectionLease, sql: &str, ) -> LeaseAction

Process a statement and determine action

Returns the connection on COMMIT/ROLLBACK outside of savepoints.

pub fn on_transaction_end(&self, lease: &mut ConnectionLease) -> LeaseAction

Process transaction end signal from backend

pub fn should_release(&self, lease: &ConnectionLease) -> bool

Check if connection should be released

pub fn on_client_disconnect(&self, _lease: ConnectionLease) -> LeaseAction

Called when client disconnects

pub fn mode(&self) -> PoolingMode

Get the pooling mode

pub fn tracks_prepared_statements(&self) -> bool

Check if prepared statement tracking is enabled

pub fn prepared_tracker(&self) -> Option<&PreparedStatementTracker>

Get prepared statement tracker

pub fn prepared_tracker_mut(&mut self) -> Option<&mut PreparedStatementTracker>

Get mutable prepared statement tracker

pub fn get_prepared_recreation_sql(&self) -> Vec<String>

Get SQL to recreate prepared statements on a new connection

Trait Implementations

impl Default for TransactionModeHandler

fn default() -> Self

Returns the “default value” for a type.