RedisHelper.cs 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Threading.Tasks;
  5. using Newtonsoft.Json;
  6. using StackExchange.Redis;
  7. namespace Masuit.Tools.NoSQL
  8. {
  9. /// <summary>
  10. /// Redis操作
  11. /// </summary>
  12. public class RedisHelper
  13. {
  14. private int DbNum { get; }
  15. private readonly ConnectionMultiplexer _conn;
  16. /// <summary>
  17. /// 自定义键
  18. /// </summary>
  19. public string CustomKey;
  20. #region 构造函数
  21. /// <summary>
  22. /// 构造函数,使用该构造函数需要先在config中配置链接字符串,连接字符串在config配置文件中的ConnectionStrings节下配置,name固定为RedisHosts,值的格式:127.0.0.1:6379,allowadmin=true,若未正确配置,将按默认值“127.0.0.1:6379,allowadmin=true”进行操作,如:<br/>
  23. /// &lt;connectionStrings&gt;<br/>
  24. /// &lt;add name = "RedisHosts" connectionString="127.0.0.1:6379,allowadmin=true"/&gt;<br/>
  25. /// &lt;/connectionStrings&gt;
  26. /// </summary>
  27. /// <param name="dbNum">数据库编号</param>
  28. public RedisHelper(int dbNum = 0) : this(dbNum, null)
  29. {
  30. }
  31. /// <summary>
  32. /// 构造函数
  33. /// </summary>
  34. /// <param name="dbNum">数据库的编号</param>
  35. /// <param name="readWriteHosts">Redis服务器连接字符串,格式:127.0.0.1:6379,allowadmin=true</param>
  36. public RedisHelper(int dbNum, string readWriteHosts)
  37. {
  38. DbNum = dbNum;
  39. _conn = string.IsNullOrWhiteSpace(readWriteHosts) ? RedisConnectionHelp.Instance : RedisConnectionHelp.GetConnectionMultiplexer(readWriteHosts);
  40. }
  41. #endregion 构造函数
  42. #region String
  43. #region 同步方法
  44. /// <summary>
  45. /// 保存单个key value
  46. /// </summary>
  47. /// <param name="key">Redis Key</param>
  48. /// <param name="value">保存的值</param>
  49. /// <param name="expiry">过期时间</param>
  50. /// <returns>是否保存成功</returns>
  51. public bool SetString(string key, string value, TimeSpan? expiry = default(TimeSpan?))
  52. {
  53. key = AddSysCustomKey(key);
  54. return Do(db => db.StringSet(key, value, expiry));
  55. }
  56. /// <summary>
  57. /// 保存多个key value
  58. /// </summary>
  59. /// <param name="keyValues">键值对</param>
  60. /// <returns>是否保存成功</returns>
  61. public bool SetString(List<KeyValuePair<RedisKey, RedisValue>> keyValues)
  62. {
  63. List<KeyValuePair<RedisKey, RedisValue>> newkeyValues =
  64. keyValues.Select(p => new KeyValuePair<RedisKey, RedisValue>(AddSysCustomKey(p.Key), p.Value)).ToList();
  65. return Do(db => db.StringSet(newkeyValues.ToArray()));
  66. }
  67. /// <summary>
  68. /// 保存一个对象
  69. /// </summary>
  70. /// <typeparam name="T">对象类型</typeparam>
  71. /// <param name="key">键</param>
  72. /// <param name="obj">值</param>
  73. /// <param name="expiry">过期时间</param>
  74. /// <returns>是否保存成功</returns>
  75. public bool SetString<T>(string key, T obj, TimeSpan? expiry = default(TimeSpan?))
  76. {
  77. key = AddSysCustomKey(key);
  78. string json = ConvertJson(obj);
  79. return Do(db => db.StringSet(key, json, expiry));
  80. }
  81. /// <summary>
  82. /// 获取单个key的值
  83. /// </summary>
  84. /// <param name="key">键</param>
  85. /// <returns>值</returns>
  86. public string GetString(string key)
  87. {
  88. key = AddSysCustomKey(key);
  89. return Do(db => db.StringGet(key));
  90. }
  91. /// <summary>
  92. /// 获取多个Key
  93. /// </summary>
  94. /// <param name="listKey">键集合</param>
  95. /// <returns>值集合</returns>
  96. public RedisValue[] GetString(List<string> listKey)
  97. {
  98. List<string> newKeys = listKey.Select(AddSysCustomKey).ToList();
  99. return Do(db => db.StringGet(ConvertRedisKeys(newKeys)));
  100. }
  101. /// <summary>
  102. /// 获取一个key的对象
  103. /// </summary>
  104. /// <typeparam name="T">数据类型</typeparam>
  105. /// <param name="key">键</param>
  106. /// <returns>实例对象</returns>
  107. public T GetString<T>(string key)
  108. {
  109. key = AddSysCustomKey(key);
  110. return Do(db => ConvertObj<T>(db.StringGet(key)));
  111. }
  112. /// <summary>
  113. /// 为数字增长val
  114. /// </summary>
  115. /// <param name="key">键</param>
  116. /// <param name="val">可以为负</param>
  117. /// <returns>增长后的值</returns>
  118. public double StringIncrement(string key, double val = 1)
  119. {
  120. key = AddSysCustomKey(key);
  121. return Do(db => db.StringIncrement(key, val));
  122. }
  123. /// <summary>
  124. /// 为数字减少val
  125. /// </summary>
  126. /// <param name="key">键</param>
  127. /// <param name="val">可以为负</param>
  128. /// <returns>减少后的值</returns>
  129. public double StringDecrement(string key, double val = 1)
  130. {
  131. key = AddSysCustomKey(key);
  132. return Do(db => db.StringDecrement(key, val));
  133. }
  134. #endregion 同步方法
  135. #region 异步方法
  136. /// <summary>
  137. /// 保存单个key value
  138. /// </summary>
  139. /// <param name="key">Redis Key</param>
  140. /// <param name="value">保存的值</param>
  141. /// <param name="expiry">过期时间</param>
  142. /// <returns>是否保存成功</returns>
  143. public async Task<bool> SetStringAsync(string key, string value, TimeSpan? expiry = default(TimeSpan?))
  144. {
  145. key = AddSysCustomKey(key);
  146. return await Do(db => db.StringSetAsync(key, value, expiry));
  147. }
  148. /// <summary>
  149. /// 保存多个key value
  150. /// </summary>
  151. /// <param name="keyValues">键值对</param>
  152. /// <returns>是否保存成功</returns>
  153. public async Task<bool> SetStringAsync(List<KeyValuePair<RedisKey, RedisValue>> keyValues)
  154. {
  155. List<KeyValuePair<RedisKey, RedisValue>> newkeyValues =
  156. keyValues.Select(p => new KeyValuePair<RedisKey, RedisValue>(AddSysCustomKey(p.Key), p.Value)).ToList();
  157. return await Do(db => db.StringSetAsync(newkeyValues.ToArray()));
  158. }
  159. /// <summary>
  160. /// 保存一个对象
  161. /// </summary>
  162. /// <typeparam name="T">数据类型</typeparam>
  163. /// <param name="key">键</param>
  164. /// <param name="obj">需要被缓存的对象</param>
  165. /// <param name="expiry">过期时间</param>
  166. /// <returns>是否保存成功</returns>
  167. public async Task<bool> SetStringAsync<T>(string key, T obj, TimeSpan? expiry = default(TimeSpan?))
  168. {
  169. key = AddSysCustomKey(key);
  170. string json = ConvertJson(obj);
  171. return await Do(db => db.StringSetAsync(key, json, expiry));
  172. }
  173. /// <summary>
  174. /// 获取单个key的值
  175. /// </summary>
  176. /// <param name="key">键</param>
  177. /// <returns>值</returns>
  178. public async Task<string> GetStringAsync(string key)
  179. {
  180. key = AddSysCustomKey(key);
  181. return await Do(db => db.StringGetAsync(key));
  182. }
  183. /// <summary>
  184. /// 获取多个Key
  185. /// </summary>
  186. /// <param name="listKey">键集合</param>
  187. /// <returns>值集合</returns>
  188. public Task<RedisValue[]> GetStringAsync(List<string> listKey)
  189. {
  190. List<string> newKeys = listKey.Select(AddSysCustomKey).ToList();
  191. return Do(db => db.StringGetAsync(ConvertRedisKeys(newKeys)));
  192. }
  193. /// <summary>
  194. /// 获取一个key的对象
  195. /// </summary>
  196. /// <typeparam name="T">数据类型</typeparam>
  197. /// <param name="key">键</param>
  198. /// <returns>实例对象</returns>
  199. public async Task<T> GetStringAsync<T>(string key)
  200. {
  201. key = AddSysCustomKey(key);
  202. string result = await Do(db => db.StringGetAsync(key));
  203. return ConvertObj<T>(result);
  204. }
  205. /// <summary>
  206. /// 为数字增长val
  207. /// </summary>
  208. /// <param name="key">键</param>
  209. /// <param name="val">可以为负</param>
  210. /// <returns>增长后的值</returns>
  211. public Task<double> IncrementStringAsync(string key, double val = 1)
  212. {
  213. key = AddSysCustomKey(key);
  214. return Do(db => db.StringIncrementAsync(key, val));
  215. }
  216. /// <summary>
  217. /// 为数字减少val
  218. /// </summary>
  219. /// <param name="key">键</param>
  220. /// <param name="val">可以为负</param>
  221. /// <returns>减少后的值</returns>
  222. public Task<double> DecrementStringAsync(string key, double val = 1)
  223. {
  224. key = AddSysCustomKey(key);
  225. return Do(db => db.StringDecrementAsync(key, val));
  226. }
  227. #endregion 异步方法
  228. #endregion String
  229. #region Hash
  230. #region 同步方法
  231. /// <summary>
  232. /// 判断某个数据是否已经被缓存
  233. /// </summary>
  234. /// <param name="key">键</param>
  235. /// <param name="dataKey">对象的字段</param>
  236. /// <returns>是否缓存成功</returns>
  237. public bool HashExists(string key, string dataKey)
  238. {
  239. key = AddSysCustomKey(key);
  240. return Do(db => db.HashExists(key, dataKey));
  241. }
  242. /// <summary>
  243. /// 存储数据到hash表
  244. /// </summary>
  245. /// <typeparam name="T">数据类型</typeparam>
  246. /// <param name="key">键</param>
  247. /// <param name="dataKey">对象的字段</param>
  248. /// <param name="t">对象实例</param>
  249. /// <returns>是否存储成功</returns>
  250. public bool SetHash<T>(string key, string dataKey, T t)
  251. {
  252. key = AddSysCustomKey(key);
  253. return Do(db =>
  254. {
  255. string json = ConvertJson(t);
  256. return db.HashSet(key, dataKey, json);
  257. });
  258. }
  259. /// <summary>
  260. /// 移除hash中的某值
  261. /// </summary>
  262. /// <param name="key">键</param>
  263. /// <param name="dataKey">对象的字段</param>
  264. /// <returns>是否移除成功</returns>
  265. public bool DeleteHash(string key, string dataKey)
  266. {
  267. key = AddSysCustomKey(key);
  268. return Do(db => db.HashDelete(key, dataKey));
  269. }
  270. /// <summary>
  271. /// 移除hash中的多个值
  272. /// </summary>
  273. /// <param name="key">键</param>
  274. /// <param name="dataKeys">对象的字段集合</param>
  275. /// <returns>数量</returns>
  276. public long DeleteHash(string key, List<RedisValue> dataKeys)
  277. {
  278. key = AddSysCustomKey(key);
  279. //List<RedisValue> dataKeys1 = new List<RedisValue>() {"1","2"};
  280. return Do(db => db.HashDelete(key, dataKeys.ToArray()));
  281. }
  282. /// <summary>
  283. /// 从hash表获取数据
  284. /// </summary>
  285. /// <typeparam name="T">数据类型</typeparam>
  286. /// <param name="key">键</param>
  287. /// <param name="dataKey">对象的字段</param>
  288. /// <returns>对象实例</returns>
  289. public T GetHash<T>(string key, string dataKey)
  290. {
  291. key = AddSysCustomKey(key);
  292. return Do(db =>
  293. {
  294. string value = db.HashGet(key, dataKey);
  295. return ConvertObj<T>(value);
  296. });
  297. }
  298. /// <summary>
  299. /// 为数字增长val
  300. /// </summary>
  301. /// <param name="key">键</param>
  302. /// <param name="dataKey">对象的字段</param>
  303. /// <param name="val">可以为负</param>
  304. /// <returns>增长后的值</returns>
  305. public double IncrementHash(string key, string dataKey, double val = 1)
  306. {
  307. key = AddSysCustomKey(key);
  308. return Do(db => db.HashIncrement(key, dataKey, val));
  309. }
  310. /// <summary>
  311. /// 为数字减少val
  312. /// </summary>
  313. /// <param name="key">键</param>
  314. /// <param name="dataKey">对象的字段</param>
  315. /// <param name="val">可以为负</param>
  316. /// <returns>减少后的值</returns>
  317. public double DecrementHash(string key, string dataKey, double val = 1)
  318. {
  319. key = AddSysCustomKey(key);
  320. return Do(db => db.HashDecrement(key, dataKey, val));
  321. }
  322. /// <summary>
  323. /// 获取hashkey所有Redis key
  324. /// </summary>
  325. /// <typeparam name="T">数据类型</typeparam>
  326. /// <param name="key">键</param>
  327. /// <returns>数据集合</returns>
  328. public List<T> HashKeys<T>(string key)
  329. {
  330. key = AddSysCustomKey(key);
  331. return Do(db =>
  332. {
  333. RedisValue[] values = db.HashKeys(key);
  334. return ConvetList<T>(values);
  335. });
  336. }
  337. #endregion 同步方法
  338. #region 异步方法
  339. /// <summary>
  340. /// 判断某个数据是否已经被缓存
  341. /// </summary>
  342. /// <param name="key">键</param>
  343. /// <param name="dataKey">对象的字段</param>
  344. /// <returns>是否缓存成功</returns>
  345. public Task<bool> ExistsHashAsync(string key, string dataKey)
  346. {
  347. key = AddSysCustomKey(key);
  348. return Do(db => db.HashExistsAsync(key, dataKey));
  349. }
  350. /// <summary>
  351. /// 存储数据到hash表
  352. /// </summary>
  353. /// <typeparam name="T">数据类型</typeparam>
  354. /// <param name="key">键</param>
  355. /// <param name="dataKey">对象的字段</param>
  356. /// <param name="t">对象实例</param>
  357. /// <returns>是否存储成功</returns>
  358. public Task<bool> SetHashAsync<T>(string key, string dataKey, T t)
  359. {
  360. key = AddSysCustomKey(key);
  361. return Do(db =>
  362. {
  363. string json = ConvertJson(t);
  364. return db.HashSetAsync(key, dataKey, json);
  365. });
  366. }
  367. /// <summary>
  368. /// 移除hash中的某值
  369. /// </summary>
  370. /// <param name="key">键</param>
  371. /// <param name="dataKey">对象的字段</param>
  372. /// <returns>是否移除成功</returns>
  373. public Task<bool> DeleteHashAsync(string key, string dataKey)
  374. {
  375. key = AddSysCustomKey(key);
  376. return Do(db => db.HashDeleteAsync(key, dataKey));
  377. }
  378. /// <summary>
  379. /// 移除hash中的多个值
  380. /// </summary>
  381. /// <param name="key">键</param>
  382. /// <param name="dataKeys">对象的字段集合</param>
  383. /// <returns>数量</returns>
  384. public Task<long> DeleteHashAsync(string key, List<RedisValue> dataKeys)
  385. {
  386. key = AddSysCustomKey(key);
  387. return Do(db => db.HashDeleteAsync(key, dataKeys.ToArray()));
  388. }
  389. /// <summary>
  390. /// 从hash表获取数据
  391. /// </summary>
  392. /// <typeparam name="T">数据类型</typeparam>
  393. /// <param name="key">键</param>
  394. /// <param name="dataKey">对象的字段</param>
  395. /// <returns>对象实例</returns>
  396. public async Task<T> GetHashAsync<T>(string key, string dataKey)
  397. {
  398. key = AddSysCustomKey(key);
  399. string value = await Do(db => db.HashGetAsync(key, dataKey));
  400. return ConvertObj<T>(value);
  401. }
  402. /// <summary>
  403. /// 为数字增长val
  404. /// </summary>
  405. /// <param name="key">键</param>
  406. /// <param name="dataKey">对象的字段</param>
  407. /// <param name="val">可以为负</param>
  408. /// <returns>增长后的值</returns>
  409. public Task<double> IncrementHashAsync(string key, string dataKey, double val = 1)
  410. {
  411. key = AddSysCustomKey(key);
  412. return Do(db => db.HashIncrementAsync(key, dataKey, val));
  413. }
  414. /// <summary>
  415. /// 为数字减少val
  416. /// </summary>
  417. /// <param name="key">键</param>
  418. /// <param name="dataKey">对象的字段</param>
  419. /// <param name="val">可以为负</param>
  420. /// <returns>减少后的值</returns>
  421. public Task<double> DecrementHashAsync(string key, string dataKey, double val = 1)
  422. {
  423. key = AddSysCustomKey(key);
  424. return Do(db => db.HashDecrementAsync(key, dataKey, val));
  425. }
  426. /// <summary>
  427. /// 获取hashkey所有Redis key
  428. /// </summary>
  429. /// <typeparam name="T">数据类型</typeparam>
  430. /// <param name="key">键</param>
  431. /// <returns>数据集合</returns>
  432. public async Task<List<T>> HashKeysAsync<T>(string key)
  433. {
  434. key = AddSysCustomKey(key);
  435. RedisValue[] values = await Do(db => db.HashKeysAsync(key));
  436. return ConvetList<T>(values);
  437. }
  438. #endregion 异步方法
  439. #endregion Hash
  440. #region List
  441. #region 同步方法
  442. /// <summary>
  443. /// 移除指定ListId的内部List的值
  444. /// </summary>
  445. /// <typeparam name="T">数据类型</typeparam>
  446. /// <param name="key">键</param>
  447. /// <param name="value">值</param>
  448. public void RemoveList<T>(string key, T value)
  449. {
  450. key = AddSysCustomKey(key);
  451. Do(db => db.ListRemove(key, ConvertJson(value)));
  452. }
  453. /// <summary>
  454. /// 获取指定key的List
  455. /// </summary>
  456. /// <typeparam name="T">数据类型</typeparam>
  457. /// <param name="key">键</param>
  458. /// <returns>数据集</returns>
  459. public List<T> ListRange<T>(string key)
  460. {
  461. key = AddSysCustomKey(key);
  462. return Do(redis =>
  463. {
  464. var values = redis.ListRange(key);
  465. return ConvetList<T>(values);
  466. });
  467. }
  468. /// <summary>
  469. /// 入队
  470. /// </summary>
  471. /// <typeparam name="T">数据类型</typeparam>
  472. /// <param name="key">键</param>
  473. /// <param name="value">值</param>
  474. public void ListRightPush<T>(string key, T value)
  475. {
  476. key = AddSysCustomKey(key);
  477. Do(db => db.ListRightPush(key, ConvertJson(value)));
  478. }
  479. /// <summary>
  480. /// 出队
  481. /// </summary>
  482. /// <typeparam name="T">数据类型</typeparam>
  483. /// <param name="key">键</param>
  484. /// <returns>值</returns>
  485. public T ListRightPop<T>(string key)
  486. {
  487. key = AddSysCustomKey(key);
  488. return Do(db =>
  489. {
  490. var value = db.ListRightPop(key);
  491. return ConvertObj<T>(value);
  492. });
  493. }
  494. /// <summary>
  495. /// 入栈
  496. /// </summary>
  497. /// <typeparam name="T">数据类型</typeparam>
  498. /// <param name="key">键</param>
  499. /// <param name="value">值</param>
  500. public void ListLeftPush<T>(string key, T value)
  501. {
  502. key = AddSysCustomKey(key);
  503. Do(db => db.ListLeftPush(key, ConvertJson(value)));
  504. }
  505. /// <summary>
  506. /// 出栈
  507. /// </summary>
  508. /// <typeparam name="T">数据类型</typeparam>
  509. /// <param name="key">键</param>
  510. /// <returns>对象实例</returns>
  511. public T ListLeftPop<T>(string key)
  512. {
  513. key = AddSysCustomKey(key);
  514. return Do(db =>
  515. {
  516. var value = db.ListLeftPop(key);
  517. return ConvertObj<T>(value);
  518. });
  519. }
  520. /// <summary>
  521. /// 获取集合中的数量
  522. /// </summary>
  523. /// <param name="key">键</param>
  524. /// <returns>数量</returns>
  525. public long ListLength(string key)
  526. {
  527. key = AddSysCustomKey(key);
  528. return Do(redis => redis.ListLength(key));
  529. }
  530. #endregion 同步方法
  531. #region 异步方法
  532. /// <summary>
  533. /// 移除指定ListId的内部List的值
  534. /// </summary>
  535. /// <param name="key">键</param>
  536. /// <param name="value">值</param>
  537. public Task<long> RemoveListAsync<T>(string key, T value)
  538. {
  539. key = AddSysCustomKey(key);
  540. return Do(db => db.ListRemoveAsync(key, ConvertJson(value)));
  541. }
  542. /// <summary>
  543. /// 获取指定key的List
  544. /// </summary>
  545. /// <typeparam name="T">数据类型</typeparam>
  546. /// <param name="key">键</param>
  547. /// <returns>数据集合</returns>
  548. public async Task<List<T>> ListRangeAsync<T>(string key)
  549. {
  550. key = AddSysCustomKey(key);
  551. var values = await Do(redis => redis.ListRangeAsync(key));
  552. return ConvetList<T>(values);
  553. }
  554. /// <summary>
  555. /// 入队
  556. /// </summary>
  557. /// <typeparam name="T">数据类型</typeparam>
  558. /// <param name="key">键</param>
  559. /// <param name="value">值</param>
  560. public async Task<long> ListRightPushAsync<T>(string key, T value)
  561. {
  562. key = AddSysCustomKey(key);
  563. return await Do(db => db.ListRightPushAsync(key, ConvertJson(value)));
  564. }
  565. /// <summary>
  566. /// 出队
  567. /// </summary>
  568. /// <typeparam name="T">数据类型</typeparam>
  569. /// <param name="key">键</param>
  570. /// <returns>对象实例</returns>
  571. public async Task<T> ListRightPopAsync<T>(string key)
  572. {
  573. key = AddSysCustomKey(key);
  574. var value = await Do(db => db.ListRightPopAsync(key));
  575. return ConvertObj<T>(value);
  576. }
  577. /// <summary>
  578. /// 入栈
  579. /// </summary>
  580. /// <typeparam name="T">数据类型</typeparam>
  581. /// <param name="key">键</param>
  582. /// <param name="value">值</param>
  583. public async Task<long> ListLeftPushAsync<T>(string key, T value)
  584. {
  585. key = AddSysCustomKey(key);
  586. return await Do(db => db.ListLeftPushAsync(key, ConvertJson(value)));
  587. }
  588. /// <summary>
  589. /// 出栈
  590. /// </summary>
  591. /// <typeparam name="T">数据类型</typeparam>
  592. /// <param name="key">键</param>
  593. /// <returns>实例对象</returns>
  594. public async Task<T> ListLeftPopAsync<T>(string key)
  595. {
  596. key = AddSysCustomKey(key);
  597. var value = await Do(db => db.ListLeftPopAsync(key));
  598. return ConvertObj<T>(value);
  599. }
  600. /// <summary>
  601. /// 获取集合中的数量
  602. /// </summary>
  603. /// <param name="key">键</param>
  604. /// <returns>数量</returns>
  605. public async Task<long> ListLengthAsync(string key)
  606. {
  607. key = AddSysCustomKey(key);
  608. return await Do(redis => redis.ListLengthAsync(key));
  609. }
  610. #endregion 异步方法
  611. #endregion List
  612. #region SortedSet 有序集合
  613. #region 同步方法
  614. /// <summary>
  615. /// 添加
  616. /// </summary>
  617. /// <param name="key">键</param>
  618. /// <param name="value">值</param>
  619. /// <param name="score">排序号</param>
  620. public bool AddSortedSet<T>(string key, T value, double score)
  621. {
  622. key = AddSysCustomKey(key);
  623. return Do(redis => redis.SortedSetAdd(key, ConvertJson<T>(value), score));
  624. }
  625. /// <summary>
  626. /// 删除
  627. /// </summary>
  628. /// <param name="key">键</param>
  629. /// <param name="value">值</param>
  630. public bool RemoveSortedSet<T>(string key, T value)
  631. {
  632. key = AddSysCustomKey(key);
  633. return Do(redis => redis.SortedSetRemove(key, ConvertJson(value)));
  634. }
  635. /// <summary>
  636. /// 获取全部
  637. /// </summary>
  638. /// <param name="key">键</param>
  639. /// <returns>数据集合</returns>
  640. public List<T> SetRangeSortedByRank<T>(string key)
  641. {
  642. key = AddSysCustomKey(key);
  643. return Do(redis =>
  644. {
  645. var values = redis.SortedSetRangeByRank(key);
  646. return ConvetList<T>(values);
  647. });
  648. }
  649. /// <summary>
  650. /// 获取集合中的数量
  651. /// </summary>
  652. /// <param name="key">键</param>
  653. /// <returns>数量</returns>
  654. public long SetSortedLength(string key)
  655. {
  656. key = AddSysCustomKey(key);
  657. return Do(redis => redis.SortedSetLength(key));
  658. }
  659. #endregion 同步方法
  660. #region 异步方法
  661. /// <summary>
  662. /// 添加
  663. /// </summary>
  664. /// <param name="key">键</param>
  665. /// <param name="value">值</param>
  666. /// <param name="score">排序号</param>
  667. public async Task<bool> SortedSetAddAsync<T>(string key, T value, double score)
  668. {
  669. key = AddSysCustomKey(key);
  670. return await Do(redis => redis.SortedSetAddAsync(key, ConvertJson<T>(value), score));
  671. }
  672. /// <summary>
  673. /// 删除
  674. /// </summary>
  675. /// <param name="key">键</param>
  676. /// <param name="value">值</param>
  677. public async Task<bool> SortedSetRemoveAsync<T>(string key, T value)
  678. {
  679. key = AddSysCustomKey(key);
  680. return await Do(redis => redis.SortedSetRemoveAsync(key, ConvertJson(value)));
  681. }
  682. /// <summary>
  683. /// 获取全部
  684. /// </summary>
  685. /// <param name="key">键</param>
  686. /// <returns>数据集合</returns>
  687. public async Task<List<T>> SortedSetRangeByRankAsync<T>(string key)
  688. {
  689. key = AddSysCustomKey(key);
  690. var values = await Do(redis => redis.SortedSetRangeByRankAsync(key));
  691. return ConvetList<T>(values);
  692. }
  693. /// <summary>
  694. /// 获取集合中的数量
  695. /// </summary>
  696. /// <param name="key">键</param>
  697. /// <returns>数量</returns>
  698. public async Task<long> SortedSetLengthAsync(string key)
  699. {
  700. key = AddSysCustomKey(key);
  701. return await Do(redis => redis.SortedSetLengthAsync(key));
  702. }
  703. #endregion 异步方法
  704. #endregion SortedSet 有序集合
  705. #region key
  706. /// <summary>
  707. /// 删除单个key
  708. /// </summary>
  709. /// <param name="key">redis key</param>
  710. /// <returns>是否删除成功</returns>
  711. public bool DeleteKey(string key)
  712. {
  713. key = AddSysCustomKey(key);
  714. return Do(db => db.KeyDelete(key));
  715. }
  716. /// <summary>
  717. /// 删除多个key
  718. /// </summary>
  719. /// <param name="keys">rediskey</param>
  720. /// <returns>成功删除的个数</returns>
  721. public long DeleteKey(List<string> keys)
  722. {
  723. List<string> newKeys = keys.Select(AddSysCustomKey).ToList();
  724. return Do(db => db.KeyDelete(ConvertRedisKeys(newKeys)));
  725. }
  726. /// <summary>
  727. /// 判断key是否存储
  728. /// </summary>
  729. /// <param name="key">键</param>
  730. /// <returns>是否存储成功</returns>
  731. public bool KeyExists(string key)
  732. {
  733. key = AddSysCustomKey(key);
  734. return Do(db => db.KeyExists(key));
  735. }
  736. /// <summary>
  737. /// 重新命名key
  738. /// </summary>
  739. /// <param name="key">旧的键</param>
  740. /// <param name="newKey">新的键</param>
  741. /// <returns>处理结果</returns>
  742. public bool RenameKey(string key, string newKey)
  743. {
  744. key = AddSysCustomKey(key);
  745. return Do(db => db.KeyRename(key, newKey));
  746. }
  747. /// <summary>
  748. /// 设置Key的过期时间
  749. /// </summary>
  750. /// <param name="key">键</param>
  751. /// <param name="expiry">过期时间</param>
  752. /// <returns>处理结果</returns>
  753. public bool Expire(string key, TimeSpan? expiry = default(TimeSpan?))
  754. {
  755. key = AddSysCustomKey(key);
  756. return Do(db => db.KeyExpire(key, expiry));
  757. }
  758. #endregion key
  759. #region 发布订阅
  760. /// <summary>
  761. /// Redis发布订阅 订阅
  762. /// </summary>
  763. /// <param name="subChannel">订阅频道</param>
  764. /// <param name="handler">处理过程</param>
  765. public void Subscribe(string subChannel, Action<RedisChannel, RedisValue> handler = null)
  766. {
  767. ISubscriber sub = _conn.GetSubscriber();
  768. sub.Subscribe(subChannel, (channel, message) =>
  769. {
  770. if (handler == null)
  771. {
  772. Console.WriteLine(subChannel + " 订阅收到消息:" + message);
  773. }
  774. else
  775. {
  776. handler(channel, message);
  777. }
  778. });
  779. }
  780. /// <summary>
  781. /// Redis发布订阅 发布
  782. /// </summary>
  783. /// <typeparam name="T">消息对象</typeparam>
  784. /// <param name="channel">发布频道</param>
  785. /// <param name="msg">消息</param>
  786. /// <returns>消息的数量</returns>
  787. public long Publish<T>(string channel, T msg)
  788. {
  789. ISubscriber sub = _conn.GetSubscriber();
  790. return sub.Publish(channel, ConvertJson(msg));
  791. }
  792. /// <summary>
  793. /// Redis发布订阅 取消订阅
  794. /// </summary>
  795. /// <param name="channel">频道</param>
  796. public void Unsubscribe(string channel)
  797. {
  798. ISubscriber sub = _conn.GetSubscriber();
  799. sub.Unsubscribe(channel);
  800. }
  801. /// <summary>
  802. /// Redis发布订阅 取消全部订阅
  803. /// </summary>
  804. public void UnsubscribeAll()
  805. {
  806. ISubscriber sub = _conn.GetSubscriber();
  807. sub.UnsubscribeAll();
  808. }
  809. #endregion 发布订阅
  810. #region 其他
  811. /// <summary>
  812. /// 创建一个事务
  813. /// </summary>
  814. /// <returns>事务对象</returns>
  815. public ITransaction CreateTransaction()
  816. {
  817. return GetDatabase().CreateTransaction();
  818. }
  819. /// <summary>
  820. /// 获得一个数据库实例
  821. /// </summary>
  822. /// <returns>数据库实例</returns>
  823. public IDatabase GetDatabase()
  824. {
  825. return _conn.GetDatabase(DbNum);
  826. }
  827. /// <summary>
  828. /// 获得一个服务器实例
  829. /// </summary>
  830. /// <param name="hostAndPort">服务器地址</param>
  831. /// <returns>服务器实例</returns>
  832. public IServer GetServer(string hostAndPort)
  833. {
  834. return _conn.GetServer(hostAndPort);
  835. }
  836. /// <summary>
  837. /// 设置前缀
  838. /// </summary>
  839. /// <param name="customKey">前缀</param>
  840. public void SetSysCustomKey(string customKey)
  841. {
  842. CustomKey = customKey;
  843. }
  844. #endregion 其他
  845. #region 辅助方法
  846. private string AddSysCustomKey(string oldKey)
  847. {
  848. var prefixKey = CustomKey ?? RedisConnectionHelp.SysCustomKey;
  849. return prefixKey + oldKey;
  850. }
  851. private T Do<T>(Func<IDatabase, T> func)
  852. {
  853. var database = _conn.GetDatabase(DbNum);
  854. return func(database);
  855. }
  856. private string ConvertJson<T>(T value)
  857. {
  858. return JsonConvert.SerializeObject(value);
  859. }
  860. private T ConvertObj<T>(RedisValue value)
  861. {
  862. return JsonConvert.DeserializeObject<T>(value);
  863. }
  864. private List<T> ConvetList<T>(RedisValue[] values)
  865. {
  866. List<T> result = new List<T>();
  867. foreach (var item in values)
  868. {
  869. var model = ConvertObj<T>(item);
  870. result.Add(model);
  871. }
  872. return result;
  873. }
  874. private RedisKey[] ConvertRedisKeys(List<string> redisKeys)
  875. {
  876. return redisKeys.Select(redisKey => (RedisKey)redisKey).ToArray();
  877. }
  878. #endregion 辅助方法
  879. }
  880. }