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 : 原创博客请在转载时保留原文链接或在文章开头加上本人博客地址，否则保留追究法律责任的权利。