RedisRepository分享和纠错

自用RedisRepository分享和纠错，本文版权归博客园和作者吴双本人共同所有，转载和爬虫必须注明原文地址:www.cnblogs.com/tdws 。

一.   写在前面

毕业工作后，今天终于能回家了，回想了一些这半年来所做的内容，总是觉得还停留在那么基础的水平 ，在解决各种问题的过程中，自己的创新思路比较少，靠搜索来的比较多 。不想做16年的总结了 ，希望17年能学更多的我爱的技术，看更多的开源代码，能学到更多的设计思想和代码思路，能再更新这两年来对代码的理解。

这篇分享，主要是弥补我之前RedisRepository的不足。如果对Redis基础有疑问，可移步http://www.cnblogs.com/tdws/tag/NoSql/   .

半年前由于我StackExchange.Redis文档阅读不足，所分享的RedisRepository有所错误。下面列举我的主要错误：

错误1，没有单例化ConnectionMultiplexer Redis连接对象，并且我天真的以为给单例对象加锁，在并发情况下，会限制了Redis的性能。

错误2，在主从情况下，我以为在发生手动切换的时候，我们要订阅切换事件，并在事件发生后，动态改变连接对象指向的Endpoint。

当我再一次仔细阅读文档时，才明白我的错误，这是一篇迟到的修正，但是我自用的repository自我感觉还是有很多不足之处，所以我真的需要老司机的指点和建议。

修正1，Redis连接对象创建的代价很大，并且单例加锁并不会影响Redis性能，因为在发生网络请求的期间，连接对象并没有在等待中。

修正2，Redis主从时，在哨兵切换主从关系后，StackExchange.Redis会为我们识别新的主从，不需要我们做任何操作。

目前为止我还有两个疑问。

疑问1，在看文档后没有明确结果。当做主从读写分离时,  我们在Endpoint Collection集合中添加多个节点就会自动读写分离？还是说需要 我们在读取命令的方法中指定CommandFlags.PreferSlave？  我认为是后者吧？所以我在我所有的读取方法都指定了PreferSlave。    老司机们怎么说？

疑问2，我使用LuaScript.Prepare(lua)后再Load出来，执行lua总是无效果，并且LuaScript.GetCachedScriptCount()为0. 不过我直接使用ScriptEvaluateAsync却是好用的，老司机如果有好的例子，希望老司机给些指导或者分享。

二.   概念上有必要加强一下

StackExchange.Redis客户端所提供的功能，绝不是使用Socket连接下，用socket对象send点数据，recv点数据这么简单。也不是说创建包含几个redis socket连接的连接池那么容易，StackExchange的目标在于管道处理和多路复用。关于连接数量的多少，可能是一个也可能是一个连接池，在于我们如何使用，可以参考老外这篇文章https://frankdecaire.blogspot.jp/2016/03/stack-exchange-redis-connection-pooling.html  ，相反的如果没有管道和多路复用的思想，由于socket面向有连接的协议时，send和recv都是阻塞的，他们在System.Net.Socket实现的内部调用了win32 API WSARecv和WSASend。连续的200个send recv对，最后一个命令就要在前面199个send&recv执行结束后发送到redis。所以有了StackExchange.Redis 我们不必把所有的时间都浪费在客户端到服务端以及服务端到客户端的等待上。当不同调用方同一时刻访问时，StackExchange客户端会自动使用管道分离访问请求，因此无论使用阻塞还是异步的访问方式，这些工作都是被管道处理的。从本质上讲，它填补了 waiting 时间与其他调用方的工作。

三.   代码结构，仅供参考

结构大概就是这样，RedisAsyncHelper下的所有类都是部分类，他们的类名称是RedisHelper。他们共同实现了IRedisHelper的接口，并且留下了详细的注释。

同步版本和异步版本的目录结构是一样的。所以我仅分享下Async版本，如果对Async有疑问可移步 http://www.cnblogs.com/tdws/p/6172207.html。

四.   预备阶段

CommonHelper中的两个帮助类：

RedisInnerTypeHelper.cs

 using StackExchange.Redis;
 using System.Collections.Generic;
 using System.Linq;

 namespace Fantasy.RedisRepository.CommonHelper
 {
     internal class RedisInnerTypeHelper
     {
         public static List<T> RedisValuesToGenericList<T>(RedisValue[] redisValues)
         {
             var result = new List<T>();
             redisValues.ToList().ForEach(r => result.Add(SerializeHelper.Deserialize<T>(r)));
             return result;
         }

         public static RedisValue[] GenericListToRedisValues<T>(List<T> values)
         {
             var redisValues = new List<RedisValue>();
             values.ForEach(v => redisValues.Add(SerializeHelper.Serialize(values)));
             return redisValues.ToArray();
         }

         public static RedisKey[] GenericListToRedisKeys(List<string> keys)
         {
             var redisKeys = new List<RedisKey>();
             keys.ForEach(k => redisKeys.Add(k));
             return redisKeys.ToArray();
         }
     }
 }

SerializeHelper.cs

 using System.IO;
 using System.Runtime.Serialization.Formatters.Binary;

 namespace Fantasy.RedisRepository.CommonHelper
 {
     internal static class SerializeHelper
     {
         /// <summary>
         /// 字节数组序列化
         /// </summary>
         /// <param name="o"></param>
         /// <returns></returns>
         internal static byte[] Serialize(object o)
         {
             if (o == null)
             {
                 return null;
             }

             BinaryFormatter binaryFormatter = new BinaryFormatter();
             using (MemoryStream memoryStream = new MemoryStream())
             {
                 binaryFormatter.Serialize(memoryStream, o);
                 byte[] objectDataAsStream = memoryStream.ToArray();
                 return objectDataAsStream;
             }
         }

         /// <summary>
         /// 字节数组反序列化
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="stream"></param>
         /// <returns></returns>
         internal static T Deserialize<T>(byte[] stream)
         {
             if (stream == null)
             {
                 return default(T);
             }

             BinaryFormatter binaryFormatter = new BinaryFormatter();
             using (MemoryStream memoryStream = new MemoryStream(stream))
             {
                 T result = (T)binaryFormatter.Deserialize(memoryStream);
                 return result;
             }
         }
     }
 }

Config中的配置类：

ConfigHelper.cs

 using System;
 using System.Configuration;

 namespace Fantasy.RedisRepository.Config
 {
     internal class ConfigHelper
     {
         internal static T Get<T>(string appSettingsKey, T defaultValue)
         {
             string text = ConfigurationManager.AppSettings[appSettingsKey];
             if (string.IsNullOrWhiteSpace(text))
                 return defaultValue;
             try
             {
                 var value = Convert.ChangeType(text, typeof(T));
                 return (T)value;
             }
             catch
             {
                 return defaultValue;
             }
         }
     }
 }

RedisClientConfig.cs

 namespace Fantasy.RedisRepository.Config
 {
     internal class RedisClientConfig
     {

         private static string _server = ConfigHelper.Get("RedisServer", "115.xx.xx.31");
         /// <summary>
         /// 节点IP
         /// </summary>
         public static string Server
         {
             get { return _server; }
             set { _server = value; }
         }

         private static int _port = ConfigHelper.Get("RedisPort", );
         /// <summary>
         /// 节点端口
         /// </summary>
         public static int Port
         {
             get { return _port; }
             set { _port = value; }
         }

         private static string _slaveServer = ConfigHelper.Get("SlaveServer", "115.xx.xx.31");
         /// <summary>
         /// 节点IP
         /// </summary>
         public static string SlaveServer
         {
             get { return _slaveServer; }
             set { _slaveServer = value; }
         }

         private static int _slavePort = ConfigHelper.Get("SlavePort", );
         /// <summary>
         /// 节点端口
         /// </summary>
         public static int SlavePort
         {
             get { return _slavePort; }
             set { _slavePort = value; }
         }

         private static string _auth = ConfigHelper.Get("RedisAuth", "fantasy..");
         /// <summary>
         /// 节点密码
         /// </summary>
         public static string RedisAuth
         {
             get { return _auth; }
             set { _auth = value; }
         }

         private static int _defaultDatabase = ConfigHelper.Get("RedisDataBase", );
         /// <summary>
         /// redis默认0号库
         /// </summary>
         public static int DefaultDatabase
         {
             get { return _defaultDatabase; }
             set { _defaultDatabase = value; }
         }

         private static int _connectTimeout = ;
         public static int ConnectTimeout
         {
             get { return _connectTimeout; }
             set { _connectTimeout = value; }
         }

         private static int _connectRetry = ;
         public static int ConnectRetry
         {
             get { return _connectRetry; }
             set { _connectRetry = value; }
         }

         private static bool _preserveAsyncOrder = false;
         public static bool PreserveAsyncOrder
         {
             get { return _preserveAsyncOrder; }
             set { _preserveAsyncOrder = value; }
         }
     }
 }

RedisConnection.cs

 using Fantasy.RedisRepository.Config;
 using StackExchange.Redis;

 namespace Fantasy.RedisRepository
 {
     /// <summary>
     /// Redis连接类
     /// </summary>
     public static class RedisConnection
     {
         private static ConnectionMultiplexer _connection;
         private static readonly object SyncObject = new object();
         /// <summary>
         /// redis连接对象，单例加锁不影响性能
         /// </summary>
         public static ConnectionMultiplexer GenerateConnection
         {
             get
             {
                 if (_connection == null || !_connection.IsConnected)
                 {
                     lock (SyncObject)
                     {
                         var configurationOptions = new ConfigurationOptions()
                         {
                             Password = RedisClientConfig.RedisAuth,
                             EndPoints =
                             {
                                 {RedisClientConfig.Server, RedisClientConfig.Port},
                                 {RedisClientConfig.SlaveServer, RedisClientConfig.SlavePort}
                             }
                         };
                         _connection = ConnectionMultiplexer.Connect(configurationOptions);
                     }
                 }
                 return _connection;
             }
         }
     }
 }

五.   RedisHelper

实际上就是做了层序列化包装而已。

IRedisHelper：

using System;
using StackExchange.Redis;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace Fantasy.RedisRepository.RedisHelpers
{
    /// <summary>
    /// 异步方法接口     --Author 吴双 www.cnblogs.com/tdws
    /// 存入数据均为方法内部序列化后的byte,所以取数据的时候需要反序列化时，请指定正确的数据类型
    /// </summary>
    public partial interface IRedisHelper
    {
        #region Redis数据类型—String 

        /// <summary>
        /// 将任何数据以redis string存储
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <param name="timeout"></param>
        /// <returns></returns>
        Task<bool> StringSetAsync<T>(string key, T value, TimeSpan? timeout = null);

        /// <summary>
        /// 对数值进行减法操作，默认-1
        /// </summary>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns>操作后的结果</returns>
        Task<long> StringDecrementAsync(string key, long value = 1L);

        /// <summary>
        /// 对数值进行加法操作，默认+1
        /// </summary>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns>操作后的结果</returns>
        Task<long> StringIncrementAsync(string key, long value = 1L);

        /// <summary>
        /// 从redis string中以指定类型取出
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<T> StringGetAsync<T>(string key);

        #endregion

        #region Redis数据类型—Hash

        /// <summary>
        /// 向Hash key中存储任意类型任意值
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <param name="value"></param>
        /// <returns>是否成功</returns>
        Task<bool> HashSetAsync<T>(string key, string field, T value);

        /// <summary>
        /// 批量 向Hash key中存储任意类型任意值
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="hashFields"></param>
        /// <returns>无返回值</returns>
        Task HashMultiSetAsync<T>(string key, Dictionary<string, T> hashFields);

        /// <summary>
        /// 对指定hash key中制定field做数量增加操作 默认自增1
        /// 如果此操作前key不存在 则创建。 如果此操作前该field不存在或者非数字 则先被置0，再被继续操作
        /// </summary>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <param name="incrCount"></param>
        /// <returns>操作后的结果</returns>
        Task<long> HashIncrementAsync(string key, string field, long incrCount = );

        /// <summary>
        /// 对指定hash key中制定field做数量增加操作 默认自减1
        /// 如果此操作前key不存在 则创建。 如果此操作前该field不存在或者非数字 则先被置0，再被继续操作
        /// </summary>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <param name="decrCount"></param>
        /// <returns>操作后的结果</returns>
        Task<long> HashDecrementAsync(string key, string field, long decrCount = );

        /// <summary>
        /// 从指定Hash中 删除指定field
        /// 如果key或者field不存在，则false
        /// </summary>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <returns>是否成功</returns>
        Task<bool> HashDeleteFieldAsync(string key, string field);

        /// <summary>
        /// 从指定Hash key中 批量删除指定field
        /// 如果key或者field不存在，则false
        /// </summary>
        /// <param name="key"></param>
        /// <param name="fields"></param>
        /// <returns>移除数量</returns>
        Task<long> HashMultiDeleteFieldAsync(string key, List<string> fields);

        /// <summary>
        /// 从指定Hash key中获取指定field值
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <returns></returns>
        Task<T> HashGetAsync<T>(string key, string field);

        /// <summary>
        /// 从指定Hash key中判断field是否存在
        /// </summary>
        /// <param name="key"></param>
        /// <param name="field"></param>
        /// <returns></returns>
        Task<bool> HashFieldExistAsync(string key, string field);

        /// <summary>
        /// 获取指定Hash key中的所有field的值
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<List<T>> HashValuesAsync<T>(string key);

        /// <summary>
        /// 获取指定Hash key中所有 field名称及其Value
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<Dictionary<string, T>> HashGetAllAsync<T>(string key);

        /// <summary>
        /// 获取指定Hash key中所有field
        /// </summary>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<List<string>> HashFieldsAsync(string key);

        #endregion

        #region Redis数据类型—List     

        /// <summary>
        /// 在指定pivot后插入value, 如果pivot不存在，则返回-1, 如果key不存在，则返回0
        /// 如果存在多个相同指定的的pivot,则插入第一个指定pivot后面.
        /// 即链表从左向右查找，遇到指定pivot，则确定位置
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="pivot">list中的一个值</param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<long> ListInsertAfterAsync<T>(string key, string pivot, T value);

        /// <summary>
        /// 在指定pivot前插入value, 如果pivot不存在，则返回-1, 如果key不存在，则返回0
        /// 如果存在多个相同指定的的pivot,则插入第一个指定pivot前面.
        /// 即链表从左向右查找，遇到指定pivot，则确定位置
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="pivot"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<long> ListInsertBeforeAsync<T>(string key, string pivot, T value);

        /// <summary>
        /// 从链表左侧弹出第一个元素（弹出能获取到该元素并且被删除）
        /// 如果key不存在 或者链表为空 则为null
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<T> ListLeftPopAsync<T>(string key);

        /// <summary>
        /// 从链表左侧增加一个元素,key不存在则被创建
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns>返回操作后的链表长度</returns>
        Task<long> ListLeftPushAsync<T>(string key, T value);

        /// <summary>
        /// 从链表左侧批量增加元素，如果 a b c  则c会在链表左侧第一位  b第二位  a第三位
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="values"></param>
        /// <returns>返回操作后的链表长度</returns>
        Task<long> ListLeftMultiPushAsync<T>(string key, List<T> values);

        /// <summary>
        /// 获取链表长度，不存在key则为0
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<long> ListLengthAsync<T>(string key);

        /// <summary>
        /// 获取链表中所有数据，从左侧start开始到stop结束，从0—-1则认为获取全部，默认获取全部
        /// start为负数则代表从链表右侧开始，-1为右侧第一位，-2为右侧第二位
        /// start要小于stop,否则返回null
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="start"></param>
        /// <param name="stop"></param>
        /// <returns></returns>
        Task<List<T>> ListRangeAsync<T>(string key, long start = 0L, long stop = -1L);

        /// <summary>
        /// 从链表中一处count数量的value. count大于0则从左至右，count小于0则从右至左，count=0则移除全部
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <param name="count"></param>
        /// <returns></returns>
        Task<long> ListRemoveAsync<T>(string key, T value, long count = 0L);

        /// <summary>
        /// 从右侧弹出第一个元素（弹出能获取到该元素并且被删除）
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<T> ListRightPopAsync<T>(string key);

        /// <summary>
        /// 从链表右侧加入元素，如果 rpush a b c 则c为右侧第一位 b第二位 c第三位
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<long> ListRightPushAsync<T>(string key, T value);

        /// <summary>
        /// 从右侧批量插入，和左侧相反
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="values"></param>
        /// <returns></returns>
        Task<long> ListRightMultiPushAsync<T>(string key, List<T> values);

        /// <summary>
        /// 在链表指定索引处，插入元素
        /// 正数索引从0开始，代表左侧。负数从-1开始 代表从右侧。-1为右侧第一位
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="index"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task ListSetByIndexAsync<T>(string key, int index, T value);

        /// <summary>
        /// 留下start到stop之间的数据。负数代表从右侧寻找  -1为右侧第一位
        /// </summary>
        /// <param name="key"></param>
        /// <param name="start"></param>
        /// <param name="stop"></param>
        /// <returns></returns>
        Task ListTrimAsync(string key, long start, long stop);

        /// <summary>
        /// 获取指定index的值，负数代表从右侧寻找  -1为右侧第一位
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="index"></param>
        /// <returns></returns>
        Task<T> ListGetByIndexAsync<T>(string key, long index);

        #endregion

        #region Redis数据类型—Set

        /// <summary>
        /// 向指定集合中增加一个元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<bool> SetAddAsync<T>(string key, T value);

        /// <summary>
        /// 指定集合计算操作operation枚举，指定计算结果将存的目标destKey，指定需要参与计算的多个key
        /// </summary>
        /// <param name="operation"></param>
        /// <param name="destKey"></param>
        /// <param name="combineKeys"></param>
        /// <returns></returns>
        Task<long> SetCombineAndStoreAsync(SetOperation operation, string destKey, List<string> combineKeys);

        /// <summary>
        /// 指定集合计算操作operation枚举，指定需要参与计算的多个key
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="operation"></param>
        /// <param name="combineKeys"></param>
        /// <returns></returns>
        Task<List<T>> SetCombineAsync<T>(SetOperation operation, List<string> combineKeys);

        /// <summary>
        /// 指定值是否存在于指定集合中
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<bool> SetContainsAsync<T>(string key, T value);

        /// <summary>
        /// 获取指定集合中元素个数
        /// </summary>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<long> SetLengthAsync(string key);

        /// <summary>
        /// 获取指定集合中的所有元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<List<T>> SetMembersAsync<T>(string key, T value);

        /// <summary>
        /// 从sourceKey移除指定value到目标distKey集合当中
        /// 如果sourceKey存在指定value则返回true，否则不做任何操作返回false
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="sourcekey"></param>
        /// <param name="distKey"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<bool> SetMoveAsync<T>(string sourcekey, string distKey, T value);

        /// <summary>
        /// 从指定集合当中随机取出一个元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<T> SetRandomMemberAsync<T>(string key);

        /// <summary>
        /// 从指定集合随机弹出（删除并获取）一个元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<T> SetPopAsync<T>(string key);

        /// <summary>
        /// 从集合中随机弹出（删除并获取）多个元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<List<T>> SetRandomMembersAsync<T>(string key);

        /// <summary>
        /// 从集合中移除指定元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="value"></param>
        /// <returns></returns>
        Task<bool> SetRemoveAsync<T>(string key, T value);

        /// <summary>
        /// 从集合中批量移除元素
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="key"></param>
        /// <param name="values"></param>
        /// <returns></returns>
        Task<long> SetMultiRemoveAsync<T>(string key, List<T> values);

        #endregion

        #region Redis数据类型—SortSet

        #endregion

        #region Redis Key操作

        /// <summary>
        /// 删除指定key
        /// </summary>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<bool> KeyDeleteAsync(string key);

        /// <summary>
        /// 设置key过期时间具体DateTime
        /// </summary>
        /// <param name="key"></param>
        /// <param name="expireAt"></param>
        /// <returns></returns>
        Task<bool> KeyExpireAtAsync(string key, DateTime expireAt);

        /// <summary>
        /// 设置key在将来的timeout后过期（TimeSpan）
        /// </summary>
        /// <param name="key"></param>
        /// <param name="timeout"></param>
        /// <returns></returns>
        Task<bool> KeyExpireInAsync(string key, TimeSpan timeout);

        /// <summary>
        /// key重命名
        /// </summary>
        /// <param name="key"></param>
        /// <param name="newKey"></param>
        /// <returns></returns>
        Task<bool> KeyRenameAsync(string key, string newKey);

        /// <summary>
        /// 判断key是否已存在
        /// </summary>
        /// <param name="key"></param>
        /// <returns></returns>
        Task<bool> KeyExistsAsync(string key);

        #endregion

        #region Redis Transcation

        /// <summary>
        /// 在事务中执行一系列redis命令。注意：在委托中的一系列命令的所有 值  都需要进行字节数组序列化
        /// </summary>
        /// <param name="ranOperations"></param>
        /// <returns></returns>
        Task<bool> DoInTranscationAsync(Action<ITransaction> ranOperations);

        #endregion

        Task<RedisResult> Test();
    }
}

RedisHelper部分类RedisStringHelperAsync.cs

 using System;
 using Fantasy.RedisRepository.CommonHelper;
 using StackExchange.Redis;
 using System.Threading.Tasks;

 namespace Fantasy.RedisRepository.RedisHelpers
 {
     /// <summary>
     /// Redis异步操作类  String部分类
     /// </summary>
     internal partial class RedisHelper// : IRedisHelper
     {

         private static IDatabase _client;

         internal RedisHelper()
         {
             _client = RedisConnection.GenerateConnection.GetDatabase();
         }

         #region String 写操作

         /// <summary>
         ///  将任何数据添加到redis中
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="key"></param>
         /// <param name="value"></param>
         /// <param name="timeout"></param>
         /// <returns></returns>
         public async Task<bool> StringSetAsync<T>(string key, T value, TimeSpan? timeout = null)
         {
             return await _client.StringSetAsync(key, SerializeHelper.Serialize(value), timeout);
         }

         public async Task<long> StringDecrementAsync(string key, long value = 1L)
         {
             return await _client.StringDecrementAsync(key, value);
         }

         public async Task<long> StringIncrementAsync(string key, long value = 1L)
         {
             return await _client.StringIncrementAsync(key, value);
         }
         #endregion

         #region String 读操作

         /// <summary>
         /// 根据key获取指定类型数据
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="key"></param>
         /// <returns></returns>
         public async Task<T> StringGetAsync<T>(string key)
         {
             return SerializeHelper.Deserialize<T>(await _client.StringGetAsync(key, CommandFlags.PreferSlave));
         }

         #endregion

     }
 }

RedisHelper部分类RedisHashHelperAsync.cs

 using Fantasy.RedisRepository.CommonHelper;
 using StackExchange.Redis;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;

 namespace Fantasy.RedisRepository.RedisHelpers
 {
     /// <summary>
     ///  Redis异步操作类  Hash部分类
     /// </summary>
     internal partial class RedisHelper
     {
         #region Hash 写操作

         public async Task<bool> HashSetAsync<T>(string key, string field, T value)
         {
             return await _client.HashSetAsync(key, field, SerializeHelper.Serialize(value));
         }

         public async Task HashMultiSetAsync<T>(string key, Dictionary<string, T> hashFields)
         {
             List<HashEntry> entries = new List<HashEntry>();
             hashFields.ToList().ForEach(d => entries.Add(new HashEntry(d.Key, SerializeHelper.Serialize(d.Value))));
             await _client.HashSetAsync(key, entries.ToArray());
         }

         public async Task<long> HashIncrementAsync(string key, string field, long incrCount = )
         {
             return await _client.HashIncrementAsync(key, field, incrCount);
         }

         public async Task<long> HashDecrementAsync(string key, string field, long decrCount = )
         {
             return await _client.HashDecrementAsync(key, field, decrCount);
         }

         public async Task<bool> HashDeleteFieldAsync(string key, string field)
         {
             return await _client.HashDeleteAsync(key, field);
         }

         public async Task<long> HashMultiDeleteFieldAsync(string key, List<string> fields)
         {
             List<RedisValue> values = new List<RedisValue>();
             fields.ForEach(f => values.Add(f));
             return await _client.HashDeleteAsync(key, values.ToArray());
         }

         #endregion

         #region Hash 读操作

         /// <summary>
         /// Redis 指定hash类型key中field是否存在
         /// </summary>
         /// <param name="key"></param>
         /// <param name="field"></param>
         /// <returns></returns>
         public async Task<bool> HashFieldExistAsync(string key, string field)
         {
             return await _client.HashExistsAsync(key, field, CommandFlags.PreferSlave);
         }
         public async Task<List<string>> HashFieldsAsync(string key)
         {
             RedisValue[] values = await _client.HashKeysAsync(key, CommandFlags.PreferSlave);
             return RedisInnerTypeHelper.RedisValuesToGenericList<string>(values);
         }
         public async Task<List<T>> HashValuesAsync<T>(string key)
         {
             var values = await _client.HashValuesAsync(key, CommandFlags.PreferSlave);
             return RedisInnerTypeHelper.RedisValuesToGenericList<T>(values);
         }

         public async Task<T> HashGetAsync<T>(string key, string field)
         {
             return SerializeHelper.Deserialize<T>(await _client.HashGetAsync(key, field, CommandFlags.PreferSlave));
         }

         public async Task<Dictionary<string, T>> HashGetAllAsync<T>(string key)
         {
             HashEntry[] entries = await _client.HashGetAllAsync(key, CommandFlags.PreferSlave);
             Dictionary<string, T> dic = new Dictionary<string, T>();
             entries.ToList().ForEach(e => dic.Add(e.Name, SerializeHelper.Deserialize<T>(e.Value)));
             return dic;
         }

         #endregion

     }
 }

RedisHelper部分类RedisListHelperAsync.cs

 using Fantasy.RedisRepository.CommonHelper;
 using StackExchange.Redis;
 using System.Collections.Generic;
 using System.Threading.Tasks;

 namespace Fantasy.RedisRepository.RedisHelpers
 {
     /// <summary>
     /// Redis异步操作类  List部分类
     /// </summary>
     internal partial class RedisHelper
     {
         //    _client.ListRightPopLeftPushAsync();
         //    _client.ListTrimAsync();

         #region List 写操作

         public async Task<long> ListInsertAfterAsync<T>(string key, string pivot, T value)
         {
             return await _client.ListInsertAfterAsync(key, pivot, SerializeHelper.Serialize(value));
         }

         public async Task<long> ListInsertBeforeAsync<T>(string key, string pivot, T value)
         {
             return await _client.ListInsertBeforeAsync(key, pivot, SerializeHelper.Serialize(value));
         }

         public async Task<T> ListLeftPopAsync<T>(string key)
         {
             return SerializeHelper.Deserialize<T>(await _client.ListLeftPopAsync(key));
         }

         public async Task<long> ListLeftPushAsync<T>(string key, T value)
         {
             return await _client.ListLeftPushAsync(key, SerializeHelper.Serialize(value));
         }

         public async Task<long> ListLeftMultiPushAsync<T>(string key, List<T> values)
         {
             return await _client.ListLeftPushAsync(key, SerializeHelper.Serialize(RedisInnerTypeHelper.GenericListToRedisValues(values)));
         }

         public async Task<long> ListRemoveAsync<T>(string key, T value, long count = 0L)
         {
             return await _client.ListRemoveAsync(key, SerializeHelper.Serialize(value), count);
         }

         public async Task<T> ListRightPopAsync<T>(string key)
         {
             return SerializeHelper.Deserialize<T>(await _client.ListRightPopAsync(key));
         }

         public async Task<long> ListRightPushAsync<T>(string key, T value)
         {
             return await _client.ListRightPushAsync(key, SerializeHelper.Serialize(value));
         }

         public async Task<long> ListRightMultiPushAsync<T>(string key, List<T> values)
         {
             return
                 await
                     _client.ListRightPushAsync(key,
                         SerializeHelper.Serialize(RedisInnerTypeHelper.GenericListToRedisValues(values)));
         }

         public async Task ListSetByIndexAsync<T>(string key, int index, T value)
         {
             await _client.ListSetByIndexAsync(key, index, SerializeHelper.Serialize(value));
         }

         public async Task ListTrimAsync(string key, long start, long stop)
         {
             await _client.ListTrimAsync(key, start, stop);
         }
         #endregion

         #region List 读操作

         public async Task<T> ListGetByIndexAsync<T>(string key, long index)
         {
             return SerializeHelper.Deserialize<T>(await _client.ListGetByIndexAsync(key, index, CommandFlags.PreferSlave));
         }

         public async Task<long> ListLengthAsync<T>(string key)
         {
             return await _client.ListLengthAsync(key, CommandFlags.PreferSlave);
         }

         public async Task<List<T>> ListRangeAsync<T>(string key, long start = 0L, long stop = -1L)
         {
             return RedisInnerTypeHelper.RedisValuesToGenericList<T>(await _client.ListRangeAsync(key, start, stop, CommandFlags.PreferSlave));
         }

         #endregion
     }
 }

RedisLuaHelper.cs 这里打算装一些功能行lua脚本， 外部依然是传key一类的参数，这个不完整，只是个实例。

 using StackExchange.Redis;
 using System.Threading.Tasks;

 namespace Fantasy.RedisRepository.RedisHelpers
 {
     internal partial class RedisHelper
     {
         public async Task<RedisResult> LuaMutilGetHash()
         {
             string lua = @"local result={}
                 for i, v in ipairs(KEYS) do
                     result[i] = redis.call('hgetall',v)
                 end
                 return result";
             var res = await _client.ScriptEvaluateAsync(lua, new RedisKey[] { "people:1", "people:2", "people:3" });
            var res1=  LuaScript.GetCachedScriptCount();
             return res;
         }
     }
 }

关于Transcation的封装，我个人没有什么好的方法，提供了这样一个方法

  public async Task<bool> DoInTranscationAsync(Action<ITransaction> runOperations)
         {
             var tran = RedisConnection.GenerateConnection.GetDatabase().CreateTransaction();

             runOperations(tran);

             return await tran.ExecuteAsync();
         }

RedisFactory.cs

 using Fantasy.RedisRepository.RedisHelpers;

 namespace Fantasy.RedisRepository
 {
     public class RedisFactory
     {
         /// <summary>
         /// 外部访问redis入口，暂时只暴露异步方法
         /// </summary>
         /// <returns></returns>
         public static IRedisHelper CreateRedisRepository()
         {
             return new RedisHelper();
         }
     }
 }

六. 写在最后

自用RedisRepository分享，仅供参考。有交流才有进步，希望能得到更好的建议，做更好的改进。

如果我的点滴分享对你有点地帮助，欢迎点击下方红色按钮关注，我将持续输出分享。也欢迎为我也为你自己点赞支持。

参考：https://github.com/StackExchange/StackExchange.Redis/tree/master/Docs

　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　——保持学习，谨记谦虚。不端不装，有趣有梦。