Struct EntityKey 

pub struct EntityKey {
    pub entity_type: String,
    pub entity_id: String,
}

Type-safe entity key for cache invalidation.

Combines entity type and ID into a single, hashable key for use in dependency tracking and cache invalidation.

Fields

entity_type: String

Entity type (e.g., “User”, “Post”)

entity_id: String

Entity ID (UUID)

Implementations

impl EntityKey

pub fn new(entity_type: &str, entity_id: &str) -> Result<Self>

Create a new entity key with validation.

Arguments

• entity_type - The type of entity (must be non-empty)
• entity_id - The entity’s unique identifier (must be non-empty)

Returns

• Ok(EntityKey) - If both arguments are valid
• Err(_) - If either argument is empty

Errors

Returns FraiseQLError::Validation if entity_type or entity_id is empty, or if entity_type contains a colon character (reserved as the cache-key separator).

Examples

use fraiseql_core::cache::EntityKey;

let key = EntityKey::new("User", "550e8400-e29b-41d4-a716-446655440000").unwrap();
assert_eq!(key.entity_type, "User");

pub fn to_cache_key(&self) -> String

Convert entity key to cache key format: “EntityType:entity_id”

Examples

use fraiseql_core::cache::EntityKey;

let key = EntityKey::new("User", "550e8400-e29b-41d4-a716-446655440000").unwrap();
assert_eq!(key.to_cache_key(), "User:550e8400-e29b-41d4-a716-446655440000");

pub fn from_cache_key(cache_key: &str) -> Result<Self>

Parse entity key from cache key format: “EntityType:entity_id”

Arguments

• cache_key - String in format “Type:id”

Returns

• Ok(EntityKey) - If format is valid
• Err(_) - If format is invalid

Errors

Returns FraiseQLError::Validation if cache_key does not contain a colon separator or if the resulting type or id part is invalid (see EntityKey::new).

Examples

use fraiseql_core::cache::EntityKey;

let key = EntityKey::from_cache_key("User:550e8400-e29b-41d4-a716-446655440000").unwrap();
assert_eq!(key.entity_type, "User");

Trait Implementations

impl Clone for EntityKey

fn clone(&self) -> EntityKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EntityKey

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

Formats the value using the given formatter.

impl Display for EntityKey

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

Formats the value using the given formatter.

impl Hash for EntityKey

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 Ord for EntityKey

fn cmp(&self, other: &EntityKey) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for EntityKey

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

fn partial_cmp(&self, other: &EntityKey) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for EntityKey

impl StructuralPartialEq for EntityKey