STRHM

Строго типизированная модель Redis Hashset

Вводная статья

Поддерживаемые платформы

• Версия 1.x — .NET 4.6.1 и NETStandard1.5.
• Версия 2.x — .NET 4.6.1 и .NETStandard2.0.

Пример использования

Примером сущности будет класс Book, имеющий пару основных полей.

 public class Book
{
    public int Id { get; set; }

    public int? Rating { get; set; }

    public DateTime PublishedOn { get; set; }

    [SerializableRedisProperty]
    public List<Author> Authors { get; set; }
}

Правильно, вы заметили пользовательский атрибут. Этот атрибут отвечает за сериализацию определенного свойства, когда оно устанавливается в хэш Redis в качестве значения.

Репозиторий книг наследуется от BaseRedisHashSetRepository, поскольку он предоставляет наиболее часто необходимые функции и подключение к базе данных, на случай, если вы захотите расширить функциональность самого репозитория книг.

 public class BookRepository : BaseRedisHashSetRepository<Book>
{
    public BookRepository(IRedisConnection redisConnection, IStronglyTypedRedisSerializer serializer, RedisHashSetOptions configurationOptions) 
        : base(redisConnection, serializer, configurationOptions)
    {
    }
}

Параметры конструктора:

• IRedisConnection — отвечает за создание и обслуживание подключения к Redis. Это может быть ваша собственная реализация для конкретного варианта использования, но по умолчанию вы можете использовать реализацию RedisConnection, которая ожидает ваши параметры конфигурации в своем конструкторе.
• IStronglyTypedRedisSerializer — используется для сериализации и десериализации значений в Redis и из него. Какую библиотеку использовать — решать вам — Jil, Newtonsoft или любую другую. Вы можете использовать STRHM.Serialization.NewtonsoftJson для Newtonsoft.Json.
• RedisHashSetOptions — объект конфигурации для вашего репозитория, какие пространства имен использовать, какой индекс базы данных и командные флаги.

Примеры получения значений:

 // Check if value is set on property
if (updatedBook.HasValue(b => b.Rating))
// Get values
updatedBook.Get<IEnumerable<Author>>(b => b.Authors)
updatedBook.Get<int?>(b => b.Rating)

или

 var book = await _bookRepository.GetAsync(book.Id.ToString());

Примеры значений настройки:

 await _bookRepository.SaveAsync(book.Id.ToString(), book);

или

 await _bookRepository.HashSetAsync(book.Id.ToString(), new StronglyTypedDictionary<Book>(new StronglyTypedRedisNewtonsoftSerializer())  
{  
      { b => b.Rating, 10 },  
      { b => b.Authors, new List<Author>()},  
      { b => b.PublishedOn, DateTime.Now }  
 });