Iskra.Core.Cache 1.0.136

Iskra.Core.Cache

Обзор

Библиотека предназначена для управления распределенным кэшированием в приложениях .NET. Она предоставляет инструменты для конфигурации, хранения и извлечения данных из кэша с использованием различных стратегий истечения времени жизни.

Основные Компоненты

1. Конфигурация Кэша

   • IskraCacheOptionsPostConfigure: Обеспечивает пост-конфигурацию опций кэша на основе конфигурационных файлов (например, appsettings.json).
   • ServiceCollectionExtensions.AddIskraCache: Метод расширения для регистрации сервисов кэширования в контейнере зависимостей.

2. Фабрика Опций Кэша

   • IskraCacheOptionsFactory: Предоставляет методы для получения настроек кэша для конкретных типов сущностей, проверяя их наличие и корректность.

3. Сервис Кэширования

   • IskraDistributedCache: Реализует интерфейс IIskraDistributedCache для работы с распределенным кэшем.
     • Методы:
       • GetAsync<TCacheEntity>: Извлекает данные из кэша по ключу, десериализует их и возвращает объект типа TCacheEntity.
       • SetAsync<TCacheEntity>: Сериализует объект TCacheEntity и сохраняет его в кэше с заданными опциями истечения времени жизни.

4. Интерфейсы

   • IIskraCacheOptionsFactory: Определяет методы для получения настроек кэша для конкретных типов сущностей.
   • IIskraDistributedCache: Определяет методы для работы с распределенным кэшем, включая получение и установку данных.

5. Абстракции

   • ICacheEntity: Маркерный интерфейс, его должны реализовывать все сущности, которые могут быть закэшированы.

Функциональные Возможности

1. Конфигурируемость

   • Настройки кэша определяются в конфигурационных файлах приложения.
   • Поддержка различных стратегий истечения времени жизни (абсолютное и слайдинговое).

2. Распределенное Кэширование

   • Использование распределенного кэша для хранения данных, что позволяет масштабировать приложение без потери доступности кэшированных данных.

3. Типобезопасность

   • Методы GetAsync и SetAsync параметризованы типом сущности, обеспечивая безопасность типов и упрощающую работу с данными из кэша.

4. Обработка Ошибок

   • Исключения NoCacheDataException и OptionsValidationException предоставляют информацию о проблемах при работе с кэшем или отсутствии настроек.

Использование

Для использования библиотеки необходимо:

1. Добавить пакет в проект.
2. Зарегистрировать сервисы кэширования в контейнере зависимостей:

   using Microsoft.Extensions.DependencyInjection;
   
   public class Startup
   {
    public void ConfigureServices(IServiceCollection services)
    {
    // Другие регистрации сервисов
   
    services.AddIskraCache();
    }
   }
   
   

3. Настроить опции кэша в appsettings.json или другом конфигурационном файле.

{
 "IskraCacheOptions": {
 "User": {
 "Prefix": "user",
 "AbsoluteExpirationRelativeToNow": "01:00:00",
 "SlidingExpiration": "00:30:00"
 },
 "Product": {
 "Prefix": "product",
 "AbsoluteExpirationRelativeToNow": "02:00:00",
 "SlidingExpiration": "01:00:00"
 }
 }
}

4. Создать классы сущностей, которые будут кэшироваться:

 public class User : ICacheEntity
 {
 public int Id { get; set; }
 public string Name { get; set; }
 }

 public class Product : ICacheEntity
 {
 public int Id { get; set; }
 public string Name { get; set; }
 public decimal Price { get; set; }
 }

4. Внедрять и использовать интерфейс IIskraDistributedCache для работы с кэшем.

 using Microsoft.AspNetCore.Mvc;
 using System.Threading.Tasks;

 [ApiController]
 [Route("api/[controller]")]
 public class CacheController : ControllerBase
 {
 private readonly IIskraDistributedCache _cache;

 public CacheController(IIskraDistributedCache cache)
 {
 _cache = cache;
 }

 [HttpGet("user/{id}")]
 public async Task<IActionResult> GetUser(int id)
 {
 var user = await _cache.GetAsync<User>(id);
 if (user == null)
 {
 return NotFound();
 }
 return Ok(user);
 }

 [HttpPost("user")]
 public async Task<IActionResult> SetUser([FromBody] User user)
 {
 await _cache.SetAsync(user.Id, user);
 return CreatedAtAction(nameof(GetUser), new { id = user.Id }, user);
 }

 [HttpGet("product/{id}")]
 public async Task<IActionResult> GetProduct(int id)
 {
 var product = await _cache.GetAsync<Product>(id);
 if (product == null)
 {
 return NotFound();
 }
 return Ok(product);
 }

 [HttpPost("product")]
 public async Task<IActionResult> SetProduct([FromBody] Product product)
 {
 await _cache.SetAsync(product.Id, product);
 return CreatedAtAction(nameof(GetProduct), new { id = product.Id }, product);
 }
 }

Заключение

Библиотека предоставляет удобный и гибкий способ управления распределенным кэшированием в приложениях .NET, обеспечивая конфигурируемость, типобезопасность и надежность работы с кэшем.