WeihanLi.Redis

Intro

StackExchange.Redis 擴展，更簡單的泛型操作，並提供一些的適用於業務場景中的擴展

基於 Redis 的五種數據類型擴展出了一些應用：

1. String

   • Cache
   • Counter
   • Firewall
   • RedLock

2. Hash

   • Hash
   • Dictonary

3. List

   • List

4. Set

   • Set

5. SortedSet

   • SortedSet
   • Rank

GetStarted

Install

Install from Nuget

Configuration 配置

RedisManager.AddRedisConfig(config =>
    {
        config.CachePrefix = "WeihanLi.Redis.UnitTest";
        config.ChannelPrefix = "WeihanLi.Redis.UnitTest";
    });

.net core 應用，還可以這樣配置

serviceCollection.AddRedisConfig(config =>
    {
        config.CachePrefix = "WeihanLi.Redis.UnitTest";
        config.ChannelPrefix = "WeihanLi.Redis.UnitTest";
        config.EnableCompress = false;// disable compress
    });

Basic usage 基本用法

1. Cache 緩存

   緩存的基本操作主要是基於 RedisManager.CacheClient

   緩存的基本操作定義在 ICacheClient 中，基本操作如下：

   var key = "test111";
   var value = "Hello WeihanLi.Redis";
   Assert.True(RedisManager.CacheClient.Set(key, value));
   Assert.True(RedisManager.CacheClient.Exists(key));
   Assert.Equal(value, RedisManager.CacheClient.Get(key));
   Assert.True(RedisManager.CacheClient.Remove(key));
   Assert.False(RedisManager.CacheClient.Exists(key));
   RedisManager.CacheClient.GetOrSet(key, () => value, TimeSpan.FromSeconds(10));

2. Counter 計數器

   var counterName = "counterTest";
   var counterClient = RedisManager.GetCounterClient(counterName, TimeSpan.FromSeconds(60));
   Assert.Equal(0, counterClient.Base);
   Assert.Equal(0, counterClient.Count());
   counterClient.Increase();
   Assert.Equal(1, counterClient.Count());
   counterClient.Increase(5);
   Assert.Equal(6, counterClient.Count());
   counterClient.Decrease(3);
   Assert.Equal(3, counterClient.Count());
   Assert.True(counterClient.Reset());
   Assert.Equal(0, counterClient.Count());

3. Firewall 防火牆

   var firewallName = "firewallTest";
   var firewallClient = RedisManager.GetFirewallClient(firewallName, TimeSpan.FromSeconds(3));
   Assert.True(firewallClient.Hit());
   Assert.False(firewallClient.Hit());
   await Task.Delay(TimeSpan.FromSeconds(3));
   Assert.True(firewallClient.Hit());

4. RedLock Redis分散式鎖

   using (var client = RedisManager.GetRedLockClient("redLockTest"))
   {
       Assert.True(client.TryLock(TimeSpan.FromSeconds(10)));
       using (var client1 = RedisManager.GetRedLockClient("redLockTest"))
       {
           Assert.False(client.TryLock(TimeSpan.FromSeconds(10)));
           Assert.False(client1.Release());
       }
       Assert.True(client.Release());
   }
   
   var key = Guid.NewGuid().ToString("N");
   using (var client = RedisManager.GetRedLockClient(key))
   {
       Assert.True(client.TryLock(TimeSpan.FromSeconds(20)));
   }
   
   using (var client = RedisManager.GetRedLockClient(key))
   {
       Assert.True(client.TryLock(TimeSpan.FromMinutes(3)));
       Assert.True(client.Release());
   }

5. Rank 排行榜

   var rankClient = RedisManager.GetRankClient<string>("testRank");
   Assert.Equal(0, rankClient.Length());
   rankClient.Add("xiaoming", 100);
   rankClient.Add("xiaohong", 95);
   rankClient.Add("xiaowang", 96);
   Assert.Equal(3, rankClient.Length());
   Assert.Equal(100, rankClient.Score("xiaoming"));
   var rank = rankClient.RangeByScore();
   Assert.Equal("xiaohong", rank[0]);
   rank = rankClient.RangeByScore(order: Order.Descending);
   Assert.Equal("xiaoming", rank[0]);
   var common = RedisManager.GetCommonRedisClient(RedisDataType.Rank);
   Assert.True(common.KeyDelete("testRank"));

6. 更多用法等你來發現...

Conatct

Contact me: [email protected]