RedisHelper.cs 43 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269
  1. using Masuit.Tools.Core.Config;
  2. using Newtonsoft.Json;
  3. using StackExchange.Redis;
  4. using System;
  5. using System.Collections.Concurrent;
  6. using System.Collections.Generic;
  7. using System.Linq;
  8. using System.Threading.Tasks;
  9. namespace Masuit.Tools.NoSQL
  10. {
  11. /// <summary>
  12. /// Redis操作
  13. /// </summary>
  14. public class RedisHelper : IDisposable
  15. {
  16. private int DbNum { get; }
  17. private readonly ConnectionMultiplexer _conn;
  18. /// <summary>
  19. /// Redis服务器默认连接字符串,默认为:127.0.0.1:6379,allowadmin=true<br/>
  20. /// </summary>
  21. internal static string RedisConnectionString { get; set; } = CoreConfig.Configuration["Redis"] ?? "127.0.0.1:6379,allowadmin=true,connectTimeout=20000,connectRetry=1,responseTimeout=20000,syncTimeout=10000";
  22. /// <summary>
  23. /// 自定义键
  24. /// </summary>
  25. public string CustomKey;
  26. /// <summary>
  27. /// 连接失败 , 如果重新连接成功你将不会收到这个通知
  28. /// </summary>
  29. public event EventHandler<ConnectionFailedEventArgs> ConnectionFailed;
  30. /// <summary>
  31. /// 重新建立连接之前的错误
  32. /// </summary>
  33. public event EventHandler<ConnectionFailedEventArgs> ConnectionRestored;
  34. /// <summary>
  35. /// 发生错误时
  36. /// </summary>
  37. public event EventHandler<RedisErrorEventArgs> ErrorMessage;
  38. /// <summary>
  39. /// 配置更改时
  40. /// </summary>
  41. public event EventHandler<EndPointEventArgs> ConfigurationChanged;
  42. /// <summary>
  43. /// 更改集群时
  44. /// </summary>
  45. public event EventHandler<HashSlotMovedEventArgs> HashSlotMoved;
  46. /// <summary>
  47. /// redis类库错误时
  48. /// </summary>
  49. public event EventHandler<InternalErrorEventArgs> InternalError;
  50. /// <summary>
  51. /// 静态连接池
  52. /// </summary>
  53. private static ConcurrentDictionary<string, ConnectionMultiplexer> ConnectionCache { get; set; } = new ConcurrentDictionary<string, ConnectionMultiplexer>();
  54. #region 构造函数
  55. /// <summary>
  56. /// 构造函数,使用该构造函数需要先在config中配置链接字符串,连接字符串在config配置文件中的ConnectionStrings节下配置,name固定为RedisHosts,值的格式:127.0.0.1:6379,allowadmin=true,若未正确配置,将按默认值“127.0.0.1:6379,allowadmin=true,abortConnect=false”进行操作,如:<br/>
  57. /// &lt;connectionStrings&gt;<br/>
  58. /// &lt;add name = "RedisHosts" connectionString="127.0.0.1:6379,allowadmin=true,abortConnect=false"/&gt;<br/>
  59. /// &lt;/connectionStrings&gt;
  60. /// </summary>
  61. /// <param name="dbNum">数据库编号</param>
  62. public RedisHelper(int dbNum = 0) : this(null, dbNum)
  63. {
  64. }
  65. /// <summary>
  66. /// 构造函数
  67. /// </summary>
  68. /// <param name="readWriteHosts">Redis服务器连接字符串,格式:127.0.0.1:6379,allowadmin=true,abortConnect=false</param>
  69. /// <param name="dbNum">数据库的编号</param>
  70. public RedisHelper(string readWriteHosts, int dbNum = 0)
  71. {
  72. DbNum = dbNum;
  73. _conn = string.IsNullOrWhiteSpace(readWriteHosts) ? ConnectionMultiplexer.Connect(ConfigurationOptions.Parse(RedisConnectionString)) : ConnectionMultiplexer.Connect(ConfigurationOptions.Parse(readWriteHosts));
  74. //_conn.ConfigurationChanged += MuxerConfigurationChanged;
  75. _conn.ConfigurationChanged += ConfigurationChanged;
  76. //_conn.ConnectionFailed += MuxerConnectionFailed;
  77. _conn.ConnectionFailed += ConnectionFailed;
  78. //_conn.ConnectionRestored += MuxerConnectionRestored;
  79. _conn.ConnectionRestored += ConnectionRestored;
  80. //_conn.ErrorMessage += MuxerErrorMessage;
  81. _conn.ErrorMessage += ErrorMessage;
  82. //_conn.HashSlotMoved += MuxerHashSlotMoved;
  83. _conn.HashSlotMoved += HashSlotMoved;
  84. //_conn.InternalError += MuxerInternalError;
  85. _conn.InternalError += InternalError;
  86. }
  87. /// <summary>
  88. /// 构造函数
  89. /// </summary>
  90. /// <param name="readWriteHosts">Redis服务器连接字符串,格式:127.0.0.1:6379,allowadmin=true,abortConnect=false</param>
  91. /// <param name="dbNum">数据库的编号</param>
  92. /// <param name="_"></param>
  93. private RedisHelper(string readWriteHosts, int dbNum, int _)
  94. {
  95. DbNum = dbNum;
  96. readWriteHosts = string.IsNullOrWhiteSpace(readWriteHosts) ? RedisConnectionString : readWriteHosts;
  97. _conn = ConnectionCache.GetOrAdd(readWriteHosts, ConnectionMultiplexer.Connect(ConfigurationOptions.Parse(readWriteHosts)));
  98. //_conn.ConfigurationChanged += MuxerConfigurationChanged;
  99. _conn.ConfigurationChanged += ConfigurationChanged;
  100. //_conn.ConnectionFailed += MuxerConnectionFailed;
  101. _conn.ConnectionFailed += ConnectionFailed;
  102. //_conn.ConnectionRestored += MuxerConnectionRestored;
  103. _conn.ConnectionRestored += ConnectionRestored;
  104. //_conn.ErrorMessage += MuxerErrorMessage;
  105. _conn.ErrorMessage += ErrorMessage;
  106. //_conn.HashSlotMoved += MuxerHashSlotMoved;
  107. _conn.HashSlotMoved += HashSlotMoved;
  108. //_conn.InternalError += MuxerInternalError;
  109. _conn.InternalError += InternalError;
  110. }
  111. /// <summary>
  112. /// 获取新实例
  113. /// </summary>
  114. /// <param name="db">数据库的编号</param>
  115. /// <returns></returns>
  116. public static RedisHelper GetInstance(int db = 0)
  117. {
  118. return new RedisHelper(db);
  119. }
  120. /// <summary>
  121. /// 获取单例
  122. /// </summary>
  123. /// <param name="db">数据库的编号</param>
  124. /// <returns></returns>
  125. public static RedisHelper GetSingleInstance(int db = 0)
  126. {
  127. return new RedisHelper(null, db, 0);
  128. }
  129. /// <summary>
  130. /// 从对象池获取默认实例
  131. /// </summary>
  132. /// <param name="conn">Redis服务器连接字符串,格式:127.0.0.1:6379,allowadmin=true,abortConnect=false</param>
  133. /// <param name="db">数据库的编号</param>
  134. /// <returns></returns>
  135. public static RedisHelper GetInstance(string conn, int db = 0)
  136. {
  137. return new RedisHelper(conn, db);
  138. }
  139. /// <summary>
  140. /// 获取单例
  141. /// </summary>
  142. /// <param name="conn">Redis服务器连接字符串,格式:127.0.0.1:6379,allowadmin=true,abortConnect=false</param>
  143. /// <param name="db">数据库的编号</param>
  144. /// <returns></returns>
  145. public static RedisHelper GetSingleInstance(string conn, int db = 0)
  146. {
  147. return new RedisHelper(conn, db, 0);
  148. }
  149. #endregion 构造函数
  150. #region String
  151. #region 同步方法
  152. /// <summary>
  153. /// 保存单个key value
  154. /// </summary>
  155. /// <param name="key">Redis Key</param>
  156. /// <param name="value">保存的值</param>
  157. /// <param name="expiry">过期时间</param>
  158. /// <returns>是否保存成功</returns>
  159. public bool SetString(string key, string value, TimeSpan? expiry = default(TimeSpan?))
  160. {
  161. key = AddSysCustomKey(key);
  162. return Do(db => db.StringSet(key, value, expiry));
  163. }
  164. /// <summary>
  165. /// 保存多个key value
  166. /// </summary>
  167. /// <param name="keyValues">键值对</param>
  168. /// <returns>是否保存成功</returns>
  169. public bool SetString(List<KeyValuePair<RedisKey, RedisValue>> keyValues)
  170. {
  171. List<KeyValuePair<RedisKey, RedisValue>> newkeyValues = keyValues.Select(p => new KeyValuePair<RedisKey, RedisValue>(AddSysCustomKey(p.Key), p.Value)).ToList();
  172. return Do(db => db.StringSet(newkeyValues.ToArray()));
  173. }
  174. /// <summary>
  175. /// 保存一个对象
  176. /// </summary>
  177. /// <typeparam name="T">对象类型</typeparam>
  178. /// <param name="key">键</param>
  179. /// <param name="obj">值</param>
  180. /// <param name="expiry">过期时间</param>
  181. /// <returns>是否保存成功</returns>
  182. public bool SetString<T>(string key, T obj, TimeSpan? expiry = default(TimeSpan?))
  183. {
  184. key = AddSysCustomKey(key);
  185. string json = ConvertJson(obj);
  186. return Do(db => db.StringSet(key, json, expiry));
  187. }
  188. /// <summary>
  189. /// 获取单个key的值
  190. /// </summary>
  191. /// <param name="key">键</param>
  192. /// <returns>值</returns>
  193. public string GetString(string key)
  194. {
  195. if (KeyExists(key))
  196. {
  197. key = AddSysCustomKey(key);
  198. return Do(db => db.StringGet(key));
  199. }
  200. return string.Empty;
  201. }
  202. /// <summary>
  203. /// 获取多个Key
  204. /// </summary>
  205. /// <param name="listKey">键集合</param>
  206. /// <returns>值集合</returns>
  207. public RedisValue[] GetString(List<string> listKey)
  208. {
  209. List<string> newKeys = listKey.Select(AddSysCustomKey).ToList();
  210. return Do(db => db.StringGet(ConvertRedisKeys(newKeys)));
  211. }
  212. /// <summary>
  213. /// 获取一个key的对象
  214. /// </summary>
  215. /// <typeparam name="T">数据类型</typeparam>
  216. /// <param name="key">键</param>
  217. /// <returns>实例对象</returns>
  218. public T GetString<T>(string key)
  219. {
  220. if (KeyExists(key))
  221. {
  222. key = AddSysCustomKey(key);
  223. return Do(db => ConvertObj<T>(db.StringGet(key)));
  224. }
  225. return default(T);
  226. }
  227. /// <summary>
  228. /// 为数字增长val
  229. /// </summary>
  230. /// <param name="key">键</param>
  231. /// <param name="val">可以为负</param>
  232. /// <returns>增长后的值</returns>
  233. public double StringIncrement(string key, double val = 1)
  234. {
  235. key = AddSysCustomKey(key);
  236. return Do(db => db.StringIncrement(key, val));
  237. }
  238. /// <summary>
  239. /// 为数字减少val
  240. /// </summary>
  241. /// <param name="key">键</param>
  242. /// <param name="val">可以为负</param>
  243. /// <returns>减少后的值</returns>
  244. public double StringDecrement(string key, double val = 1)
  245. {
  246. key = AddSysCustomKey(key);
  247. return Do(db => db.StringDecrement(key, val));
  248. }
  249. #endregion 同步方法
  250. #region 异步方法
  251. /// <summary>
  252. /// 保存单个key value
  253. /// </summary>
  254. /// <param name="key">Redis Key</param>
  255. /// <param name="value">保存的值</param>
  256. /// <param name="expiry">过期时间</param>
  257. /// <returns>是否保存成功</returns>
  258. public async Task<bool> SetStringAsync(string key, string value, TimeSpan? expiry = default(TimeSpan?))
  259. {
  260. key = AddSysCustomKey(key);
  261. return await Do(async db => await db.StringSetAsync(key, value, expiry));
  262. }
  263. /// <summary>
  264. /// 保存多个key value
  265. /// </summary>
  266. /// <param name="keyValues">键值对</param>
  267. /// <returns>是否保存成功</returns>
  268. public async Task<bool> SetStringAsync(List<KeyValuePair<RedisKey, RedisValue>> keyValues)
  269. {
  270. List<KeyValuePair<RedisKey, RedisValue>> newkeyValues = keyValues.Select(p => new KeyValuePair<RedisKey, RedisValue>(AddSysCustomKey(p.Key), p.Value)).ToList();
  271. return await Do(async db => await db.StringSetAsync(newkeyValues.ToArray()));
  272. }
  273. /// <summary>
  274. /// 保存一个对象
  275. /// </summary>
  276. /// <typeparam name="T">数据类型</typeparam>
  277. /// <param name="key">键</param>
  278. /// <param name="obj">需要被缓存的对象</param>
  279. /// <param name="expiry">过期时间</param>
  280. /// <returns>是否保存成功</returns>
  281. public async Task<bool> SetStringAsync<T>(string key, T obj, TimeSpan? expiry = default(TimeSpan?))
  282. {
  283. key = AddSysCustomKey(key);
  284. string json = ConvertJson(obj);
  285. return await Do(async db => await db.StringSetAsync(key, json, expiry));
  286. }
  287. /// <summary>
  288. /// 获取单个key的值
  289. /// </summary>
  290. /// <param name="key">键</param>
  291. /// <returns>值</returns>
  292. public async Task<string> GetStringAsync(string key)
  293. {
  294. if (KeyExists(key))
  295. {
  296. key = AddSysCustomKey(key);
  297. return await Do(async db => await db.StringGetAsync(key));
  298. }
  299. return string.Empty;
  300. }
  301. /// <summary>
  302. /// 获取多个Key
  303. /// </summary>
  304. /// <param name="listKey">键集合</param>
  305. /// <returns>值集合</returns>
  306. public async Task<RedisValue[]> GetStringAsync(List<string> listKey)
  307. {
  308. List<string> newKeys = listKey.Select(AddSysCustomKey).ToList();
  309. return await Do(async db => await db.StringGetAsync(ConvertRedisKeys(newKeys)));
  310. }
  311. /// <summary>
  312. /// 获取一个key的对象
  313. /// </summary>
  314. /// <typeparam name="T">数据类型</typeparam>
  315. /// <param name="key">键</param>
  316. /// <returns>实例对象</returns>
  317. public async Task<T> GetStringAsync<T>(string key)
  318. {
  319. if (KeyExists(key))
  320. {
  321. key = AddSysCustomKey(key);
  322. string result = await Do(async db => await db.StringGetAsync(key));
  323. return ConvertObj<T>(result);
  324. }
  325. return default(T);
  326. }
  327. /// <summary>
  328. /// 为数字增长val
  329. /// </summary>
  330. /// <param name="key">键</param>
  331. /// <param name="val">可以为负</param>
  332. /// <returns>增长后的值</returns>
  333. public async Task<double> IncrementStringAsync(string key, double val = 1)
  334. {
  335. key = AddSysCustomKey(key);
  336. return await Do(async db => await db.StringIncrementAsync(key, val));
  337. }
  338. /// <summary>
  339. /// 为数字减少val
  340. /// </summary>
  341. /// <param name="key">键</param>
  342. /// <param name="val">可以为负</param>
  343. /// <returns>减少后的值</returns>
  344. public async Task<double> DecrementStringAsync(string key, double val = 1)
  345. {
  346. key = AddSysCustomKey(key);
  347. return await Do(async db => await db.StringDecrementAsync(key, val));
  348. }
  349. #endregion 异步方法
  350. #endregion String
  351. #region Hash
  352. #region 同步方法
  353. /// <summary>
  354. /// 判断某个数据是否已经被缓存
  355. /// </summary>
  356. /// <param name="key">键</param>
  357. /// <param name="dataKey">对象的字段</param>
  358. /// <returns>是否缓存成功</returns>
  359. public bool HashExists(string key, string dataKey)
  360. {
  361. key = AddSysCustomKey(key);
  362. return Do(db => db.HashExists(key, dataKey));
  363. }
  364. /// <summary>
  365. /// 存储数据到hash表
  366. /// </summary>
  367. /// <typeparam name="T">数据类型</typeparam>
  368. /// <param name="key">键</param>
  369. /// <param name="dataKey">对象的字段</param>
  370. /// <param name="t">对象实例</param>
  371. /// <returns>是否存储成功</returns>
  372. public bool SetHash<T>(string key, string dataKey, T t)
  373. {
  374. key = AddSysCustomKey(key);
  375. return Do(db =>
  376. {
  377. string json = ConvertJson(t);
  378. return db.HashSet(key, dataKey, json);
  379. });
  380. }
  381. /// <summary>
  382. /// 存储数据到hash表
  383. /// </summary>
  384. /// <typeparam name="T">数据类型</typeparam>
  385. /// <param name="key">键</param>
  386. /// <param name="dataKey">对象的字段</param>
  387. /// <param name="t">对象实例</param>
  388. /// <param name="expire">过期时间</param>
  389. /// <returns>是否存储成功</returns>
  390. public bool SetHash<T>(string key, string dataKey, T t, TimeSpan expire)
  391. {
  392. bool b = SetHash(key, dataKey, t);
  393. Expire(key, expire);
  394. return b;
  395. }
  396. /// <summary>
  397. /// 移除hash中的某值
  398. /// </summary>
  399. /// <param name="key">键</param>
  400. /// <param name="dataKey">对象的字段</param>
  401. /// <returns>是否移除成功</returns>
  402. public bool DeleteHash(string key, string dataKey)
  403. {
  404. key = AddSysCustomKey(key);
  405. return Do(db => db.HashDelete(key, dataKey));
  406. }
  407. /// <summary>
  408. /// 移除hash中的多个值
  409. /// </summary>
  410. /// <param name="key">键</param>
  411. /// <param name="dataKeys">对象的字段集合</param>
  412. /// <returns>数量</returns>
  413. public long DeleteHash(string key, List<RedisValue> dataKeys)
  414. {
  415. key = AddSysCustomKey(key);
  416. //List<RedisValue> dataKeys1 = new List<RedisValue>() {"1","2"};
  417. return Do(db => db.HashDelete(key, dataKeys.ToArray()));
  418. }
  419. /// <summary>
  420. /// 从hash表获取数据
  421. /// </summary>
  422. /// <typeparam name="T">数据类型</typeparam>
  423. /// <param name="key">键</param>
  424. /// <param name="dataKey">对象的字段</param>
  425. /// <returns>对象实例</returns>
  426. public T GetHash<T>(string key, string dataKey)
  427. {
  428. if (KeyExists(key))
  429. {
  430. key = AddSysCustomKey(key);
  431. return Do(db =>
  432. {
  433. string value = db.HashGet(key, dataKey);
  434. return ConvertObj<T>(value);
  435. });
  436. }
  437. return default(T);
  438. }
  439. /// <summary>
  440. /// 为数字增长val
  441. /// </summary>
  442. /// <param name="key">键</param>
  443. /// <param name="dataKey">对象的字段</param>
  444. /// <param name="val">可以为负</param>
  445. /// <returns>增长后的值</returns>
  446. public double IncrementHash(string key, string dataKey, double val = 1)
  447. {
  448. key = AddSysCustomKey(key);
  449. return Do(db => db.HashIncrement(key, dataKey, val));
  450. }
  451. /// <summary>
  452. /// 为数字减少val
  453. /// </summary>
  454. /// <param name="key">键</param>
  455. /// <param name="dataKey">对象的字段</param>
  456. /// <param name="val">可以为负</param>
  457. /// <returns>减少后的值</returns>
  458. public double DecrementHash(string key, string dataKey, double val = 1)
  459. {
  460. key = AddSysCustomKey(key);
  461. return Do(db => db.HashDecrement(key, dataKey, val));
  462. }
  463. /// <summary>
  464. /// 获取hashkey所有Redis key
  465. /// </summary>
  466. /// <typeparam name="T">数据类型</typeparam>
  467. /// <param name="key">键</param>
  468. /// <returns>数据集合</returns>
  469. public List<T> HashKeys<T>(string key)
  470. {
  471. key = AddSysCustomKey(key);
  472. return Do(db =>
  473. {
  474. RedisValue[] values = db.HashKeys(key);
  475. return ConvetList<T>(values);
  476. });
  477. }
  478. #endregion 同步方法
  479. #region 异步方法
  480. /// <summary>
  481. /// 判断某个数据是否已经被缓存
  482. /// </summary>
  483. /// <param name="key">键</param>
  484. /// <param name="dataKey">对象的字段</param>
  485. /// <returns>是否缓存成功</returns>
  486. public async Task<bool> ExistsHashAsync(string key, string dataKey)
  487. {
  488. key = AddSysCustomKey(key);
  489. return await Do(async db => await db.HashExistsAsync(key, dataKey));
  490. }
  491. /// <summary>
  492. /// 存储数据到hash表
  493. /// </summary>
  494. /// <typeparam name="T">数据类型</typeparam>
  495. /// <param name="key">键</param>
  496. /// <param name="dataKey">对象的字段</param>
  497. /// <param name="t">对象实例</param>
  498. /// <returns>是否存储成功</returns>
  499. public async Task<bool> SetHashAsync<T>(string key, string dataKey, T t)
  500. {
  501. key = AddSysCustomKey(key);
  502. return await Do(async db =>
  503. {
  504. string json = ConvertJson(t);
  505. return await db.HashSetAsync(key, dataKey, json);
  506. });
  507. }
  508. /// <summary>
  509. /// 存储数据到hash表
  510. /// </summary>
  511. /// <typeparam name="T">数据类型</typeparam>
  512. /// <param name="key">键</param>
  513. /// <param name="dataKey">对象的字段</param>
  514. /// <param name="t">对象实例</param>
  515. /// <param name="expire">过期时间</param>
  516. /// <returns>是否存储成功</returns>
  517. public async Task<bool> SetHashAsync<T>(string key, string dataKey, T t, TimeSpan expire)
  518. {
  519. var b = await SetHashAsync(key, dataKey, t);
  520. Expire(key, expire);
  521. return b;
  522. }
  523. /// <summary>
  524. /// 移除hash中的某值
  525. /// </summary>
  526. /// <param name="key">键</param>
  527. /// <param name="dataKey">对象的字段</param>
  528. /// <returns>是否移除成功</returns>
  529. public async Task<bool> DeleteHashAsync(string key, string dataKey)
  530. {
  531. key = AddSysCustomKey(key);
  532. return await Do(async db => await db.HashDeleteAsync(key, dataKey));
  533. }
  534. /// <summary>
  535. /// 移除hash中的多个值
  536. /// </summary>
  537. /// <param name="key">键</param>
  538. /// <param name="dataKeys">对象的字段集合</param>
  539. /// <returns>数量</returns>
  540. public async Task<long> DeleteHashAsync(string key, List<RedisValue> dataKeys)
  541. {
  542. key = AddSysCustomKey(key);
  543. return await Do(async db => await db.HashDeleteAsync(key, dataKeys.ToArray()));
  544. }
  545. /// <summary>
  546. /// 从hash表获取数据
  547. /// </summary>
  548. /// <typeparam name="T">数据类型</typeparam>
  549. /// <param name="key">键</param>
  550. /// <param name="dataKey">对象的字段</param>
  551. /// <returns>对象实例</returns>
  552. public async Task<T> GetHashAsync<T>(string key, string dataKey)
  553. {
  554. if (KeyExists(key))
  555. {
  556. key = AddSysCustomKey(key);
  557. string value = await Do(async db => await db.HashGetAsync(key, dataKey));
  558. return ConvertObj<T>(value);
  559. }
  560. return default(T);
  561. }
  562. /// <summary>
  563. /// 为数字增长val
  564. /// </summary>
  565. /// <param name="key">键</param>
  566. /// <param name="dataKey">对象的字段</param>
  567. /// <param name="val">可以为负</param>
  568. /// <returns>增长后的值</returns>
  569. public async Task<double> IncrementHashAsync(string key, string dataKey, double val = 1)
  570. {
  571. key = AddSysCustomKey(key);
  572. return await Do(async db => await db.HashIncrementAsync(key, dataKey, val));
  573. }
  574. /// <summary>
  575. /// 为数字减少val
  576. /// </summary>
  577. /// <param name="key">键</param>
  578. /// <param name="dataKey">对象的字段</param>
  579. /// <param name="val">可以为负</param>
  580. /// <returns>减少后的值</returns>
  581. public async Task<double> DecrementHashAsync(string key, string dataKey, double val = 1)
  582. {
  583. key = AddSysCustomKey(key);
  584. return await Do(async db => await db.HashDecrementAsync(key, dataKey, val));
  585. }
  586. /// <summary>
  587. /// 获取hashkey所有Redis key
  588. /// </summary>
  589. /// <typeparam name="T">数据类型</typeparam>
  590. /// <param name="key">键</param>
  591. /// <returns>数据集合</returns>
  592. public async Task<List<T>> HashKeysAsync<T>(string key)
  593. {
  594. key = AddSysCustomKey(key);
  595. RedisValue[] values = await Do(async db => await db.HashKeysAsync(key));
  596. return ConvetList<T>(values);
  597. }
  598. #endregion 异步方法
  599. #endregion Hash
  600. #region List
  601. #region 同步方法
  602. /// <summary>
  603. /// 移除指定ListId的内部List的值
  604. /// </summary>
  605. /// <typeparam name="T">数据类型</typeparam>
  606. /// <param name="key">键</param>
  607. /// <param name="value">值</param>
  608. public void RemoveList<T>(string key, T value)
  609. {
  610. key = AddSysCustomKey(key);
  611. Do(db => db.ListRemove(key, ConvertJson(value)));
  612. }
  613. /// <summary>
  614. /// 获取指定key的List
  615. /// </summary>
  616. /// <typeparam name="T">数据类型</typeparam>
  617. /// <param name="key">键</param>
  618. /// <returns>数据集</returns>
  619. public List<T> ListRange<T>(string key)
  620. {
  621. if (KeyExists(key))
  622. {
  623. key = AddSysCustomKey(key);
  624. return Do(redis =>
  625. {
  626. var values = redis.ListRange(key);
  627. return ConvetList<T>(values);
  628. });
  629. }
  630. return new List<T>();
  631. }
  632. /// <summary>
  633. /// 入队
  634. /// </summary>
  635. /// <typeparam name="T">数据类型</typeparam>
  636. /// <param name="key">键</param>
  637. /// <param name="value">值</param>
  638. public void ListRightPush<T>(string key, T value)
  639. {
  640. key = AddSysCustomKey(key);
  641. Do(db => db.ListRightPush(key, ConvertJson(value)));
  642. }
  643. /// <summary>
  644. /// 出队
  645. /// </summary>
  646. /// <typeparam name="T">数据类型</typeparam>
  647. /// <param name="key">键</param>
  648. /// <returns>值</returns>
  649. public T ListRightPop<T>(string key)
  650. {
  651. if (KeyExists(key))
  652. {
  653. key = AddSysCustomKey(key);
  654. return Do(db =>
  655. {
  656. var value = db.ListRightPop(key);
  657. return ConvertObj<T>(value);
  658. });
  659. }
  660. return default(T);
  661. }
  662. /// <summary>
  663. /// 入栈
  664. /// </summary>
  665. /// <typeparam name="T">数据类型</typeparam>
  666. /// <param name="key">键</param>
  667. /// <param name="value">值</param>
  668. public void ListLeftPush<T>(string key, T value)
  669. {
  670. key = AddSysCustomKey(key);
  671. Do(db => db.ListLeftPush(key, ConvertJson(value)));
  672. }
  673. /// <summary>
  674. /// 出栈
  675. /// </summary>
  676. /// <typeparam name="T">数据类型</typeparam>
  677. /// <param name="key">键</param>
  678. /// <returns>对象实例</returns>
  679. public T ListLeftPop<T>(string key)
  680. {
  681. if (KeyExists(key))
  682. {
  683. key = AddSysCustomKey(key);
  684. return Do(db =>
  685. {
  686. var value = db.ListLeftPop(key);
  687. return ConvertObj<T>(value);
  688. });
  689. }
  690. return default(T);
  691. }
  692. /// <summary>
  693. /// 获取集合中的数量
  694. /// </summary>
  695. /// <param name="key">键</param>
  696. /// <returns>数量</returns>
  697. public long ListLength(string key)
  698. {
  699. key = AddSysCustomKey(key);
  700. return Do(redis => redis.ListLength(key));
  701. }
  702. #endregion 同步方法
  703. #region 异步方法
  704. /// <summary>
  705. /// 移除指定ListId的内部List的值
  706. /// </summary>
  707. /// <param name="key">键</param>
  708. /// <param name="value">值</param>
  709. public async Task<long> RemoveListAsync<T>(string key, T value)
  710. {
  711. key = AddSysCustomKey(key);
  712. return await Do(async db => await db.ListRemoveAsync(key, ConvertJson(value)));
  713. }
  714. /// <summary>
  715. /// 获取指定key的List
  716. /// </summary>
  717. /// <typeparam name="T">数据类型</typeparam>
  718. /// <param name="key">键</param>
  719. /// <returns>数据集合</returns>
  720. public async Task<List<T>> ListRangeAsync<T>(string key)
  721. {
  722. if (KeyExists(key))
  723. {
  724. key = AddSysCustomKey(key);
  725. var values = await Do(async redis => await redis.ListRangeAsync(key));
  726. return ConvetList<T>(values);
  727. }
  728. return new List<T>();
  729. }
  730. /// <summary>
  731. /// 入队
  732. /// </summary>
  733. /// <typeparam name="T">数据类型</typeparam>
  734. /// <param name="key">键</param>
  735. /// <param name="value">值</param>
  736. public async Task<long> ListRightPushAsync<T>(string key, T value)
  737. {
  738. key = AddSysCustomKey(key);
  739. return await Do(async db => await db.ListRightPushAsync(key, ConvertJson(value)));
  740. }
  741. /// <summary>
  742. /// 出队
  743. /// </summary>
  744. /// <typeparam name="T">数据类型</typeparam>
  745. /// <param name="key">键</param>
  746. /// <returns>对象实例</returns>
  747. public async Task<T> ListRightPopAsync<T>(string key)
  748. {
  749. if (KeyExists(key))
  750. {
  751. key = AddSysCustomKey(key);
  752. var value = await Do(async db => await db.ListRightPopAsync(key));
  753. return ConvertObj<T>(value);
  754. }
  755. return default(T);
  756. }
  757. /// <summary>
  758. /// 入栈
  759. /// </summary>
  760. /// <typeparam name="T">数据类型</typeparam>
  761. /// <param name="key">键</param>
  762. /// <param name="value">值</param>
  763. public async Task<long> ListLeftPushAsync<T>(string key, T value)
  764. {
  765. key = AddSysCustomKey(key);
  766. return await Do(async db => await db.ListLeftPushAsync(key, ConvertJson(value)));
  767. }
  768. /// <summary>
  769. /// 出栈
  770. /// </summary>
  771. /// <typeparam name="T">数据类型</typeparam>
  772. /// <param name="key">键</param>
  773. /// <returns>实例对象</returns>
  774. public async Task<T> ListLeftPopAsync<T>(string key)
  775. {
  776. if (KeyExists(key))
  777. {
  778. key = AddSysCustomKey(key);
  779. var value = await Do(async db => await db.ListLeftPopAsync(key));
  780. return ConvertObj<T>(value);
  781. }
  782. return default(T);
  783. }
  784. /// <summary>
  785. /// 获取集合中的数量
  786. /// </summary>
  787. /// <param name="key">键</param>
  788. /// <returns>数量</returns>
  789. public async Task<long> ListLengthAsync(string key)
  790. {
  791. key = AddSysCustomKey(key);
  792. return await Do(async redis => await redis.ListLengthAsync(key));
  793. }
  794. #endregion 异步方法
  795. #endregion List
  796. #region SortedSet 有序集合
  797. #region 同步方法
  798. /// <summary>
  799. /// 添加
  800. /// </summary>
  801. /// <param name="key">键</param>
  802. /// <param name="value">值</param>
  803. /// <param name="score">排序号</param>
  804. public bool AddSortedSet<T>(string key, T value, double score)
  805. {
  806. key = AddSysCustomKey(key);
  807. return Do(redis => redis.SortedSetAdd(key, ConvertJson<T>(value), score));
  808. }
  809. /// <summary>
  810. /// 删除
  811. /// </summary>
  812. /// <param name="key">键</param>
  813. /// <param name="value">值</param>
  814. public bool RemoveSortedSet<T>(string key, T value)
  815. {
  816. key = AddSysCustomKey(key);
  817. return Do(redis => redis.SortedSetRemove(key, ConvertJson(value)));
  818. }
  819. /// <summary>
  820. /// 获取全部
  821. /// </summary>
  822. /// <param name="key">键</param>
  823. /// <returns>数据集合</returns>
  824. public List<T> SetRangeSortedByRank<T>(string key)
  825. {
  826. if (KeyExists(key))
  827. {
  828. key = AddSysCustomKey(key);
  829. return Do(redis =>
  830. {
  831. var values = redis.SortedSetRangeByRank(key);
  832. return ConvetList<T>(values);
  833. });
  834. }
  835. return new List<T>();
  836. }
  837. /// <summary>
  838. /// 获取集合中的数量
  839. /// </summary>
  840. /// <param name="key">键</param>
  841. /// <returns>数量</returns>
  842. public long SetSortedLength(string key)
  843. {
  844. key = AddSysCustomKey(key);
  845. return Do(redis => redis.SortedSetLength(key));
  846. }
  847. #endregion 同步方法
  848. #region 异步方法
  849. /// <summary>
  850. /// 添加
  851. /// </summary>
  852. /// <param name="key">键</param>
  853. /// <param name="value">值</param>
  854. /// <param name="score">排序号</param>
  855. public async Task<bool> SortedSetAddAsync<T>(string key, T value, double score)
  856. {
  857. key = AddSysCustomKey(key);
  858. return await Do(async redis => await redis.SortedSetAddAsync(key, ConvertJson<T>(value), score));
  859. }
  860. /// <summary>
  861. /// 删除
  862. /// </summary>
  863. /// <param name="key">键</param>
  864. /// <param name="value">值</param>
  865. public async Task<bool> SortedSetRemoveAsync<T>(string key, T value)
  866. {
  867. key = AddSysCustomKey(key);
  868. return await Do(async redis => await redis.SortedSetRemoveAsync(key, ConvertJson(value)));
  869. }
  870. /// <summary>
  871. /// 获取全部
  872. /// </summary>
  873. /// <param name="key">键</param>
  874. /// <returns>数据集合</returns>
  875. public async Task<List<T>> SortedSetRangeByRankAsync<T>(string key)
  876. {
  877. if (KeyExists(key))
  878. {
  879. key = AddSysCustomKey(key);
  880. var values = await Do(async redis => await redis.SortedSetRangeByRankAsync(key));
  881. return ConvetList<T>(values);
  882. }
  883. return new List<T>();
  884. }
  885. /// <summary>
  886. /// 获取集合中的数量
  887. /// </summary>
  888. /// <param name="key">键</param>
  889. /// <returns>数量</returns>
  890. public async Task<long> SortedSetLengthAsync(string key)
  891. {
  892. key = AddSysCustomKey(key);
  893. return await Do(async redis => await redis.SortedSetLengthAsync(key));
  894. }
  895. #endregion 异步方法
  896. #endregion SortedSet 有序集合
  897. #region key
  898. /// <summary>
  899. /// 删除单个key
  900. /// </summary>
  901. /// <param name="key">redis key</param>
  902. /// <returns>是否删除成功</returns>
  903. public bool DeleteKey(string key)
  904. {
  905. key = AddSysCustomKey(key);
  906. return Do(db => db.KeyDelete(key));
  907. }
  908. /// <summary>
  909. /// 删除多个key
  910. /// </summary>
  911. /// <param name="keys">rediskey</param>
  912. /// <returns>成功删除的个数</returns>
  913. public long DeleteKey(List<string> keys)
  914. {
  915. List<string> newKeys = keys.Select(AddSysCustomKey).ToList();
  916. return Do(db => db.KeyDelete(ConvertRedisKeys(newKeys)));
  917. }
  918. /// <summary>
  919. /// 判断key是否存储
  920. /// </summary>
  921. /// <param name="key">键</param>
  922. /// <returns>是否存储成功</returns>
  923. public bool KeyExists(string key)
  924. {
  925. key = AddSysCustomKey(key);
  926. return Do(db => db.KeyExists(key));
  927. }
  928. /// <summary>
  929. /// 重新命名key
  930. /// </summary>
  931. /// <param name="key">旧的键</param>
  932. /// <param name="newKey">新的键</param>
  933. /// <returns>处理结果</returns>
  934. public bool RenameKey(string key, string newKey)
  935. {
  936. key = AddSysCustomKey(key);
  937. return Do(db => db.KeyRename(key, newKey));
  938. }
  939. /// <summary>
  940. /// 设置Key的过期时间
  941. /// </summary>
  942. /// <param name="key">键</param>
  943. /// <param name="expiry">过期时间</param>
  944. /// <returns>处理结果</returns>
  945. public bool Expire(string key, TimeSpan? expiry = default(TimeSpan?))
  946. {
  947. key = AddSysCustomKey(key);
  948. return Do(db => db.KeyExpire(key, expiry));
  949. }
  950. #endregion key
  951. #region 发布订阅
  952. /// <summary>
  953. /// Redis发布订阅 订阅
  954. /// </summary>
  955. /// <param name="subChannel">订阅频道</param>
  956. /// <param name="handler">处理过程</param>
  957. public void Subscribe(string subChannel, Action<RedisChannel, RedisValue> handler = null)
  958. {
  959. ISubscriber sub = _conn.GetSubscriber();
  960. sub.Subscribe(subChannel, (channel, message) =>
  961. {
  962. if (handler == null)
  963. {
  964. Console.WriteLine(subChannel + " 订阅收到消息:" + message);
  965. }
  966. else
  967. {
  968. handler(channel, message);
  969. }
  970. });
  971. }
  972. /// <summary>
  973. /// Redis发布订阅 发布
  974. /// </summary>
  975. /// <typeparam name="T">消息对象</typeparam>
  976. /// <param name="channel">发布频道</param>
  977. /// <param name="msg">消息</param>
  978. /// <returns>消息的数量</returns>
  979. public long Publish<T>(string channel, T msg)
  980. {
  981. ISubscriber sub = _conn.GetSubscriber();
  982. return sub.Publish(channel, ConvertJson(msg));
  983. }
  984. /// <summary>
  985. /// Redis发布订阅 取消订阅
  986. /// </summary>
  987. /// <param name="channel">频道</param>
  988. public void Unsubscribe(string channel)
  989. {
  990. ISubscriber sub = _conn.GetSubscriber();
  991. sub.Unsubscribe(channel);
  992. }
  993. /// <summary>
  994. /// Redis发布订阅 取消全部订阅
  995. /// </summary>
  996. public void UnsubscribeAll()
  997. {
  998. ISubscriber sub = _conn.GetSubscriber();
  999. sub.UnsubscribeAll();
  1000. }
  1001. #endregion 发布订阅
  1002. #region 其他
  1003. /// <summary>
  1004. /// 创建一个事务
  1005. /// </summary>
  1006. /// <returns>事务对象</returns>
  1007. public ITransaction CreateTransaction()
  1008. {
  1009. return GetDatabase().CreateTransaction();
  1010. }
  1011. /// <summary>
  1012. /// 获得一个数据库实例
  1013. /// </summary>
  1014. /// <returns>数据库实例</returns>
  1015. public IDatabase GetDatabase()
  1016. {
  1017. return _conn.GetDatabase(DbNum);
  1018. }
  1019. /// <summary>
  1020. /// 获得一个服务器实例
  1021. /// </summary>
  1022. /// <param name="hostAndPort">服务器地址</param>
  1023. /// <returns>服务器实例</returns>
  1024. public IServer GetServer(string hostAndPort = null)
  1025. {
  1026. hostAndPort = string.IsNullOrEmpty(hostAndPort) ? _conn.Configuration.Split(',')[0] : hostAndPort;
  1027. return _conn.GetServer(hostAndPort);
  1028. }
  1029. /// <summary>
  1030. /// 设置前缀
  1031. /// </summary>
  1032. /// <param name="customKey">前缀</param>
  1033. public void SetSysCustomKey(string customKey)
  1034. {
  1035. CustomKey = customKey;
  1036. }
  1037. #endregion 其他
  1038. #region 辅助方法
  1039. private string AddSysCustomKey(string oldKey)
  1040. {
  1041. var prefixKey = CustomKey ?? String.Empty;
  1042. return prefixKey + oldKey;
  1043. }
  1044. private T Do<T>(Func<IDatabase, T> func)
  1045. {
  1046. var database = _conn.GetDatabase(DbNum);
  1047. return func(database);
  1048. }
  1049. private string ConvertJson<T>(T value)
  1050. {
  1051. return JsonConvert.SerializeObject(value);
  1052. }
  1053. private T ConvertObj<T>(RedisValue value)
  1054. {
  1055. return JsonConvert.DeserializeObject<T>(value);
  1056. }
  1057. private List<T> ConvetList<T>(RedisValue[] values)
  1058. {
  1059. List<T> result = new List<T>();
  1060. foreach (var item in values)
  1061. {
  1062. var model = ConvertObj<T>(item);
  1063. result.Add(model);
  1064. }
  1065. return result;
  1066. }
  1067. private RedisKey[] ConvertRedisKeys(List<string> redisKeys)
  1068. {
  1069. return redisKeys.Select(redisKey => (RedisKey)redisKey).ToArray();
  1070. }
  1071. #endregion 辅助方法
  1072. #region 事件
  1073. ///// <summary>
  1074. ///// 配置更改时
  1075. ///// </summary>
  1076. ///// <param name="sender">触发者</param>
  1077. ///// <param name="e">事件参数</param>
  1078. //private static void MuxerConfigurationChanged(object sender, EndPointEventArgs e)
  1079. //{
  1080. // Console.WriteLine("Configuration changed: " + e.EndPoint);
  1081. //}
  1082. ///// <summary>
  1083. ///// 发生错误时
  1084. ///// </summary>
  1085. ///// <param name="sender"></param>
  1086. ///// <param name="e"></param>
  1087. //private static void MuxerErrorMessage(object sender, RedisErrorEventArgs e)
  1088. //{
  1089. // Console.WriteLine("ErrorMessage: " + e.Message);
  1090. //}
  1091. ///// <summary>
  1092. ///// 重新建立连接之前的错误
  1093. ///// </summary>
  1094. ///// <param name="sender"></param>
  1095. ///// <param name="e"></param>
  1096. //private static void MuxerConnectionRestored(object sender, ConnectionFailedEventArgs e)
  1097. //{
  1098. // Console.WriteLine("ConnectionRestored: " + e.EndPoint);
  1099. //}
  1100. ///// <summary>
  1101. ///// 连接失败 , 如果重新连接成功你将不会收到这个通知
  1102. ///// </summary>
  1103. ///// <param name="sender"></param>
  1104. ///// <param name="e"></param>
  1105. //private static void MuxerConnectionFailed(object sender, ConnectionFailedEventArgs e)
  1106. //{
  1107. // Console.WriteLine("重新连接:Endpoint failed: " + e.EndPoint + ", " + e.FailureType + (e.Exception == null ? "" : (", " + e.Exception.Message)));
  1108. //}
  1109. ///// <summary>
  1110. ///// 更改集群
  1111. ///// </summary>
  1112. ///// <param name="sender"></param>
  1113. ///// <param name="e"></param>
  1114. //private static void MuxerHashSlotMoved(object sender, HashSlotMovedEventArgs e)
  1115. //{
  1116. // Console.WriteLine("HashSlotMoved:NewEndPoint" + e.NewEndPoint + ", OldEndPoint" + e.OldEndPoint);
  1117. //}
  1118. ///// <summary>
  1119. ///// redis类库错误
  1120. ///// </summary>
  1121. ///// <param name="sender"></param>
  1122. ///// <param name="e"></param>
  1123. //private static void MuxerInternalError(object sender, InternalErrorEventArgs e)
  1124. //{
  1125. // Console.WriteLine("InternalError:Message" + e.Exception.Message);
  1126. //}
  1127. #endregion 事件
  1128. /// <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
  1129. public void Dispose()
  1130. {
  1131. _conn.Dispose();
  1132. }
  1133. }
  1134. }