Struct IdentityMap 

pub struct IdentityMap { /* private fields */ }

Identity Map for tracking unique object instances.

The map is keyed by (TypeId, pk_hash) to ensure each model type has its own namespace, and objects with the same PK return the same reference.

Implementations

impl IdentityMap

pub fn new() -> Self

Create a new empty identity map.

pub fn insert<M: Model + Send + Sync + 'static>( &mut self, model: M, ) -> Arc<RwLock<M>>

Insert a model into the identity map.

If an object with the same PK already exists, returns the existing reference (the new object is ignored). Otherwise, inserts the new object and returns a reference to it.

Returns

An Arc<RwLock<M>> pointing to the object in the map.

pub fn get<M: Model + Send + Sync + 'static>( &self, pk_values: &[Value], ) -> Option<Arc<RwLock<M>>>

Get an object from the identity map by primary key.

Returns

Some(Arc<RwLock<M>>) if found, None otherwise. The returned Arc is a clone of the stored Arc, so modifications are shared.

pub fn contains<M: Model + 'static>(&self, pk_values: &[Value]) -> bool

Check if an object with the given PK exists in the map.

pub fn contains_model<M: Model + 'static>(&self, model: &M) -> bool

Check if a model instance exists in the map.

pub fn remove<M: Model + 'static>(&mut self, pk_values: &[Value]) -> bool

Remove an object from the identity map.

Returns

true if the object was removed, false if it wasn’t in the map.

pub fn remove_model<M: Model + 'static>(&mut self, model: &M) -> bool

Remove a model instance from the identity map.

pub fn clear(&mut self)

Clear all entries from the identity map.

pub fn len(&self) -> usize

Get the number of entries in the map.

pub fn is_empty(&self) -> bool

Check if the map is empty.

pub fn get_or_insert<M: Model + Clone + Send + Sync + 'static>( &mut self, model: M, ) -> Arc<RwLock<M>>

Get or insert a model into the identity map.

If an object with the same PK already exists, returns a reference to it. Otherwise, inserts the new object and returns a reference.

This is useful when you want to either get an existing object or insert a new one atomically.

pub fn update<M: Model + Clone + Send + Sync + 'static>( &mut self, model: &M, ) -> bool

Update an object in the identity map.

If the object exists, updates it with the new values and returns true. If it doesn’t exist, returns false.

Trait Implementations

impl Default for IdentityMap

fn default() -> IdentityMap

Returns the “default value” for a type.