Struct TieredObjectStore 

pub struct TieredObjectStore { /* private fields */ }

Tiered object store composing a hot (memory) and cold (block) tier.

New objects are written to the hot tier. When the hot tier is full, the least recently used object is demoted to the cold tier. On a hot-tier miss, the cold tier is consulted and matching objects are promoted back to the hot tier.

Example

use grafos_store::{TieredObjectStore, ObjectStore, FabricUri};

let mut store = TieredObjectStore::new(32, 256, 16)?;
let uri: FabricUri = "fabric://p/b/k".parse()?;
store.put(&uri, b"data", None)?;
let obj = store.get(&uri)?.unwrap();
assert_eq!(obj.data, b"data");

Implementations

impl TieredObjectStore

pub fn new(hot_buckets: usize, cold_blocks: u64, max_hot: usize) -> Result<Self>

Create a tiered store.

• hot_buckets: number of hash map buckets for the hot tier
• cold_blocks: number of blocks for the cold tier
• max_hot: maximum objects in hot tier before LRU eviction

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

Checkpoint the cold tier index to block storage.

impl TieredObjectStore

Mutable get with LRU tracking and cold-to-hot promotion.

pub fn get_mut(&mut self, uri: &FabricUri) -> Result<Option<ObjectData>>

Get an object, promoting from cold tier to hot tier on a miss.

This is the preferred get method as it maintains LRU state and promotes cold objects to the hot tier for faster subsequent access.

Trait Implementations

impl ObjectStore for TieredObjectStore

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.