Struct PeerCache 

pub struct PeerCache { /* private fields */ }

In-memory-Cache PeerKey → PeerCapabilities.

Eine Instanz pro Participant; gelebte Lebensdauer entspricht dem Participant selbst. Thread-Safety liefert der Aufrufer via Arc<Mutex<PeerCache>> oder Arc<RwLock<PeerCache>> — der Cache selbst ist intentional nicht thread-safe, weil pro-Tick meist nur eine Writer-/Reader-Task ihn anfasst.

Implementations

impl PeerCache

pub fn new() -> Self

Leeren Cache bauen.

pub fn len(&self) -> usize

Anzahl bekannter Peers.

pub fn is_empty(&self) -> bool

true wenn kein Peer bekannt.

pub fn insert(&mut self, key: PeerKey, caps: PeerCapabilities)

Vollstaendiger Upsert. Ueberschreibt einen vorhandenen Eintrag mit den neuen Capabilities. Fuer Teil-Updates Self::update_partial nehmen.

pub fn get(&self, key: &PeerKey) -> Option<&PeerCapabilities>

Liest die Capabilities eines Peers.

pub fn update_partial(&mut self, key: PeerKey, update: &PeerCapabilities)

Merged neue Informationen in den existierenden Eintrag. Ist der Peer neu → wird er eingefuegt.

Semantik siehe PeerCapabilities::merge_update.

pub fn forget(&mut self, key: &PeerKey) -> Option<PeerCapabilities>

Entfernt einen Peer aus dem Cache. Liefert die alten Caps falls vorhanden — praktisch fuers Logging bei Session-End.

pub fn iter(&self) -> impl Iterator<Item = (&PeerKey, &PeerCapabilities)>

Iterator ueber alle (PeerKey, PeerCapabilities)-Paare.

Trait Implementations

impl Clone for PeerCache

fn clone(&self) -> PeerCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerCache

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

Formats the value using the given formatter.

impl Default for PeerCache

fn default() -> PeerCache

Returns the “default value” for a type.