CloudStructures 3.3.0

CloudStructures

CloudStructures 是基于 Redis 的客户端，基于 StackExchange.Redis。

StackExchange.Redis 是一个非常纯净和底层的库。它是类似于 ADO.NET 的 Redis 驱动程序。它很难作为原始使用。CloudStructures 提供类似于 Dapper 的简单 O/R（对象 / Redis）映射程序。

支持的框架

• .NET 6+
• .NET Standard 2.0+
• .NET Framework 4.6.1+

安装

dotnet add package CloudStructures

Redis 的数据结构

CloudStructures 支持以下 Redis 数据类型。所有方法都是异步的。

入门指南

以下代码是简单的示例。

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

值转换器

如果您使用这个库，应当实现IValueConverter来序列化您原始的类。除非您将自定义的IValueConverter传递给RedisConnection构造函数，否则将自动回退到我们提供的默认转换器SystemTextJsonConverter。

如何实现自定义的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);
    }
}

作者

• 樱井勇作（别名 @neuecc）
• 铃木隆明（别名 @xin9le）

樱井勇作是日本东京的软件开发者。自2011年4月起获得微软MVP (C#)。他是这个项目的原始所有者。

铃木隆明是日本福井的软件开发者。自2012年7月起获得微软MVP (C#)。他是领导.NET Standard支持的贡献者。

许可协议

此库受MIT许可证的约束。