FreeRedis 技术文档

FreeRedis 技术文档

FreeRedis 项目地址: https://gitcode.com/gh_mirrors/fr/FreeRedis

---

安装指南

要开始使用 FreeRedis，你需要先在你的 .NET 环境下安装该库。这可以通过 NuGet 包管理器轻松完成。打开你的项目，在包管理控制台执行以下命令：

PM> Install-Package FreeRedis

或者，如果你偏好使用.csproj文件进行管理，可以在项目文件中添加以下条目：

<PackageReference Include="FreeRedis" Version="最新版本号" />

确保替换最新版本号为NuGet仓库中的最新稳定版本。

项目的使用说明

FreeRedis 提供了与 Redis 数据库交互的所有基本功能，并兼容多种.NET环境。以下是一些基本操作示例：

基础连接与简单操作

using FreeRedis;

public static void Main()
{
    var cli = new RedisClient("127.0.0.1:6379,password=yourpassword,defaultDatabase=0");
    
    // 设置键值对
    cli.Set("hello", "world");
    
    // 获取键对应的值
    var value = cli.Get("hello");
    Console.WriteLine(value);
    
    // 多个键值设置
    cli.MSet("key1", "value1", "key2", "value2");
    
    // 批量获取键值
    var values = cli.MGet("key1", "key2");
}

API使用文档

高级特性

客户端侧缓存

对于需要提高读取效率的场景，FreeRedis 支持客户端缓存，但要求Redis服务器版本6.0以上。

cli.UseClientSideCaching(new ClientSideCachingOptions
{
    Capacity = 100,
    KeyFilter = key => key.StartsWith("cache."),
    CheckExpired = (key, dt) => DateTimeOffset.UtcNow - dt > TimeSpan.FromMinutes(5)
});

集群与哨兵模式

• 集群: 直接通过节点地址列表连接。
• 哨兵: 指定哨兵服务地址和主从名称即可自动发现主库进行读写分离。

脚本(Lua Scripting)

Lua脚本用于批量执行多条命令，减少网络往返，提升性能。

var result = cli.Eval("return redis.call(' incr', KEYS[1])", new[] {"counter"});

项目安装方式

再次强调，推荐通过NuGet包管理器安装FreeRedis，这是最便捷的方式。保证你的NuGet源已经配置正确，然后执行上述安装指南中的命令。

---

此文档涵盖了FreeRedis的基本使用，高级特性的集成以及安装方法。希望这份文档能够帮助您快速上手FreeRedis，解锁更多基于Redis的高效数据处理能力。如有更详细的需求或特定场景的应用，参考官方文档或GitHub页面上的说明会更加详尽。

FreeRedis 项目地址: https://gitcode.com/gh_mirrors/fr/FreeRedis