Struct BlockObjectStore 

pub struct BlockObjectStore { /* private fields */ }

Durable object store backed by leased block storage.

Objects are appended sequentially starting after the superblock. An in-memory index maps URIs to their block locations. The index is checkpointed to reserved blocks at the end of the device.

Deleted objects are tombstoned in the index but their blocks are not reclaimed (append-only).

Implementations

impl BlockObjectStore

pub fn new(num_blocks: u64) -> Result<Self>

Create a new block object store with the given number of blocks.

Reserves the last 10% of blocks (minimum 4) for index checkpoints.

pub fn checkpoint_index(&self) -> Result<()>

Checkpoint the in-memory index to the reserved block region.

Trait Implementations

impl ObjectStore for BlockObjectStore

fn put( &mut self, uri: &FabricUri, data: &[u8], opts: Option<PutOptions>, ) -> Result<()>

Store an object at the given URI.

fn get(&self, uri: &FabricUri) -> Result<Option<ObjectData>>

Retrieve an object by URI.

fn head(&self, uri: &FabricUri) -> Result<Option<ObjectInfo>>

Retrieve object metadata without reading the data.

fn delete(&mut self, uri: &FabricUri) -> Result<bool>

Delete an object by URI. Returns true if the object existed.

fn list(&self, pool: &str, bucket: &str, prefix: &str) -> Result<Vec<String>>

List object keys matching a prefix within a bucket.