Struct futures_cache::Cache

pub struct Cache { /* fields omitted */ }

Primary cache abstraction.

Can be cheaply cloned and namespaced.

Implementations

impl Cache

pub fn load(db: Tree) -> Result<Cache, Error>

Load the cache from the database.

pub fn delete_with_ns<N, K>(&self, ns: Option<&N>, key: &K) -> Result<(), Error> where
    N: Serialize,
    K: Serialize, 

Delete the given key from the specified namespace.

pub fn list_json(&self) -> Result<Vec<JsonEntry>, Error>

List all cache entries as JSON.

pub fn namespaced<N>(&self, ns: &N) -> Result<Self, Error> where
    N: Serialize, 

Create a namespaced cache.

The namespace must be unique to avoid conflicts.

Each call to this functions will return its own queue for resolving futures.

pub fn insert<K, T>(
    &self,
    key: K,
    age: Duration,
    value: &T
) -> Result<(), Error> where
    K: Serialize,
    T: Serialize, 

Insert a value into the cache.

pub fn test<K>(&self, key: K) -> Result<State<()>, Error> where
    K: Serialize, 

Test an entry from the cache.

pub fn get<K, T>(&self, key: K) -> Result<State<T>, Error> where
    K: Serialize,
    T: DeserializeOwned, 

Load an entry from the cache.

pub async fn wrap<'a, K, F, T, E>(
    &'a self,
    key: K,
    age: Duration,
    future: F
) -> Result<T, E> where
    K: Serialize,
    F: Future<Output = Result<T, E>>,
    T: Serialize + DeserializeOwned,
    E: From<Error>, 

Wrap the result of the given future to load and store from cache.

Trait Implementations

impl Clone for Cache

pub fn clone(&self) -> Cache

Returns a copy of the value.

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

Performs copy-assignment from source.