rs-zero 0.1.1

Rust-first microservice framework inspired by go-zero engineering practices
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

use std::time::Duration;

use async_trait::async_trait;
use serde::{Serialize, de::DeserializeOwned};

use crate::cache::{CacheKey, CacheResult};

/// Async cache store abstraction.
#[async_trait]
pub trait CacheStore: Send + Sync {
    /// Reads a raw value by key.
    async fn get_raw(&self, key: &CacheKey) -> CacheResult<Option<Vec<u8>>>;

    /// Writes a raw value with optional TTL.
    async fn set_raw(
        &self,
        key: &CacheKey,
        value: Vec<u8>,
        ttl: Option<Duration>,
    ) -> CacheResult<()>;

    /// Deletes a value by key.
    async fn delete(&self, key: &CacheKey) -> CacheResult<()>;

    /// Reads a JSON value by key.
    async fn get_json<T>(&self, key: &CacheKey) -> CacheResult<Option<T>>
    where
        T: DeserializeOwned + Send,
    {
        match self.get_raw(key).await? {
            Some(bytes) => Ok(Some(serde_json::from_slice(&bytes)?)),
            None => Ok(None),
        }
    }

    /// Writes a JSON value with optional TTL.
    async fn set_json<T>(&self, key: &CacheKey, value: &T, ttl: Option<Duration>) -> CacheResult<()>
    where
        T: Serialize + Sync,
    {
        self.set_raw(key, serde_json::to_vec(value)?, ttl).await
    }
}