Class LastSeenCacheTracker<TKey, TValue>

Namespace

FishMMO.Server.Core.Collections

Assembly

FishMMO.Server.dll

Queue/index tracker for key-value caches whose entries expire by last-seen timestamp. Optimized for high-frequency touch and bounded head-first TTL sweeps.

public sealed class LastSeenCacheTracker<TKey, TValue>

Type Parameters

TKey

Cache key type.

TValue

Cache value type.

Inheritance

object

LastSeenCacheTracker<TKey, TValue>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

LastSeenCacheTracker(IEqualityComparer<TKey>)

Initializes a new tracker with an optional key comparer.

public LastSeenCacheTracker(IEqualityComparer<TKey> comparer = null)

Parameters

comparer IEqualityComparer<TKey>

Methods

Clear()

Clears all cached entries.

public void Clear()

Remove(TKey)

Removes a cached key if present.

public void Remove(TKey key)

Parameters

key TKey

SweepExpired(DateTime, TimeSpan, int, int)

Sweeps entries whose last-seen exceeds the provided TTL.

public int SweepExpired(DateTime nowUtc, TimeSpan ttl, int maxScan, int maxRemove)

Parameters

nowUtc DateTime

ttl TimeSpan

maxScan int

maxRemove int

Returns

int

TryGetAndTouch(TKey, DateTime, out TValue)

Tries to get a cached value and refreshes its last-seen timestamp.

public bool TryGetAndTouch(TKey key, DateTime nowUtc, out TValue value)

Parameters

key TKey

nowUtc DateTime

value TValue

Returns

bool

Upsert(TKey, TValue, DateTime)

Inserts or updates a cached value and sets its last-seen timestamp.

public void Upsert(TKey key, TValue value, DateTime nowUtc)

Parameters

key TKey

value TValue

nowUtc DateTime