Struct ThreadSafeMemoryStore

pub struct ThreadSafeMemoryStore<K, V> { /* private fields */ }

This struct is unsafe under the hood, so you must be careful when using it. No professional reviewed the unsafe usage and the safe code to do this would be too complex for me.

All unsafe usage is mainly to detach inner locks from the hashmap lock itself tho, so as long as the hashmap itself doesn’t move the value or the entry gets deleted, nothing should happen, and I think both can’t happen at least now.

Implementations

impl<K: Hash + Eq, V> ThreadSafeMemoryStore<K, V>

pub fn new(cache: HashMap<K, V>) -> Self

Trait Implementations

impl<K: Default, V: Default> Default for ThreadSafeMemoryStore<K, V>

fn default() -> ThreadSafeMemoryStore<K, V>

Returns the “default value” for a type.

impl<'lock, K: Hash + Eq + Sized + Clone, V: Clone> ThreadSafeTryCacheStore<'lock> for ThreadSafeMemoryStore<K, V>

where Self: 'lock,

type Key = K

type Value = V

type Error = EmptyDumbError

type SLock<'guard> = RwLockAnyGuard<'lock, 'guard, Option<V>> where 'lock: 'guard

Shared lock over a key, must be possible to make one by borrowing a exclusive lock.

type XLock = RwLockWriteGuard<'lock, Option<V>>

Exclusive lock over a wey.

fn ts_try_get( &'lock self, handle: &Self::SLock<'_>, ) -> Result<Option<Self::Value>, Self::Error>

Attempts to return an option of the owned cache element if present.

fn ts_try_set( &'lock self, handle: &mut Self::XLock, value: &Self::Value, ) -> Result<(), Self::Error>

Attempts to set a value given its key.

fn ts_try_exists( &'lock self, handle: &Self::SLock<'_>, ) -> Result<bool, Self::Error>

Attempts to check if the cache key entry exists.

fn ts_try_xlock( &'lock self, key: &'lock Self::Key, ) -> Result<Self::XLock, Self::Error>

Attempt to exclusively lock a key until the handle is dropped.

fn ts_try_slock( &'lock self, key: &'lock Self::Key, ) -> Result<Self::SLock<'lock>, Self::Error>

Attempt to acquire a shared lock of a key until the handle is dropped.

fn ts_try_xlock_nblock( &'lock self, key: &'lock Self::Key, ) -> Result<Self::XLock, Self::Error>

Attempt to exclusively lock a key until the handle is dropped. Non block.

fn ts_try_slock_nblock( &'lock self, key: &'lock Self::Key, ) -> Result<Self::SLock<'lock>, Self::Error>

Attempt to acquire a shared lock of a key until the handle is dropped. Non block.

fn ts_one_try_get( &'lock self, key: &'lock Self::Key, ) -> Result<Option<Self::Value>, Self::Error>

Same as ts_get but it performs a one-time lock

fn ts_one_try_set( &'lock self, key: &'lock Self::Key, value: &Self::Value, ) -> Result<(), Self::Error>

Same as ts_set but it performs a one-time lock

fn ts_one_try_exists( &'lock self, key: &'lock Self::Key, ) -> Result<bool, Self::Error>

Same as ts_exists but it performs a one-time lock