Struct CacheKey

pub struct CacheKey {
    pub user_tag: String,
    /* private fields */
}

General purpose cache key

Fields

user_tag: String

An extra tag for identifying users

For example, if the storage backend implements per user quota, this tag can be used.

Implementations

impl CacheKey

pub fn set_variance_key(&mut self, key: HashBinary)

Set the value of the variance hash

pub fn get_variance_key(&self) -> Option<&HashBinary>

Get the value of the variance hash

pub fn remove_variance_key(&mut self)

Removes the variance from this cache key

pub fn set_primary_bin_override(&mut self, key: HashBinary)

Override the primary key hash

impl CacheKey

pub fn default(req_header: &ReqHeader) -> Self

Create a default CacheKey from a request, which just takes it URI as the primary key.

pub fn new<S1, S2, S3>(namespace: S1, primary: S2, user_tag: S3) -> Self

where S1: Into<String>, S2: Into<String>, S3: Into<String>,

Create a new CacheKey from the given namespace, primary, and user_tag string.

Both namespace and primary will be used for the primary hash

pub fn namespace(&self) -> &str

Return the namespace of this key

pub fn primary_key(&self) -> &str

Return the primary key of this key

pub fn to_compact(&self) -> CompactCacheKey

Convert this key to CompactCacheKey.

Trait Implementations

impl CacheHashKey for CacheKey

fn primary_bin(&self) -> HashBinary

Return the hash of the cache key

fn variance_bin(&self) -> Option<HashBinary>

Return the variance hash of the cache key.

fn user_tag(&self) -> &str

An extra tag for identifying users

fn combined_bin(&self) -> HashBinary

Return the hash including both primary and variance keys

fn primary(&self) -> String

The hex string of Self::primary_bin()

fn variance(&self) -> Option<String>

The hex string of Self::variance_bin()

fn combined(&self) -> String

The hex string of Self::combined_bin()

impl Clone for CacheKey

fn clone(&self) -> CacheKey

Returns a copy 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.