你好,这里是 Dotnet 工具箱,定期分享 Dotnet 有趣,实用的工具和组件,希望对您有用!
Redis是一款高性能、开源的键值对存储系统。它支持多种数据结构,比如字符串、列表、哈希、集合等,可以在内存中存储数据,并提供持久化功能以便在断电等情况下保持数据不丢失。Redis提供了丰富的命令和API,可用于快速地读取、写入和操作数据。
本文介绍 3 款 .NET 流行的 Redis 客户端库。
StackExchange.Redis是一个.NET平台上的高性能、异步的Redis客户端库,由StackExchange团队开发。
StackExchange.Redis通过使用异步方法和IO多路复用等技术,提高了Redis访问的性能和并发性。它还提供了丰富的功能和选项,如连接池、管道、事务、发布/订阅、Lua脚本等,支持多种序列化和压缩方式,可以轻松地与其他.NET应用程序集成。
StackExchange.Redis还支持Redis Sentinel和Redis Cluster等高可用性和集群方案,使得应用程序可以更容易地管理和扩展Redis实例。因此,它是.NET平台上访问Redis的首选客户端库之一。
下面是一个简单的使用示例:
首先,需要在项目中安装 StackExchange.Redis 包,可以通过 NuGet 管理器来安装,也可以手动下载安装。
然后,在代码中创建 ConnectionMultiplexer 对象,这个对象代表与 Redis 服务器的连接。通常来说,应该只创建一个 ConnectionMultiplexer 对象,然后在需要访问 Redis 数据库时使用它。
using StackExchange.Redis;
// 创建 ConnectionMultiplexer 对象
ConnectionMultiplexer redis = ConnectionMultiplexer.Connect("localhost");
接下来,可以使用 ConnectionMultiplexer 对象创建一个或多个 IDatabase 对象,这些对象用来执行实际的 Redis 命令。
// 获取 IDatabase 对象
IDatabase db = redis.GetDatabase();
现在可以使用 IDatabase 对象来执行各种 Redis 命令,比如设置和获取字符串值:
// 设置字符串值
db.StringSet("mykey", "Hello, Redis!");
// 获取字符串值
string value = db.StringGet("mykey");
Console.WriteLine(value);
除了字符串之外,StackExchange.Redis 还支持许多其他 Redis 数据类型,比如哈希表、列表、集合和有序集合。可以使用相应的 API 来执行相关的操作,比如:
// 设置哈希表字段值
db.HashSet("myhash",newHashEntry[]{newHashEntry("field1","value1"),newHashEntry("field2","value2")});
// 获取哈希表字段值
HashEntry[] entries = db.HashGetAll("myhash");
foreach(var entry in entries)
{
Console.WriteLine(entry.Name+": "+ entry.Value);
}
基于 .NET 的 Redis 客户端,支持 .NET Core 2.1+、.NET Framework 4.0+ 以及 Xamarin。
功能特性:
• 🌈 所有方法名与 redis-cli 保持一致
• 🌌 支持 Redis 集群(服务端要求 3.2 及以上版本)
• ⛳ 支持 Redis 哨兵模式
• 🎣 支持主从分离(Master-Slave)
• 📡 支持发布订阅(Pub-Sub)
• 📃 支持 Redis Lua 脚本
• 💻 支持管道(Pipeline)
• 📰 支持事务
• 🌴 支持 GEO 命令(服务端要求 3.2 及以上版本)
• 🌲 支持 STREAM 类型命令(服务端要求 5.0 及以上版本)
• ⚡ 支持本地缓存(Client-side-cahing,服务端要求 6.0 及以上版本)
• 🌳 支持 Redis 6 的 RESP3 协议
🚀 快速入门
public staticRedisClient cli =newRedisClient("127.0.0.1:6379,password=123,defaultDatabase=13");
//cli.Serialize = obj => JsonConvert.SerializeObject(obj);
//cli.Deserialize = (json, type) => JsonConvert.DeserializeObject(json, type);
cli.Notice+=(s, e)=>Console.WriteLine(e.Log);//打印命令日志
cli.Set("key1","value1");
cli.MSet("key1","value1","key2","value2");
string value1 = cli.Get("key1");
string[] vals = cli.MGet("key1","key2");
🎣 Master-Slave (读写分离)
public staticRedisClient cli =newRedisClient(
"127.0.0.1:6379,password=123,defaultDatabase=13",
"127.0.0.1:6380,password=123,defaultDatabase=13",
"127.0.0.1:6381,password=123,defaultDatabase=13"
);
varvalue= cli.Get("key1");
💻 Pipeline (管道)
using (var pipe = cli.StartPipe())
{
pipe.IncrBy("key1",10);
pipe.Set("key2",Null);
pipe.Get("key1");
object[] ret = pipe.EndPipe();
Console.WriteLine(ret[0]+", "+ ret[2]);
}
🌌 Redis Cluster (集群)
假如你有一个 Redis Cluster 集群,其中有三个主节点(7001-7003)、三个从节点(7004-7006),则连接此集群的代码:
public static RedisClient cli = new RedisClient(
new ConnectionStringBuilder[] { "192.168.0.2:7001", "192.168.0.2:7002", "192.168.0.2:7003" }
);
NewLife.Redis
是一个Redis客户端组件,以高性能处理大数据实时计算为目标。Redis协议基础实现Redis/RedisClient位于X组件,本库为扩展实现,主要增加列表结构、哈希结构、队列等高级功能。
功能特性:
• 在ZTO大数据实时计算广泛应用,200多个Redis实例稳定工作一年多,每天处理近1亿包裹数据,日均调用量80亿次
• 低延迟,Get/Set操作平均耗时200~600us(含往返网络通信)
• 大吞吐,自带连接池,最大支持1000并发
• 高性能,支持二进制序列化
基本操作
在基本操作之前,我们先做一些准备工作:
• 新建控制台项目,并在入口函数开头加上
XTrace.UseConsole();
,这是为了方便查看调试日志• 具体测试代码之前,需要加上前面MemoryCache或Redis的实例化代码
• 准备一个模型类User
class User
{
publicStringName{get;set;}
publicDateTimeCreateTime{get;set;}
}
添删改查:
var rds =newFullRedis("127.0.0.1",null,7);
var user =newUser{Name="NewLife",CreateTime=DateTime.Now};
rds.Set("user", user,3600);
var user2 = rds.Get<User>("user");
XTrace.WriteLine("Json: {0}", user2.ToJson());
XTrace.WriteLine("Json: {0}", rds.Get<String>("user"));
if(rds.ContainsKey("user"))XTrace.WriteLine("存在!");
rds.Remove("user");