День 2149. #ЗаметкиНаПолях
Гибридный Кэш в ASP.NET Core 9. Окончание
Начало

Используем HybridCache
Допустим, у нас есть API, предоставляющий информацию о продукте. Часто используемые данные будут кэшироваться для повышения производительности:
1. L1 (в памяти) - для обслуживания быстрых чтений из локального кэша.
2. L2 (Redis) - для обеспечения согласованности данных в распределённых экземплярах.

public class ProductService(
 HybridCache cache)
{
  public async Task<List<Product>> 
   GetProductsByCategoryAsync(
    string category, 
    CancellationToken ct = default)
  {
    var key = $"products:category:{category}";

    return await cache.GetOrCreateAsync(
      key,
      async token => 
       await FetchFromDB(category, token),
      ct
    );
  }
}

Как это работает
1. Метод проверяет, существует ли key в HybridCache. Если да, возвращаются кэшированные данные (из L1, если доступно; в противном случае из L2).
2. Если данные отсутствуют в кэшах L1 и L2, вызывается делегат (FetchFromDB) для извлечения данных из базы данных.
3. После извлечения данных они сохраняются в кэшах L1 и L2 с указанными политиками истечения срока действия (HybridCacheEntryOptions - их можно задать для всех элементов при регистрации кэша, либо в перегруженной версии GetOrCreateAsync).
4. Метод возвращает список продуктов либо из кэша, либо после извлечения из базы данных.

Удаление данных из кэша
Можно использовать метод RemoveAsync:

public async Task RemoveFromCache(
 string category, 
 CancellationToken ct = default)
{
  var key = $"products:category:{category}";
  await cache.RemoveAsync(key, ct);
}

Запись удаляется из кэшей L1 и L2. Если ключ не существует, метод не делает ничего.

Добавление элементов с тегами
При сохранении записей в кэше вы можете назначать теги для их логической группировки. Для этого используется перегрузка GetOrCreateAsync:

// …
 return await cache.GetOrCreateAsync(
   key,
   async token => 
     await FetchFromDB(category, token),
   new HybridCacheEntryOptions
   {
     Expiration = TimeSpan.FromMinutes(10),
     LocalCacheExpiration = TimeSpan.FromMinutes(5),
     Tags = new List<string> { $"category:{category}" }
   },
   ct
 );

Здесь мы задаём другие параметры истечения срока действия, а также тег для элементов.

Чтобы удалить все элементы, имеющие определённый тэг, используется метод RemoveByTagAsync:

public async Task InvalidateByTag(
 string tag,
 CancellationToken ct = default
)
{
  await _cache.RemoveByTagAsync(tag, ct);
}

Источник: https://thecodeman.net/posts/hybrid-cache-in-aspnet-core