Почистить комментарии от упоминаний процесса
Удалены <remarks>, <summary> сжаты до короткой фразы, вырезаны ссылки на Task/Ruling/этап/python/прототип; //-комментарии со ссылками на процесс удалены; то же в .proto. Правила обновлены в docs/spec/Код-стайл-Дейл.md. Строк комментариев 27210 -> ~19100.
This commit is contained in:
@@ -3,17 +3,10 @@ using System.Diagnostics.CodeAnalysis;
|
||||
namespace Deal.Telegram.Caching;
|
||||
|
||||
/// <summary>
|
||||
/// Кэш с ограниченной ёмкостью и вытеснением least-recently-used (LRU): при переполнении удаляется
|
||||
/// элемент, к которому дольше всего не обращались. Нужен там, где раньше жил неограниченный
|
||||
/// <see cref="Dictionary{TKey,TValue}"/> и память росла с числом сущностей (долгоживущий процесс сервиса).
|
||||
/// Кэш с ограниченной ёмкостью и вытеснением least-recently-used
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// НЕ потокобезопасен: вызывающий обязан сериализовать доступ (в telegram-service кэши
|
||||
/// WTelegramSessionClient защищены общим <c>_entityCacheGate</c>). Вытеснение — забота производительности,
|
||||
/// а не корректности: потерянное значение всегда можно получить повторным запросом к Telegram.
|
||||
/// </remarks>
|
||||
/// <typeparam name="TKey">Тип ключа (ссылочный или значимый).</typeparam>
|
||||
/// <typeparam name="TValue">Тип значения.</typeparam>
|
||||
/// <param name="TKey">Тип ключа (ссылочный или значимый).</param>
|
||||
/// <param name="TValue">Тип значения.</param>
|
||||
public sealed class LruCache<TKey, TValue>
|
||||
where TKey : notnull
|
||||
{
|
||||
@@ -66,15 +59,14 @@ public sealed class LruCache<TKey, TValue>
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Проверяет наличие ключа, не меняя недавность (лёгкая проверка без вытеснения).
|
||||
/// Проверяет наличие ключа, не меняя недавность
|
||||
/// </summary>
|
||||
/// <param name="key">Ключ.</param>
|
||||
/// <returns>True — ключ есть в кэше.</returns>
|
||||
public bool ContainsKey(TKey key) => _map.ContainsKey(key);
|
||||
|
||||
/// <summary>
|
||||
/// Записывает значение по ключу (вставка или обновление) и вытесняет самый давний элемент при
|
||||
/// переполнении. Обновление существующего ключа делает его самым недавним.
|
||||
/// Записывает значение по ключу
|
||||
/// </summary>
|
||||
/// <param name="key">Ключ.</param>
|
||||
/// <param name="value">Значение.</param>
|
||||
|
||||
Reference in New Issue
Block a user