Struct ThreadSafeFileStore

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

Thread safe store based on files

Implementations

impl<K: CustomHash, V> ThreadSafeFileStore<K, V>

pub fn new_on(path: impl AsRef<Path> + TryInto<PathBuf>) -> Result<Self>

Makes a new instance from a directory path Doesn’t perform any file lock, you must ensure this path isn’t used by other processes or even this one itself.

Errors

Fails when any underlying io call does.

Trait Implementations

impl<'lock, K: Clone + Hash + Eq + CustomHash, V: Clone + AsRef<[u8]> + From<Vec<u8>>> ThreadSafeTryCacheStore<'lock> for ThreadSafeFileStore<K, V>

where Self: 'lock,

type Key = K

type Value = V

type Error = ThreadSafeFileStoreError

type SLock<'guard> = RwLockAnyGuardKey<'lock, 'guard, (), K> where 'lock: 'guard

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

type XLock = (RwLockWriteGuard<'lock, ()>, &'lock K)

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