STRHM

Stark typisiertes Redis-Hashset-Modell

Einführungsartikel

Unterstützte Frameworks

• Version 1.x – .NET 4.6.1 und NETStandard1.5
• Version 2.x – .NET 4.6.1 und .NETStandard2.0

Anwendungsbeispiel

Eine Beispielentität wird eine Buchklasse sein, die über einige grundlegende Felder verfügt.

 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; }
}

Das ist richtig, Ihnen ist ein benutzerdefiniertes Attribut aufgefallen. Dieses Attribut ist dafür verantwortlich, dass eine bestimmte Eigenschaft serialisiert wird, wenn sie als Wert im Redis-Hash festgelegt wird.

Das Buch-Repository erbt von BaseRedisHashSetRepository, da es die am häufigsten benötigten Funktionen und Datenbankverbindungen bereitstellt, falls Sie die Funktionalität im Buch-Repository selbst erweitern möchten.

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

Konstruktorparameter:

• IRedisConnection – ist für die Erstellung und Bereitstellung der Verbindung zu Redis verantwortlich. Es kann Ihre eigene Implementierung für einen bestimmten Anwendungsfall sein, aber standardmäßig können Sie die RedisConnection-Implementierung verwenden, die Ihre Konfigurationsoptionen in ihrem Konstruktor erwartet.
• IStronglyTypedRedisSerializer – Wird zum Serialisieren und Deserialisieren von Werten in und von Redis verwendet. Es liegt an Ihnen, welche Bibliothek Sie verwenden möchten – Jil, Newtonsoft oder eine andere. Sie können STRHM.Serialization.NewtonsoftJson für Newtonsoft.Json verwenden.
• RedisHashSetOptions – Konfigurationsobjekt für Ihr Repository, welche Namespaces verwendet werden sollen, welcher Datenbankindex und welche Befehlsflags.

Beispiele für das Abrufen von Werten:

 // 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)

oder

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

Beispiele für Einstellwerte:

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

oder

 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 }  
 });