Struct TableDBTransaction 

pub struct TableDBTransaction { /* private fields */ }

A TableDB transaction Atomically commits a group of writes or deletes to the TableDB

Implementations

impl TableDBTransaction

pub async fn commit(self) -> VeilidAPIResult<()>

Commit the transaction. Performs all actions atomically.

Consumes the transaction handle; committing an already-completed clone errors with “transaction already completed”. An empty transaction commits as a no-op. Blocks on the serialized commit lock and the on-disk write.

Errors with VeilidAPIError::Generic if this transaction (or a clone) was already committed or rolled back, or if the atomic backing-store write fails (the buffered writes are then lost).

pub fn rollback(self)

Rollback the transaction. Does nothing to the TableDB.

Consumes the transaction handle and discards the buffered writes locally without blocking.

pub async fn store( &self, col: u32, key: &[u8], value: &[u8], ) -> VeilidAPIResult<()>

Store a key with a value in a column in the TableDB

Buffers the write into the transaction without touching disk; errors if the transaction is already committed or rolled back.

Errors with VeilidAPIError::Generic if col is at or above the opened column count, or if this transaction (or a clone) was already committed or rolled back.

pub async fn store_json<T>( &self, col: u32, key: &[u8], value: &T, ) -> VeilidAPIResult<()>

where T: Serialize,

Store a key in json format with a value in a column in the TableDB

Buffers the write into the transaction without touching disk; errors if the transaction is already committed or rolled back.

Errors with VeilidAPIError::Internal if value fails to JSON-serialize, otherwise the same errors as store.

pub async fn delete(&self, col: u32, key: &[u8]) -> VeilidAPIResult<()>

Delete key with from a column in the TableDB

Buffers the delete into the transaction without touching disk; errors if the transaction is already committed or rolled back.

Errors with VeilidAPIError::Generic if col is at or above the opened column count, or if this transaction (or a clone) was already committed or rolled back.

Trait Implementations

impl Clone for TableDBTransaction

fn clone(&self) -> TableDBTransaction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TableDBTransaction

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

Formats the value using the given formatter.