Struct Acquired 

pub struct Acquired<T> { /* private fields */ }

A wrapper indicating that a resource has been acquired with a database lock.

This type is returned by database operations that lock rows for update (e.g., SELECT ... FOR UPDATE). It serves as a compile-time marker that the wrapped resource was properly locked before being returned, ensuring that subsequent modifications are safe from race conditions.

Usage

When you need to modify a database record, first acquire it using a locking query method. The returned Acquired<T> guarantees the row is locked for the duration of the transaction.

// Acquire a quote with a row lock
let mut quote: Acquired<MintQuote> = tx.get_mint_quote_for_update(&quote_id).await?;

// Safely modify the quote (row is locked)
quote.state = QuoteState::Paid;

// Persist the changes
tx.update_mint_quote(&mut quote).await?;

Deref Behavior

Acquired<T> implements Deref and DerefMut, allowing transparent access to the inner value’s methods and fields.

Implementations

impl<T> Acquired<T>

pub fn inner(self) -> T

Consumes the wrapper and returns the inner resource.

Use this when you need to take ownership of the inner value, for example when passing it to a function that doesn’t accept Acquired<T>.

Trait Implementations

impl<T: Debug> Debug for Acquired<T>

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

Formats the value using the given formatter.

impl<T> Deref for Acquired<T>

fn deref(&self) -> &Self::Target

Returns a reference to the inner resource.

type Target = T

The resulting type after dereferencing.

impl<T> DerefMut for Acquired<T>

fn deref_mut(&mut self) -> &mut Self::Target

Returns a mutable reference to the inner resource.

impl<T> From<T> for Acquired<T>

fn from(value: T) -> Self

Wraps a value to indicate it has been acquired with a lock.

This is typically called by database layer implementations after executing a locking query.