Struct FaceTable 

pub struct FaceTable { /* private fields */ }

Concurrent map from FaceId to a type-erased face handle.

Pipeline stages clone the Arc<dyn ErasedFace> out of the table and release the table reference before calling send(), so no lock is held during I/O.

Face IDs are recycled: when a face is removed its ID is returned to a free list and reused by the next alloc_id() call. Reserved IDs (>= 0xFFFF_0000) are never allocated by alloc_id() and are used for internal engine faces (e.g. the management AppFace).

Implementations

impl FaceTable

pub fn new() -> Self

pub fn alloc_id(&self) -> FaceId

Allocate the next available FaceId, reusing a recycled ID if possible.

Never returns an ID in the reserved range (>= RESERVED_FACE_ID_MIN).

pub fn insert<F: Face>(&self, face: F) -> FaceId

Register a face. Returns the assigned FaceId.

pub fn insert_arc(&self, face: Arc<dyn ErasedFace>) -> FaceId

Register a pre-wrapped erased face (e.g. a face accepted from a listener that is already stored in an Arc). Returns the face’s FaceId.

pub fn get(&self, id: FaceId) -> Option<Arc<dyn ErasedFace>>

Look up a face handle. Returns None if the face has been removed.

pub fn remove(&self, id: FaceId)

Remove a face from the table, recycling its ID for future alloc_id() calls.

pub fn len(&self) -> usize

Number of registered faces.

pub fn is_empty(&self) -> bool

pub fn face_ids(&self) -> Vec<FaceId>

Iterate over all registered face IDs.

pub fn face_entries(&self) -> Vec<(FaceId, FaceKind)>

Return all registered faces as (FaceId, FaceKind) pairs.

pub fn face_info(&self) -> Vec<FaceInfo>

Return detailed info for all registered faces.

Trait Implementations

impl Default for FaceTable

fn default() -> Self

Returns the “default value” for a type.