Struct Identity 

pub struct Identity {
    pub namespace: String,
    pub key_type: String,
    pub id: String,
    pub use_case: String,
    pub tracked: bool,
    pub args: Vec<(String, String)>,
}

A normalized logical identity. Ordered arguments retain caller order; use normalize_args to build them from a host-language record.

Fields

namespace: String

The instance namespace; empty means the cache fills in its own at execution.

key_type: String

The entity type; serialized as keyType.

id: String

The entity identifier.

use_case: String

The operation name; serialized as useCase.

tracked: bool

Whether the identity is fenced by its entity’s invalidation watermark; serialized as trackForInvalidation. Defaults to false.

args: Vec<(String, String)>

Secondary dimensions as (name, spelled value) pairs, already normalized and in key order.

Implementations

impl Identity

pub fn new( key_type: impl Into<String>, id: impl IntoKeyId, use_case: impl Into<String>, ) -> Self

An untracked identity with an empty namespace and no arguments. IDs use the same IntoKeyId conversion as crate::KeySpec::new and crate::DialCache::invalidate.

pub fn tracked(self, tracked: bool) -> Self

Set whether the identity shares its entity’s invalidation watermark.

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

Set the namespace explicitly instead of inheriting the instance’s.

pub fn args(self, args: Vec<(String, String)>) -> Self

Replace the ordered argument pairs; build them with normalize_args.

pub fn keys(&self) -> Result<Keys, IdentityError>

The logical key, the stored value key and, for tracked identities, the watermark key.

Trait Implementations

impl Clone for Identity

fn clone(&self) -> Identity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Identity

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Identity

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Identity

impl Hash for Identity

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 Identity

fn eq(&self, other: &Identity) -> 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 Serialize for Identity

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Identity