ezcache

Module stores

Source
Expand description

Several implementations of cache stores for common use cases, all of require std for now:

  • MemoryStore: So just HashMap cool wrapping around. You’ll see it most for examples.
  • ThreadSafeMemoryStore: Concurrent store in memory. Uses unsafe under the hood but should be optimized enough.

With feature “file-stores”:

§Examples

// We create the in-memory store
let mut store: MemoryStore<&'static str, String> = MemoryStore::default();

// Attempting to get a inexsistent key fails.
let value = store.get("key");
assert_eq!(value, None);

// But if we set it
store.set("key", &("value".to_owned()));
// And get it
let value = store.get("key");
assert_eq!(value, Some(String::from("value"))); // Works!
// Or even for multithreading contexts

// We can use a normal store
let memory_store: MemoryStore<(), String> = MemoryStore::default();
// And we make it fallible such that
let try_store: TryCacheStoreErrorMap<_, _, _, EmptyDumbError, _> =
    memory_store.into();
// we can wrap it around a dumb wrapper (explained in crate::thread_safe)
let store = DumbTryThreadSafeWrapper::new(try_store);

// We make it atomic
let store = Arc::new(store);
let store_clone = Arc::clone(&store);

// And threads can access it without problems
thread::spawn(move || {
    store_clone.ts_one_try_set(&(), &String::from("value in thread"))
}).join().unwrap();

// Of course sharing the values within
let value = store.ts_one_try_get(&()).unwrap();
assert_eq!(value, Some(String::from("value in thread")));

Modules§

Structs§

  • MemoryStore
    Simple thread unsafe in memory cache store.
  • ThreadSafeMemoryStore
    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.

Enums§