Interface IIndividualLifetimeCache<TKey, TValue>

Namespace

LfrlAnvil.Chrono.Caching

Assembly

LfrlAnvil.Chrono.dll

Represents a generic cache of keyed entries with a limited lifetime, where each entry can have its own individual lifetime.

public interface IIndividualLifetimeCache<TKey, TValue> : ILifetimeCache<TKey, TValue>, IReadOnlyLifetimeCache<TKey, TValue>, ICache<TKey, TValue>, IReadOnlyCache<TKey, TValue>, IReadOnlyDictionary<TKey, TValue>, IReadOnlyCollection<KeyValuePair<TKey, TValue>>, IEnumerable<KeyValuePair<TKey, TValue>>, IEnumerable where TKey : notnull

Type Parameters

TKey

Entry key (identifier) type.

TValue

Entry value type.

Inherited Members

ILifetimeCache<TKey, TValue>.Move(Duration)

IReadOnlyLifetimeCache<TKey, TValue>.Lifetime

IReadOnlyLifetimeCache<TKey, TValue>.StartTimestamp

IReadOnlyLifetimeCache<TKey, TValue>.CurrentTimestamp

IReadOnlyLifetimeCache<TKey, TValue>.GetRemainingLifetime(TKey)

ICache<TKey, TValue>.this[TKey]

ICache<TKey, TValue>.TryAdd(TKey, TValue)

ICache<TKey, TValue>.AddOrUpdate(TKey, TValue)

ICache<TKey, TValue>.Remove(TKey)

ICache<TKey, TValue>.Remove(TKey, out TValue)

ICache<TKey, TValue>.Restart(TKey)

ICache<TKey, TValue>.Clear()

IReadOnlyCache<TKey, TValue>.Capacity

IReadOnlyCache<TKey, TValue>.Comparer

IReadOnlyCache<TKey, TValue>.Oldest

IReadOnlyDictionary<TKey, TValue>.ContainsKey(TKey)

IReadOnlyDictionary<TKey, TValue>.TryGetValue(TKey, out TValue)

IReadOnlyDictionary<TKey, TValue>.this[TKey]

IReadOnlyDictionary<TKey, TValue>.Keys

IReadOnlyDictionary<TKey, TValue>.Values

IReadOnlyCollection<KeyValuePair<TKey, TValue>>.Count

IEnumerable<KeyValuePair<TKey, TValue>>.GetEnumerator()

IEnumerable.GetEnumerator()

Extension Methods

LifetimeCacheExtensions.MoveTo<TKey, TValue>(ILifetimeCache<TKey, TValue>, Timestamp)

Remarks

Reading entries resets their lifetime.

Methods

AddOrUpdate(TKey, TValue, Duration)

Adds a new entry or updates an existing one if key already exists.

AddOrUpdateResult AddOrUpdate(TKey key, TValue value, Duration lifetime)

Parameters

key TKey

Entry's key.

value TValue

Entry's value.

lifetime Duration

Entry's lifetime.

Returns

AddOrUpdateResult

Added when new entry has been added (provided key did not exist), otherwise Updated.

Remarks

When new entry addition causes Count to exceed Capacity, then the Oldest entry will be removed automatically.

TryAdd(TKey, TValue, Duration)

Attempts to add a new entry.

bool TryAdd(TKey key, TValue value, Duration lifetime)

Parameters

key TKey

Entry's key.

value TValue

Entry's value.

lifetime Duration

Entry's lifetime.

Returns

bool

true when entry has been added (provided key did not exist), otherwise false.

Remarks

When new entry addition causes Count to exceed Capacity, then the Oldest entry will be removed automatically.