Struct SharedEmbeddedStore 

pub struct SharedEmbeddedStore<const SHARDS: usize> { /* private fields */ }

Cloneable, lock-striped embedded cache handle.

SharedEmbeddedStore is the embedded mode for applications that want to clone one cache handle into many workers while still allowing each worker to reach every key. It uses the same EmbeddedShard storage primitive as crate::storage::EmbeddedStore, but stores stripes in an Arc so clones are cheap and route to cache-padded shard locks.

use fast_cache::storage::{SharedEmbeddedConfig, SharedEmbeddedStore};

let _ = SharedEmbeddedStore::<3>::new(SharedEmbeddedConfig::default());

Implementations

impl<const SHARDS: usize> SharedEmbeddedStore<SHARDS>

pub fn new(config: SharedEmbeddedConfig) -> Self

Creates a cloneable shared embedded store with SHARDS lock stripes.

pub const fn shard_count(&self) -> usize

Returns the number of cache stripes.

pub fn route_mode(&self) -> EmbeddedRouteMode

Returns the configured route mode.

pub fn route_key(&self, key: &[u8]) -> EmbeddedKeyRoute

Computes the route for a key.

pub fn route_session(&self, session_prefix: &[u8]) -> EmbeddedSessionRoute

Computes the route for a session prefix.

impl<const SHARDS: usize> SharedEmbeddedStore<SHARDS>

pub fn get(&self, key: &[u8]) -> Option<Ref<'_>>

Returns a borrowed value guard for key.

pub fn get_mut(&self, key: &[u8]) -> Option<RefMut<'_>>

Returns a mutable guard for key.

pub fn contains_key(&self, key: &[u8]) -> bool

Returns true when key is present in point-key storage.

pub fn insert(&self, key: SharedBytes, value: SharedBytes)

Inserts or replaces a point-key value without a TTL.

pub fn insert_with_ttl( &self, key: SharedBytes, value: SharedBytes, ttl_ms: Option<u64>, )

Inserts or replaces a point-key value with an optional relative TTL.

ttl_ms is measured from the current Unix time in milliseconds. Passing None keeps the no-TTL hot path.

pub fn insert_slice(&self, key: &[u8], value: &[u8])

Inserts or replaces a point-key value from borrowed byte slices.

pub fn insert_slice_with_ttl( &self, key: &[u8], value: &[u8], ttl_ms: Option<u64>, )

Inserts or replaces a point-key value from borrowed bytes with an optional relative TTL.

ttl_ms is measured from the current Unix time in milliseconds. Passing None keeps the no-TTL hot path.

pub fn remove(&self, key: &[u8]) -> Option<SharedBytes>

Removes a point-key value and returns the stored bytes when present.

pub fn entry(&self, key: SharedBytes) -> Entry<'_>

Locks the routed stripe and returns an occupied or vacant entry.

impl<const SHARDS: usize> SharedEmbeddedStore<SHARDS>

pub fn get_session(&self, session_prefix: &[u8], key: &[u8]) -> Option<Ref<'_>>

Returns a borrowed session value guard.

pub fn set_session(&self, session_prefix: &[u8], key: &[u8], value: &[u8])

Inserts or replaces a session-scoped value without a TTL.

Trait Implementations

impl<const SHARDS: usize> Clone for SharedEmbeddedStore<SHARDS>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const SHARDS: usize> Debug for SharedEmbeddedStore<SHARDS>

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

Formats the value using the given formatter.