Redis面试题:
1、什么是事务?2、Redis中有事务吗?3、Redis中的事务可以回滚吗?
答:
1、事务是指一个完整的动作,要么全部执行,要么什么也没有做
2、Redis中有事务,Redis 事务不是严格意义上的事务,只是用于帮助用户在一个步骤中执行多个命令。单个 Redis 命令的执行是原子性的,但 Redis 没有在事务上增加任何维持原子性的机制,所以 Redis 事务的执行并不是原子性的
3、Redis 事务可以理解为一个打包的批量执行脚本,但批量指令并非原子化的操作,中间某条指令的失败不会导致前面已做指令回滚,也不会造成后续的指令不做
事务一般都是为原子性而生,既然Redis事务没有原子性,那他存在的意义是什么
答:redis事务的主要作用就是串联多个命令防止 别的命令插队。
RedisHelper封装
1、添加StackExchange.Redis引用
Install-Package StackExchange.Redis -Version 2.0.601
2、封装
using Microsoft.AspNetCore.DataProtection.KeyManagement;
using StackExchange.Redis;namespace Web.Common
{/// <summary>/// Redis 助手/// </summary>public static class RedisHelper{#region 获取Multiplexer实例:单例模式public static IConnectionMultiplexer ConnMultiplexerInstance{get{return _ConnectionMultiplexer;// 总是返回同一个实例 }}#endregion 其它#region private field/// <summary>/// 连接字符串/// </summary>private static readonly string ConnectionString;/// <summary>/// redis 连接对象:单例/// </summary>private static IConnectionMultiplexer _ConnectionMultiplexer;/// <summary>/// 默认的 Key 值(用来当作 RedisKey 的前缀)/// </summary>private static readonly string DefaultPrefix;/// <summary>/// 默认的超时时间(单位毫秒)/// </summary>private static readonly TimeSpan? DefaultTimeout;/// <summary>/// 默认库(0-15)/// </summary>private static readonly int DefaultDB;/// <summary>/// 锁/// </summary>private static readonly object Locker = new object();/ <summary>/ 数据库/ </summary>//private readonly IDatabase GetOperationDB(db);#endregion private field#region 构造函数static RedisHelper(){var configuration = new ConfigurationBuilder().SetBasePath(AppDomain.CurrentDomain.BaseDirectory).AddJsonFile("appsettings.json").Build();// 读取Redis连接字符串ConnectionString = configuration["Redis:Default:Connection"] ?? "127.0.0.1:6379";//var options = ConfigurationOptions.Parse(ConnectionString);//options.Password = null; //密码//_ConnectionMultiplexer=ConnectionMultiplexer.Connect(options);_ConnectionMultiplexer = ConnectionMultiplexer.Connect(ConnectionString);//默认Key的前缀DefaultPrefix = configuration["Redis:Default:DefaultPrefix"];//默认操作数据库:如果配置了默认库,则按配置的默认库,没有配置则默认库为0DefaultDB = configuration["Redis:Default:DefaultDB"] == null ? 0 : Convert.ToInt32(configuration["Redis:Default:DefaultDB"]);//键的默认过期时间:如果配置了过期时间,则按配置规则计算过期时间,没有配置则默认过期时间为7天DefaultTimeout = configuration["Redis:Default:DefaultTimeout"] != null ? TimeSpan.FromSeconds(Convert.ToInt32(configuration["Redis:Default:DefaultTimeout"])) : TimeSpan.FromSeconds(60);AddRegisterEvent();}/// <summary>/// 获取要操作的库/// </summary>/// <param name="db">库,0和-1都是第一个库,1是第二个库...</param>/// <returns></returns>private static IDatabase GetOperationDB(int? db){if (db == null){return ConnMultiplexerInstance.GetDatabase(DefaultDB);}else{return ConnMultiplexerInstance.GetDatabase(db.Value);}}#endregion 构造函数#region String 操作/// <summary>/// 设置 key 并保存字符串(如果 key 已存在,则覆盖值)/// </summary>/// <param name="redisKey">键</param>/// <param name="redisValue">值</param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool StringSet(string redisKey, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var exptime = GetRedisKeyExpireTime(expiry);return GetOperationDB(db).StringSet(redisKey, redisValue, exptime);}/// <summary>/// 保存多个 Key-value/// </summary>/// <param name="keyValuePairs">键</param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool StringSet(IEnumerable<KeyValuePair<string, string>> keyValuePairs, TimeSpan? expiry = null, string? prefix = null, int? db = null){var pairs = keyValuePairs.Select(x => new KeyValuePair<RedisKey, RedisValue>(AddKeyPrefix(x.Key, prefix), x.Value));var result = GetOperationDB(db).StringSet(pairs.ToArray());_ = keyValuePairs.Select(y => KeyExpire(y.Key, expiry, prefix, db));//设置key的过期时间return result;}/// <summary>/// 存储一个对象(该对象会被序列化保存)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool StringSet<T>(string key, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var exptime = GetRedisKeyExpireTime(expiry);try{var json = Serialize(redisValue);return GetOperationDB(db).StringSet(redisKey, json, exptime);}catch{return false;}}/// <summary>/// 获取字符串/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static string? StringGet(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).StringGet(redisKey);}/// <summary>/// 获取一个对象(会进行反序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static T? StringGet<T>(string redisKey, string? prefix = null, int? db = null){try{redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T>(GetOperationDB(db).StringGet(redisKey));}catch{return default;}}#region async/// <summary>/// 保存一个字符串值/// </summary>/// <param name="redisKey">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> StringSetAsync(string redisKey, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var exptime = GetRedisKeyExpireTime(expiry);return await GetOperationDB(db).StringSetAsync(redisKey, redisValue, exptime);}/// <summary>/// 保存一组字符串值/// </summary>/// <param name="keyValuePairs"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> StringSetAsync(IEnumerable<KeyValuePair<string, string>> keyValuePairs, TimeSpan? expiry = null, string? prefix = null, int? db = null){var pairs = keyValuePairs.Select(x => new KeyValuePair<RedisKey, RedisValue>(AddKeyPrefix(x.Key, prefix), x.Value));var result = await GetOperationDB(db).StringSetAsync(pairs.ToArray());_ = keyValuePairs.Select(y => KeyExpire(y.Key, expiry, prefix, db));//设置key的过期时间return result;}/// <summary>/// 存储一个对象(该对象会被序列化保存)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="redisValue">值</param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> StringSetAsync<T>(string redisKey, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){try{redisKey = AddKeyPrefix(redisKey, prefix);var json = Serialize(redisValue);var exptime = GetRedisKeyExpireTime(expiry);return await GetOperationDB(db).StringSetAsync(redisKey, json, exptime);}catch{return false;}}/// <summary>/// 获取单个值/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<string?> StringGetAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).StringGetAsync(redisKey);}/// <summary>/// 获取一个对象(会进行反序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<T?> StringGetAsync<T>(string redisKey, string? prefix = null, int? db = null){try{redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T>(await GetOperationDB(db).StringGetAsync(redisKey));}catch{return default;}}#endregion async#endregion String 操作#region Hash 操作/// <summary>/// 在 hash 设定值/// </summary>/// <param name="key">键</param>/// <param name="hashField"></param>/// <param name="value"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool HashSet(string key, string hashField, string value, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).HashSet(redisKey, hashField, value);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在 hash 中设定值/// </summary>/// <param name="key">键</param>/// <param name="hashFields"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>public static void HashSet(string key, IEnumerable<KeyValuePair<string, string>> hashFields, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var entries = hashFields.Select(x => new HashEntry(x.Key, x.Value));GetOperationDB(db).HashSet(redisKey, entries.ToArray());KeyExpire(key, expiry, prefix, db); //设置key的过期时间 }/// <summary>/// 在 hash 设定值(序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="hashField"></param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool HashSet<T>(string key, string hashField, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){try{var redisKey = AddKeyPrefix(key, prefix);var json = Serialize(redisValue);var result = GetOperationDB(db).HashSet(redisKey, hashField, json);KeyExpire(key, expiry, prefix, db);return result;}catch{return false;}}/// <summary>/// 在 hash 中获取值/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static string? HashGet(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).HashGet(redisKey, hashField);}/// <summary>/// 在 hash 中获取值/// </summary>/// <param name="redisKey">键</param>/// <param name="hashFields"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static IEnumerable<string?> HashGet(string redisKey, IEnumerable<string> hashFields, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var fields = hashFields.Select(x => (RedisValue)x);return ConvertStrings(GetOperationDB(db).HashGet(redisKey, fields.ToArray()));}/// <summary>/// 从 hash 返回所有的字段值/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static IEnumerable<string?> HashKeys(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(GetOperationDB(db).HashKeys(redisKey));}/// <summary>/// 返回 hash 中的所有值/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static IEnumerable<string?> HashValues(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(GetOperationDB(db).HashValues(redisKey));}/// <summary>/// 在 hash 中获取值(反序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static T? HashGet<T>(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T>(GetOperationDB(db).HashGet(redisKey, hashField));}/// <summary>/// 判断该字段是否存在 hash 中/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool HashExists(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).HashExists(redisKey, hashField);}/// <summary>/// 从 hash 中移除指定字段/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool HashDelete(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).HashDelete(redisKey, hashField);}/// <summary>/// 从 hash 中移除指定字段/// </summary>/// <param name="redisKey">键</param>/// <param name="hashFields"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>/// <exception cref="ArgumentNullException"></exception>public static long HashDelete(string redisKey, IEnumerable<string?> hashFields, string? prefix = null, int? db = null){if (hashFields is null){throw new ArgumentNullException(nameof(hashFields));}redisKey = AddKeyPrefix(redisKey, prefix);var fields = hashFields.Select(x => (RedisValue)x);return GetOperationDB(db).HashDelete(redisKey, fields.ToArray());}#region async/// <summary>/// 在 hash 设定值/// </summary>/// <param name="key">键</param>/// <param name="hashField"></param>/// <param name="value"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> HashSetAsync(string key, string hashField, string value, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result= await GetOperationDB(db).HashSetAsync(redisKey, hashField, value);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在 hash 中设定值/// </summary>/// <param name="key">键</param>/// <param name="hashFields"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task HashSetAsync(string key, IEnumerable<KeyValuePair<string, string>> hashFields, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var entries = hashFields.Select(x => new HashEntry(x.Key, x.Value));await GetOperationDB(db).HashSetAsync(redisKey, entries.ToArray());KeyExpire(key, expiry, prefix, db);}/// <summary>/// 在 hash 设定值(序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="hashField"></param>/// <param name="value"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> HashSetAsync<T>(string key, string hashField, T value, TimeSpan? expiry = null, string? prefix = null, int? db = null){try{var redisKey = AddKeyPrefix(key, prefix);var json = Serialize(value);var result = await GetOperationDB(db).HashSetAsync(redisKey, hashField, json);KeyExpire(key, expiry, prefix, db);return result;}catch{return false;}}/// <summary>/// 判断该字段是否存在 hash 中/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> HashExistsAsync(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).HashExistsAsync(redisKey, hashField);}/// <summary>/// 从 hash 中移除指定字段/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> HashDeleteAsync(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).HashDeleteAsync(redisKey, hashField);}/// <summary>/// 从 hash 中移除指定字段/// </summary>/// <param name="redisKey">键</param>/// <param name="hashFields"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> HashDeleteAsync(string redisKey, IEnumerable<string> hashFields, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var fields = hashFields.Select(x => (RedisValue)x);return await GetOperationDB(db).HashDeleteAsync(redisKey, fields.ToArray());}/// <summary>/// 在 hash 中获取值/// </summary>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<string?> HashGetAsync(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).HashGetAsync(redisKey, hashField);}/// <summary>/// 在 hash 中获取值/// </summary>/// <param name="redisKey">键</param>/// <param name="hashFields"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<IEnumerable<string?>> HashGetAsync(string redisKey, IEnumerable<string> hashFields, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var fields = hashFields.Select(x => (RedisValue)x);return ConvertStrings(await GetOperationDB(db).HashGetAsync(redisKey, fields.ToArray()));}/// <summary>/// 从 hash 返回所有的字段值/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<IEnumerable<string?>> HashKeysAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(await GetOperationDB(db).HashKeysAsync(redisKey));}/// <summary>/// 返回 hash 中的所有值/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<IEnumerable<string?>> HashValuesAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(await GetOperationDB(db).HashValuesAsync(redisKey));}/// <summary>/// 在 hash 中获取值(反序列化)/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="hashField"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<T?> HashGetAsync<T>(string redisKey, string hashField, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var result = await GetOperationDB(db).HashGetAsync(redisKey, hashField);return Deserialize<T>(result);}#endregion async#endregion Hash 操作#region List 操作/// <summary>/// 在列表头部插入值。如果键不存在,先创建再插入值/// </summary>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long ListLeftPush(string key, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).ListLeftPush(redisKey, redisValue);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表头部插入值。如果键不存在,先创建再插入值/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long ListLeftPush<T>(string key, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).ListLeftPush(redisKey, Serialize(redisValue));KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表尾部插入值。如果键不存在,先创建再插入值/// </summary>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long ListRightPush(string key, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);long result = GetOperationDB(db).ListRightPush(redisKey, redisValue);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表尾部插入值。如果键不存在,先创建再插入值/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns>push操作后列表的长度。</returns>public static long ListRightPush<T>(string key, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).ListRightPush(redisKey, Serialize(redisValue));KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 移除并返回存储在该键列表的第一个元素/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns>返回字符串</returns>public static string? ListLeftPop(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).ListLeftPop(redisKey);}/// <summary>/// 移除并返回存储在该键列表的第一个元素/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns>返回泛型对象</returns>public static T? ListLeftPop<T>(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T?>(GetOperationDB(db).ListLeftPop(redisKey));}/// <summary>/// 移除并返回存储在该键列表的最后一个元素/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static string? ListRightPop(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).ListRightPop(redisKey);}/// <summary>/// 移除并返回存储在该键列表的最后一个元素:/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns>返回泛型对象</returns>public static T? ListRightPop<T>(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T?>(GetOperationDB(db).ListRightPop(redisKey));}/// <summary>/// 移除列表指定键上与该值相同的元素/// </summary>/// <param name="redisKey">键</param>/// <param name="redisValue"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long ListRemove(string redisKey, string redisValue, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).ListRemove(redisKey, redisValue);}/// <summary>/// 返回列表上该键的长度,如果不存在,返回 0/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long ListLength(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).ListLength(redisKey);}/// <summary>/// 返回在该列表上键所对应的元素/// </summary>/// <param name="redisKey">键</param>/// <param name="start"></param>/// <param name="stop"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static IEnumerable<string?> ListRange(string redisKey, long start = 0L, long stop = -1L, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(GetOperationDB(db).ListRange(redisKey, start, stop));}#region List-async/// <summary>/// 在列表尾部插入值。如果键不存在,先创建再插入值/// </summary>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListRightPushAsync(string key, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = await GetOperationDB(db).ListRightPushAsync(redisKey, redisValue);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表头部插入值。如果键不存在,先创建再插入值/// </summary>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListLeftPushAsync(string key, string redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = await GetOperationDB(db).ListLeftPushAsync(redisKey, redisValue);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表头部插入值。如果键不存在,先创建再插入值/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListLeftPushAsync<T>(string key, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = await GetOperationDB(db).ListLeftPushAsync(redisKey, Serialize(redisValue));KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在列表尾部插入值。如果键不存在,先创建再插入值/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="redisValue"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListRightPushAsync<T>(string key, T redisValue, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = await GetOperationDB(db).ListRightPushAsync(redisKey, Serialize(redisValue));KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 移除并返回存储在该键列表的第一个元素/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<string?> ListLeftPopAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).ListLeftPopAsync(redisKey);}/// <summary>/// 移除并返回存储在该键列表的最后一个元素/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<string?> ListRightPopAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).ListRightPopAsync(redisKey);}/// <summary>/// 移除列表指定键上与该值相同的元素/// </summary>/// <param name="redisKey">键</param>/// <param name="redisValue"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListRemoveAsync(string redisKey, string redisValue, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).ListRemoveAsync(redisKey, redisValue);}/// <summary>/// 返回列表上该键的长度,如果不存在,返回 0/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> ListLengthAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).ListLengthAsync(redisKey);}/// <summary>/// 返回在该列表上键所对应的元素/// </summary>/// <param name="redisKey">键</param>/// <param name="start"></param>/// <param name="stop"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<IEnumerable<string>> ListRangeAsync(string redisKey, long start = 0L, long stop = -1L, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var query = await GetOperationDB(db).ListRangeAsync(redisKey, start, stop);return query.Select(x => x.ToString());}/// <summary>/// 移除并返回存储在该键列表的第一个元素/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<T?> ListLeftPopAsync<T>(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T?>(await GetOperationDB(db).ListLeftPopAsync(redisKey));}/// <summary>/// 移除并返回存储在该键列表的最后一个元素/// </summary>/// <typeparam name="T"></typeparam>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<T?> ListRightPopAsync<T>(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return Deserialize<T?>(await GetOperationDB(db).ListRightPopAsync(redisKey));}#endregion List-async#endregion List 操作#region SortedSet 操作/// <summary>/// SortedSet 新增/// </summary>/// <param name="redisKey">键</param>/// <param name="member"></param>/// <param name="score"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool SortedSetAdd(string key, string member, double score, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).SortedSetAdd(redisKey, member, score);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// SortedSet 新增/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="member"></param>/// <param name="score"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool SortedSetAdd<T>(string key, T member, double score, TimeSpan? expiry = null, string? prefix = null, int? db = null){try{var redisKey = AddKeyPrefix(key, prefix);var json = Serialize(member);var result = GetOperationDB(db).SortedSetAdd(redisKey, json, score);KeyExpire(key, expiry, prefix, db);return result;}catch{return false;}}/// <summary>/// 增量的得分排序的集合中的成员存储键值键按增量/// </summary>/// <param name="key">键</param>/// <param name="member"></param>/// <param name="value"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static double SortedSetIncrement(string key, string member, double value = 1, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).SortedSetIncrement(redisKey, member, value);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在有序集合中返回指定范围的元素,默认情况下从低到高。/// </summary>/// <param name="redisKey">键</param>/// <param name="start"></param>/// <param name="stop"></param>/// <param name="order"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static IEnumerable<string> SortedSetRangeByRank(string redisKey, long start = 0L, long stop = -1L, OrderType order = OrderType.Ascending, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).SortedSetRangeByRank(redisKey, start, stop, (Order)order).Select(x => x.ToString());}/// <summary>/// 返回有序集合的元素个数/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long SortedSetLength(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).SortedSetLength(redisKey);}/// <summary>/// 返回有序集合的元素个数/// </summary>/// <param name="redisKey">键</param>/// <param name="memebr"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool SortedSetLength(string redisKey, string memebr, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return GetOperationDB(db).SortedSetRemove(redisKey, memebr);}#region SortedSet-Async/// <summary>/// SortedSet 新增/// </summary>/// <param name="redisKey">键</param>/// <param name="member"></param>/// <param name="score"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> SortedSetAddAsync(string key, string member, double score, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = await GetOperationDB(db).SortedSetAddAsync(redisKey, member, score);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// SortedSet 新增/// </summary>/// <typeparam name="T"></typeparam>/// <param name="key">键</param>/// <param name="member"></param>/// <param name="score"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> SortedSetAddAsync<T>(string key, T member, double score, TimeSpan? expiry = null, string? prefix = null, int? db = null){try{var redisKey = AddKeyPrefix(key, prefix);var json = Serialize(member);var result = await GetOperationDB(db).SortedSetAddAsync(redisKey, json, score);KeyExpire(key, expiry, prefix, db);return result;}catch{return false;}}/// <summary>/// 增量的得分排序的集合中的成员存储键值键按增量/// </summary>/// <param name="key">键</param>/// <param name="member"></param>/// <param name="value"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static Task<double> SortedSetIncrementAsync(string key, string member, double value = 1, TimeSpan? expiry = null, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);var result = GetOperationDB(db).SortedSetIncrementAsync(redisKey, member, value);KeyExpire(key, expiry, prefix, db);return result;}/// <summary>/// 在有序集合中返回指定范围的元素,默认情况下从低到高。/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<IEnumerable<string?>> SortedSetRangeByRankAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return ConvertStrings(await GetOperationDB(db).SortedSetRangeByRankAsync(redisKey));}/// <summary>/// 返回有序集合的元素个数/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> SortedSetLengthAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).SortedSetLengthAsync(redisKey);}/// <summary>/// 返回有序集合的元素个数/// </summary>/// <param name="redisKey">键</param>/// <param name="memebr"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> SortedSetRemoveAsync(string redisKey, string memebr, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).SortedSetRemoveAsync(redisKey, memebr);}#endregion SortedSet-Async#endregion SortedSet 操作#region key 操作/// <summary>/// 移除指定 Key/// </summary>/// <param name="key">不带前缀的键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool KeyDelete(string key, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);return GetOperationDB(db).KeyDelete(redisKey);}/// <summary>/// 移除指定 Key/// </summary>/// <param name="redisKeys"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static long KeyDelete(IEnumerable<string> redisKeys, string? prefix = null, int? db = null){var keys = redisKeys.Select(key => (RedisKey)AddKeyPrefix(key, prefix));return GetOperationDB(db).KeyDelete(keys.ToArray());}/// <summary>/// 校验 Key 是否存在/// </summary>/// <param name="key">不带前缀的键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool KeyExists(string key, string? prefix = null, int? db = null){var redisKey = AddKeyPrefix(key, prefix);return GetOperationDB(db).KeyExists(redisKey);}/// <summary>/// 重命名 Key/// </summary>/// <param name="oldKey">不带前缀的键</param>/// <param name="newKey">新的不带前缀的键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool KeyRename(string oldKey, string newKey, string? prefix = null, int? db = null){var redisOldKey = AddKeyPrefix(oldKey, prefix);var redisNewKey = AddKeyPrefix(newKey, prefix);return GetOperationDB(db).KeyRename(redisOldKey, redisNewKey);}/// <summary>/// 设置 Key 的过期时间/// </summary>/// <param name="redisKey">键</param>/// <param name="expiry"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static bool KeyExpire(string redisKey, TimeSpan? expiry, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var exptime = GetRedisKeyExpireTime(expiry);return GetOperationDB(db).KeyExpire(redisKey, exptime);}#region key-async/// <summary>/// 移除指定 Key/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> KeyDeleteAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).KeyDeleteAsync(redisKey);}/// <summary>/// 移除指定 Key/// </summary>/// <param name="redisKeys"></param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<long> KeyDeleteAsync(IEnumerable<string> redisKeys, string? prefix = null, int? db = null){var keys = redisKeys.Select(key => (RedisKey)AddKeyPrefix(key, prefix));return await GetOperationDB(db).KeyDeleteAsync(keys.ToArray());}/// <summary>/// 校验 Key 是否存在/// </summary>/// <param name="redisKey">键</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> KeyExistsAsync(string redisKey, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);return await GetOperationDB(db).KeyExistsAsync(redisKey);}/// <summary>/// 重命名 Key/// </summary>/// <param name="oldKey">待重命名的键名称</param>/// <param name="newKey">新的键名称</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> KeyRenameAsync(string oldKey, string newKey, string? prefix = null, int? db = null){ var redisOldKey = AddKeyPrefix(oldKey, prefix);var redisNewKey = AddKeyPrefix(newKey, prefix);return await GetOperationDB(db).KeyRenameAsync(redisOldKey, redisNewKey);}/// <summary>/// 设置 Key 的过期时间(单位:毫秒)/// </summary>/// <param name="redisKey">键</param>/// <param name="expiry"></param>/// <param name="expiry">过期时间:为Null表示使用appsettings.json配置文件中DefaultTimeout节点的值.如未指定该值且未设置DefaultTimeout则默认库为7天</param>/// <param name="prefix">键的前缀:为Null表示使用appsettings.json配置文件中DefaultPrefix节点的值</param>/// <param name="db">库(0-15):为Null表示使用appsettings.json配置文件中DefaultDB节点的值.如未指定该值且未设置DefaultDB则默认库为0</param>/// <returns></returns>public static async Task<bool> KeyExpireAsync(string redisKey, TimeSpan? expiry, string? prefix = null, int? db = null){redisKey = AddKeyPrefix(redisKey, prefix);var exptime = GetRedisKeyExpireTime(expiry);return await GetOperationDB(db).KeyExpireAsync(redisKey, exptime);}#endregion key-async#endregion key 操作#region private method/// <summary>/// 添加 Key 的前缀/// </summary>/// <param name="key">键</param>/// <param name="prefix">Key 的前缀:如果为空则为appsettings.json中配置节点中的默认前缀DefaultPrefix</param>/// <returns></returns>private static string AddKeyPrefix(string key, string? prefix){if (string.IsNullOrEmpty(prefix) && string.IsNullOrEmpty(DefaultPrefix)){return key;}return prefix ?? DefaultPrefix + ":" + key;}/// <summary>/// 键的过期时间/// </summary>/// <param name="time">过期时间</param>/// <returns></returns>private static TimeSpan? GetRedisKeyExpireTime(TimeSpan? time){if (time == null && DefaultTimeout == null){return TimeSpan.Zero;}else{return time ?? DefaultTimeout;}}/// <summary>/// 转换为字符串/// </summary>/// <typeparam name="T"></typeparam>/// <param name="list"></param>/// <returns></returns>private static IEnumerable<string?> ConvertStrings<T>(IEnumerable<T> list) where T : struct{if (list == null) throw new ArgumentNullException(nameof(list));return list.Select(x => x.ToString());}#region 注册事件/// <summary>/// 添加注册事件/// </summary>private static void AddRegisterEvent(){_ConnectionMultiplexer.ConnectionRestored += ConnMultiplexer_ConnectionRestored;_ConnectionMultiplexer.ConnectionFailed += ConnMultiplexer_ConnectionFailed;_ConnectionMultiplexer.ErrorMessage += ConnMultiplexer_ErrorMessage;_ConnectionMultiplexer.ConfigurationChanged += ConnMultiplexer_ConfigurationChanged;_ConnectionMultiplexer.HashSlotMoved += ConnMultiplexer_HashSlotMoved;_ConnectionMultiplexer.InternalError += ConnMultiplexer_InternalError;_ConnectionMultiplexer.ConfigurationChangedBroadcast += ConnMultiplexer_ConfigurationChangedBroadcast;}/// <summary>/// 重新配置广播时(通常意味着主从同步更改)/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_ConfigurationChangedBroadcast(object sender, EndPointEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_ConfigurationChangedBroadcast)}: {e.EndPoint}");}/// <summary>/// 发生内部错误时(主要用于调试)/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_InternalError(object sender, InternalErrorEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_InternalError)}: {e.Exception}");}/// <summary>/// 更改集群时/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_HashSlotMoved(object sender, HashSlotMovedEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_HashSlotMoved)}: {nameof(e.OldEndPoint)}-{e.OldEndPoint} To {nameof(e.NewEndPoint)}-{e.NewEndPoint}, ");}/// <summary>/// 配置更改时/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_ConfigurationChanged(object sender, EndPointEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_ConfigurationChanged)}: {e.EndPoint}");}/// <summary>/// 发生错误时/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_ErrorMessage(object sender, RedisErrorEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_ErrorMessage)}: {e.Message}");}/// <summary>/// 物理连接失败时/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_ConnectionFailed(object sender, ConnectionFailedEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_ConnectionFailed)}: {e.Exception}");}/// <summary>/// 建立物理连接时/// </summary>/// <param name="sender"></param>/// <param name="e"></param>private static void ConnMultiplexer_ConnectionRestored(object sender, ConnectionFailedEventArgs e){Console.WriteLine($"{nameof(ConnMultiplexer_ConnectionRestored)}: {e.Exception}");}#endregion 注册事件/// <summary>/// 序列化/// </summary>/// <param name="obj"></param>/// <returns></returns>private static byte[]? Serialize(object? obj){if (obj == null) return null;return System.Text.Json.JsonSerializer.SerializeToUtf8Bytes(obj);}/// <summary>/// 反序列化/// </summary>/// <typeparam name="T"></typeparam>/// <param name="data"></param>/// <returns></returns>private static T? Deserialize<T>(byte[]? data){if (data == null) return default;return System.Text.Json.JsonSerializer.Deserialize<T>(data);}/// <summary>/// 排序枚举/// </summary>public enum OrderType{/// <summary>/// 升序/// </summary>Ascending,/// <summary>/// 降序/// </summary>Descending}#endregion private method}
}
配置文件
在下面这个示例中,我们使用了Sentinel
部分来配置Redis哨兵模式。你需要指定MasterName
,这是你要连接的Redis主服务器的名称。然后,你需要提供一个Sentinels
数组,其中包含哨兵节点的主机和端口信息。在示例中,我们使用了三个哨兵节点,但你可以根据实际情况进行更改。
{//"RedisConnectionStrings": "127.0.0.1:6379,password=,defaultDatabase=0,connectTimeout=5000,syncTimeout=1000","Redis": {"Host": "127.0.0.1","Port": 6379,"Password": "", //密码"Database": 0, //默认库"DefaultPrefix": "slxt", //键的默认前缀"DefaultTimeout": 604800, //键的默认超时时间 单位:秒//"ConnectionMultiplexer": "StackExchange.Redis", //Redis使用的客户端实例:如StackExchange.Redis和CsRedis客户端一般我们不需要//哨兵模式"Sentinel": {"MasterName": "mymaster","Sentinels": [{"Host": "127.0.0.1","Port": 26379},{"Host": "127.0.0.1","Port": 26380},{"Host": "127.0.0.1","Port": 26381}]}}
}