第十一节：Asp.Net Core 之内容缓存(IMemoryCache)

1. 整体说明

　　ASP.NET Core 支持多种不同的缓存,最简单的缓存基于 IMemoryCache，它表示存储在 Web 服务器内存中的缓存，内存缓存可以存储任何对象，存储形式键值对，需要 .net standard 2.0 或者 .Net framework 4.5 或更高版本。

本节主要介绍：依赖注入的方式使用、全局封装单例配置、缓存几个方法和性质。

2. 常规使用步骤

　　(1) 安装程序集：System.Runtime.Caching 和 Microsoft.Extensions.Caching.Memory，如果是是Core MVC程序自带的Microsoft.AspNetCore.App包里已经涵盖了

Microsoft.Extensions.Caching.Memory，无需重复下载。

　　(2) 在ConfigureService中注册内存缓存服务： services.AddMemoryCache();

 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.DependencyInjection;

 public class Startup
 {
     public void ConfigureServices(IServiceCollection services)
     {
         services.AddMemoryCache();
         services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
     }

 }

　　(3) 通过属性注入的方式在控制器中注入IMemoryCache对象。

  public class FirstController : Controller
     {
         private IMemoryCache _cache1;
         public FirstController(IMemoryCache memoryCache)
         {
             _cache1 = memoryCache;
         }
     }

　　(4) 通过get、set方法实现常规缓存的读取和写入,如下 案例①。

    {
        string nowTime1 = _cache1.Get<string>("t1");
        if (String.IsNullOrEmpty(nowTime1))
        {
            nowTime1 = DateTime.Now.ToString();
            _cache1.Set("t1", nowTime1);
        }
        ViewBag.t1 = nowTime1;
   }

3. 全局封装单例的形式

　(1)新建一个memoryCacheHelp类,声明一个IMemoryCache属性，并在构造函数中进行初始化，实例化的时候可以通过SizeLimit设置全局缓存的最大Size。

特别注意：如果在这全局设置了最大Size，凡是使用的时候都需要通过SetSize进行设置，且必须 "小于等于" 这个最大Size，不设置会报错，设置的比这个大，缓存会失效。

  public class memoryCacheHelp
     {
         public IMemoryCache _cache { get; set; }
         public memoryCacheHelp()
         {
             _cache = new MemoryCache(new MemoryCacheOptions {
                 SizeLimit =
             });
         }
     }

　(2)在ConfigureService将该类注册成单例的：services.AddSingleton<memoryCacheHelp>();

 public void ConfigureServices(IServiceCollection services)
 {
     services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
     services.AddSingleton<memoryCacheHelp>();
 }

　(3)通过属性注入的方式在控制器中注入IMemoryCache对象

  public class FirstController : Controller
     {
         private IMemoryCache _cache2;
         public FirstController(memoryCacheHelp cache)
         {
             _cache2 = cache._cache;
         }
    }

　(4)通过TryGetValue、set方法实现缓存的读取和写入,如下 案例②

注： 这里通过依赖注入的形式将memoryCacheHelp注册成单例类，和直接声明成单例类道理是一样的。

  {
      string nowTime2 = null;
      if (!_cache2.TryGetValue("t2", out nowTime2))
      {
          nowTime2 = DateTime.Now.ToString();
          //设置缓存的大小
          var cacheOptions = new MemoryCacheEntryOptions()
                                       .SetSize()
                                       .SetAbsoluteExpiration(TimeSpan.FromSeconds());
           _cache2.Set("t2", nowTime2, cacheOptions);
      }
     ViewBag.t2 = nowTime2;
 }

4. 方法、属性详解

(1) 获取数据

　A. Get<T>方法：根据键名获取指定类型的值,将返回值做判断，比如根据是否为null，来判断有没有值。 如下面的案例①

　B. TryGetValue(object key, out TItem value);根据key获取指定类型值,通过out参数进行输出，如果拿到值返回true，如果拿不到值返回false，相比Get<T>方法 如下面案例②

　C. GetOrCreate(object key, Func<ICacheEntry, TItem> factory);适用场景：key有值则获取该值，没有值为它赋值(通过return直接返回)。如下面案例③

(2) 写入数据

　A. Set方法：有很多重载，重点看下面两个

　　①：Set<TItem>(object key, TItem value); 最简单的键值模式

　　②：Set<TItem>(object key, TItem value, MemoryCacheEntryOptions options); 通过MemoryCacheEntryOptions设置缓存的性质，详见下面

　B. GetOrCreate方法：当key对应的值为空则通过return返回来赋值，如下面的：案例③，通过第二个参数在Func委托中设置ICacheEntry属性进行缓存性质的设置。 详见下面(5)

 {
     string nowTime3 = _cache1.GetOrCreate("t3", entry =>
     {
       entry.Size = ;
       //滑动过期时间设置为2秒
       entry.SlidingExpiration = TimeSpan.FromSeconds();
       //绝对和滑动只能设置一个
       //entry.AbsoluteExpiration = new DateTimeOffset(DateTime.Parse("2019-07-16 16:33:10"));
       entry.Priority = CacheItemPriority.High;
       entry.RegisterPostEvictionCallback(MyCallback, this);
       return DateTime.Now.ToString();
     });
     ViewBag.t3 = nowTime3;
 }

(3) 移除数据

　A. Remove方法：Remove(object key); 移除缓存

(4) MemoryCacheEntryOptions类

　用来设置缓存的一些性质，可以通过方法或者属性进行设置，在Set方法中使用。

　A. 缓存大小(SetSize方法和Size属性)：如果全局单例设置缓存的最大值，则每个使用的地方都需要显式的设置，必须小于等于最大值，如果不设置报错，如果设置比最大值还大，缓存不生效。

　B. 绝对过期时间(SetAbsoluteExpiration方法和AbsoluteExpiration属性)：绝对指的是到了这个时间就过期，不管这期间有没有人访问。

　绝对过期有两种设置方式：① 通过TimeSpan设置距离当前时间的间隔 ② 通过DateTimeOffset设置具体到某一时刻。 详见下面案例④

　C. 滑动过期时间(SetSlidingExpiration方法和SlidingExpiration属性)：相对是指以最后一次访问来计算，每访问一次重新计算过期时间。

　D. 缓存级别(SetPriority方法和Priority属性)：有Low、Normal、High、NeverRemove。

　E. 缓存移除时回调(RegisterPostEvictionCallback方法和属性)：缓存过期或者手动移除时调用，该方法有四个参数，调用的时候自动赋值，分别是： 键、值、消失原因、状态。

   {
                 string nowTime4 = null;
                 if (!_cache2.TryGetValue("t4", out nowTime4))
                 {
                     nowTime4 = DateTime.Now.ToString();
                     MemoryCacheEntryOptions cacheOptions = null;

                     //设置缓存方式一：(通过方法)
                     {
                         cacheOptions = new MemoryCacheEntryOptions()
                          .SetSize()
                          //.SetSlidingExpiration(TimeSpan.FromSeconds(5))
                          //绝对和滑动只能设置一个
                          .SetAbsoluteExpiration(TimeSpan.FromSeconds())
                          .SetPriority(CacheItemPriority.Normal)
                          .RegisterPostEvictionCallback(MyCallback, this);

                     }

                     //设置缓存方式二：(通过属性)
                     //{
                     //    cacheOptions = new MemoryCacheEntryOptions();
                     //    cacheOptions.Size = 100;
                     //    //cacheOptions.SlidingExpiration = TimeSpan.FromSeconds(5);
                     //    //绝对和滑动只能设置一个
                     //    cacheOptions.AbsoluteExpiration = new DateTimeOffset(DateTime.Parse("2019-07-16 16:33:10"));
                     //    cacheOptions.Priority = CacheItemPriority.High;
                     //    cacheOptions.RegisterPostEvictionCallback(MyCallback, this);
                     //}
                     _cache2.Set("t4", nowTime4, cacheOptions);

                 }
                 ViewBag.t4 = nowTime4;
             } 

         /// <summary>
         /// 失败回调
         /// </summary>
         /// <param name="key">键</param>
         /// <param name="value">值</param>
         /// <param name="reason">缓存消失的原因，比如移除、过期，是个枚举类型</param>
         /// <param name="state"></param>
         private static void MyCallback(object key, object value, EvictionReason reason, object state)
         {
             var message = $"Cache entry was removed : key={key}，value={value}, reason={reason}, state={state}";
         }

(5) ICacheEntry

　通过属性的形式设置：缓存大小、绝对过期、滑动过期、缓存级别、缓存移除回调，详见案例③

5.即时创建调用 VS 全局单例调用

　首先需要明白，不管即时创建调用还是全局单例调用，MemoryCache都是存在服务器内存中的，这一点是毋庸置疑的。

　(1) 即时创建调用：多个客户端每次访问该方法的时候,都需要现创建一个IMemoryCache对象,然后进行读取或写入。

　(2) 全局单例调用：只要有一个客户端访问该方法，创建IMemoryCache对象，后续不管谁访问，都是使用的同一个对象进行读取或写入。

很傻瓜的一个问题：内存缓存是以键值对的形式进行存储，同一个键如果多次设置会覆盖，但是不同键之间设置过期时间是互相不影响的。

!

• 作       者 : Yaopengfei(姚鹏飞)
• 博客地址 : http://www.cnblogs.com/yaopengfei/
• 声     明1 : 本人才疏学浅，用郭德纲的话说“我是一个小学生”，如有错误，欢迎讨论，请勿谩骂^_^。
• 声     明2 : 原创博客请在转载时保留原文链接或在文章开头加上本人博客地址，否则保留追究法律责任的权利。