Skip to main content

BoundedMetadataStore

Trait BoundedMetadataStore 

Source
pub trait BoundedMetadataStore: Send + Sync {
    // Required methods
    fn read_metadata<'life0, 'life1, 'async_trait>(
        &'life0 self,
        key: &'life1 str,
        limits: MetadataLimits,
        owners: MetadataOwners,
    ) -> Pin<Box<dyn Future<Output = Result<MetadataSnapshot, ObjectLogError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
    fn swap_metadata<'life0, 'life1, 'async_trait>(
        &'life0 self,
        key: &'life1 str,
        observed: MetadataSnapshot,
        new_value: Bytes,
        limits: MetadataLimits,
        owners: MetadataOwners,
    ) -> Pin<Box<dyn Future<Output = Result<MetadataSwap, ObjectLogError>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait;
}
Expand description

Required bounded authority operations, independent of legacy BlobStore. There are deliberately no default implementations. limits bounds every retained payload and token, including conflict observations; transport/header and operation ownership require separate caller admission. Cancellation does not prove a conditional write had no effects. Owners must drive and drain it. Input/output source buffers retain the supplied lifetime owner. This does not attest to all SDK transport allocations or provider-side effects after an ambiguous request; those require separate transport/durability qualification.

Required Methods§

Source

fn read_metadata<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, limits: MetadataLimits, owners: MetadataOwners, ) -> Pin<Box<dyn Future<Output = Result<MetadataSnapshot, ObjectLogError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Read one complete object within the admitted bound, with an opaque CAS token. Oversize/malformed responses fail before whole-body collection.

Source

fn swap_metadata<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, observed: MetadataSnapshot, new_value: Bytes, limits: MetadataLimits, owners: MetadataOwners, ) -> Pin<Box<dyn Future<Output = Result<MetadataSwap, ObjectLogError>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Conditional durable replacement of exactly the observed provider/key/ version. No automatic conditional-write retry. Oversized input is rejected before I/O; failed conflict rereads are errors, never definite rejection.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§