CloudStructures is the Redis client based on StackExchange.Redis.
StackExchange.Redis is very pure and low level library. It's Redis driver like ADO.NET. It's difficult to use it as raw. CloudStructures provides simple O/R (Object / Redis) mapper like Dapper for ADO.NET.
dotnet add package CloudStructures
CloudStructures supports these Redis data types. All methods are async.
Structure DescriptionRedisBit
Bits API RedisDictionary<TKey, TValue>
Hashes API with constrained value type RedisGeo<T>
Geometries API RedisHashSet<T>
like RedisDictionary<T, bool>
RedisHyperLogLog<T>
HyperLogLogs API RedisList<T>
Lists API RedisLua
Lua eval API RedisSet<T>
Sets API RedisSortedSet<T>
SortedSets API RedisString<T>
Strings API
Following code is simple sample.
// RedisConnection have to be held as static. public static class RedisServer { public static RedisConnection Connection { get; } public static RedisServer() { var config = new RedisConfig("name", "connectionString"); Connection = new RedisConnection(config); } } // A certain data class public class Person { public string Name { get; set; } public int Age { get; set; } } // 1. Create redis structure var key = "test-key"; var defaultExpiry = TimeSpan.FromDays(1); var redis = new RedisString<Person>(RedisServer.Connection, key, defaultExpiry) // 2. Call command var neuecc = new Person("neuecc", 35); await redis.SetAsync(neuecc); var result = await redis.GetAsync();
If you use this library, you should implement IValueConverter
to serialize your original class. Unless you pass custom IValueConverter
to RedisConnection
ctor, fallback to SystemTextJsonConverter
automatically that is default converter we provide.
IValueConverter
using CloudStructures.Converters; using Utf8Json; using Utf8Json.Resolvers; namespace HowToImplement_CustomValueConverter { public sealed class Utf8JsonConverter : IValueConverter { public byte[] Serialize<T>(T value) => JsonSerializer.Serialize(value, StandardResolver.AllowPrivate); public T Deserialize<T>(byte[] value) => JsonSerializer.Deserialize<T>(value, StandardResolver.AllowPrivate); } }
using CloudStructures.Converters; using MessagePack; using MessagePack.Resolvers; namespace HowToImplement_CustomValueConverter { public sealed class MessagePackConverter : IValueConverter { private MessagePackSerializerOptions Options { get; } public MessagePackConverter(MessagePackSerializerOptions options) => this.Options = options; public byte[] Serialize<T>(T value) => MessagePackSerializer.Serialize(value, this.Options); public T Deserialize<T>(byte[] value) => MessagePackSerializer.Deserialize<T>(value, this.Options); } }
Yoshifumi Kawai is software developer in Tokyo, Japan. Awarded Microsoft MVP (C#) since April, 2011. He's the original owner of this project.
Takaaki Suzuki is software developer in Fukui, Japan. Awarded Microsoft MVP (C#) since July, 2012. He's a contributer who led the .NET Standard support.
This library is under the MIT License.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4