Struct ObjectCache 

pub struct ObjectCache { /* private fields */ }

Object cache — central identity-tracking container. Spec §B.2.

Implementations

impl ObjectCache

pub fn new() -> Self

Constructor.

pub fn len(&self) -> usize

Number of held objects.

pub fn is_empty(&self) -> bool

true if the cache is empty.

pub fn register(&mut self, id: ObjectId, state: Vec<u8>) -> ObjectRef

Spec §B.6.3 register_object — inserts a new object into the cache. If the ID already exists, the state is overwritten and the version is incremented (MODIFIED).

pub fn get(&self, id: &ObjectId) -> Option<&ObjectRef>

Lookup by ID.

pub fn weak_ref(&self, id: &ObjectId) -> Option<WeakObjectRef>

Returns a weak reference if the object exists. Spec §B.6.4.

pub fn resolve(&self, weak: &WeakObjectRef) -> Option<&ObjectRef>

Resolves a weak reference. Returns None if the object was removed or the version no longer matches (Spec §B.7.4 optimistic-concurrency check).

pub fn mark_deleted(&mut self, id: &ObjectId) -> bool

Spec §B.6.5 mark_deleted — marks an object for deletion. Actual removal happens on the next commit_all.

pub fn commit_all(&mut self) -> usize

Spec §B.7.4 commit_all — marks all New/Modified objects as Committed and removes Deleted objects.

pub fn rollback_all(&mut self) -> usize

Spec §B.7.4 rollback_all — removes New objects, restores Modified/Deleted back to Committed (but not the state bytes — the caller must hold a snapshot before register).

pub fn ids(&self) -> Vec<ObjectId>

List of all object IDs in stable order.

pub fn iter(&self) -> impl Iterator<Item = &ObjectRef>

Iterates over all objects.

Trait Implementations

impl Debug for ObjectCache

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

Formats the value using the given formatter.

impl Default for ObjectCache

fn default() -> ObjectCache

Returns the “default value” for a type.