Struct RedisCache 

pub struct RedisCache { /* private fields */ }

Redis-backed response cache for GET endpoints.

Cache keys follow the pattern: shaperail:<resource>:<endpoint>:<query_hash>:<user_role> Auto-invalidation deletes all keys for a resource when a write occurs.

Implementations

impl RedisCache

pub fn new(pool: Arc<Pool>) -> Self

Creates a new cache backed by the given Redis pool.

pub fn build_key( resource: &str, endpoint: &str, query_params: &HashMap<String, String>, user_role: &str, ) -> String

Builds a cache key from components.

Format: shaperail:<resource>:<endpoint>:<query_hash>:<tenant_id>:<role> The tenant_id segment ensures cache entries never leak across tenants (M18).

pub fn build_key_with_tenant( resource: &str, endpoint: &str, query_params: &HashMap<String, String>, user_role: &str, tenant_id: &str, ) -> String

Builds a tenant-scoped cache key (M18).

pub async fn get(&self, key: &str) -> Option<String>

Attempts to retrieve a cached response.

Returns None on cache miss or Redis errors (fail-open).

pub async fn set(&self, key: &str, value: &str, ttl_secs: u64)

Stores a response in the cache with the given TTL.

Silently ignores Redis errors (fail-open).

pub async fn invalidate_resource(&self, resource: &str)

Invalidates all cache keys for a given resource.

Uses SCAN to find matching keys and DEL to remove them. Silently ignores Redis errors (fail-open).

pub async fn invalidate_if_needed( &self, resource: &str, action: &str, invalidate_on: Option<&[String]>, )

Invalidates cache for a resource only if the action matches the endpoint’s invalidate_on list.

If invalidate_on is None, all writes invalidate.

Trait Implementations

impl Clone for RedisCache

fn clone(&self) -> RedisCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.