Struct CacheKey 

pub struct CacheKey { /* private fields */ }

A cache key that uniquely identifies a cached value.

Keys are structured as prefix:namespace:identifier to enable pattern-based invalidation.

Implementations

impl CacheKey

pub fn new(namespace: impl Into<String>, identifier: impl Into<String>) -> Self

Create a new cache key.

pub fn with_prefix( prefix: impl Into<String>, namespace: impl Into<String>, identifier: impl Into<String>, ) -> Self

Create a cache key with a custom prefix.

pub fn entity_record<I: Display>(entity: &str, id: I) -> Self

Create a key for a specific entity record.

pub fn query(entity: &str, query_hash: u64) -> Self

Create a key for a query result.

pub fn find_unique<I: Display>(entity: &str, field: &str, value: I) -> Self

Create a key for a find-unique query.

pub fn find_many(entity: &str, filter_hash: u64) -> Self

Create a key for a find-many query with filters.

pub fn aggregate(entity: &str, agg_hash: u64) -> Self

Create a key for an aggregation.

pub fn relation<I: Display>( from_entity: &str, from_id: I, relation: &str, ) -> Self

Create a key for a relation.

pub fn with_tenant(self, tenant: impl Into<String>) -> Self

Set the tenant for multi-tenant apps.

pub fn as_str(&self) -> String

Get the full key string.

pub fn namespace(&self) -> &str

Get the namespace.

pub fn identifier(&self) -> &str

Get the identifier.

pub fn prefix(&self) -> &str

Get the prefix.

pub fn tenant(&self) -> Option<&str>

Get the tenant if set.

Trait Implementations

impl Clone for CacheKey

fn clone(&self) -> CacheKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CacheKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for CacheKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&str> for CacheKey

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for CacheKey

fn from(s: String) -> Self

Converts to this type from the input type.

impl Hash for CacheKey

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CacheKey

fn eq(&self, other: &CacheKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CacheKey

impl StructuralPartialEq for CacheKey