.net webapi 客户端缓存 服务端缓存

客户端缓存 - ResponseCacheAttribute

通过设置HTTP的响应头 Cache-Control 来完成页面存储到浏览器缓存中，如果请求在缓存有效期间就直接从浏览器缓存中取出数据。

只需要在接口上方添加ResponseCacheAttribute 特性即可设置客户端缓存。
ResponseCacheAttribute 可应用于：

Razor 页面处理程序（类） – 特性不能应用于处理程序方法。
MVC 控制器（类）。
MVC 操作（方法） – 方法级特性覆盖类级特性中指定的设置。

[ResponseCache] 参数

• Duration 设置缓存的存储时间(以秒为单位)。设置“Cache-control”中的“max-age”。
• Location
• • Any 缓存在代理和客户端。设置“Cache-control”标题为“public”。
    ** Client 只缓存在客户端。设置“Cache-control”标题为“private”。
• • None 每次有请求发出时，缓存会将请求发到服务器 ，服务器端会验证请求中所描述的缓存是否过期，若未过期（注：实际就是返回304），则缓存才使用本地缓存副本。 报头设置为“no-cache”。
• NoStore 缓存中不得存储任何关于客户端请求和服务端响应的内容。每次由客户端发起的请求都会下载完整的响应内容。
• VaryByHeader 使用vary头有利于内容服务的动态多样性。例如，使用Vary: User-Agent头，缓存服务器需要通过UA判断是否使用缓存的页面。
• VaryByQueryKeys 可以按照相同页面，不同的参数进行相应的存储
• CacheProfileName 设置缓存配置文件的值,可以通过设置不同的缓存参数

1. 添加配置

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllersWithViews(options =>
            {
                options.CacheProfiles.Add("default", new CacheProfile
                {
                    Duration = 60
                });

                options.CacheProfiles.Add("test", new CacheProfile
                {
                    Duration = 30
                });
            });
        }

2. 绑定指定的缓存配置

    [ResponseCache(CacheProfileName = "default")]
    public IActionResult Index()
    {
         return View();
   }

服务端缓存

1. 配置
   | MaximumBodySize | 响应正文的最大可缓存大小（以字节为单位）。 默认值为 64 * 1024 * 1024 （64 MB）。 |
   | --------------------- | ------------------------------------------------------ |
   | SizeLimit | 响应缓存中间件的大小限制（以字节为单位）。 默认值为 100 * 1024 * 1024 （100 MB）。 |
   | UseCaseSensitivePaths | 确定是否将响应缓存在区分大小写的路径上。 默认值是 false。 |

        public void ConfigureServices(IServiceCollection services)
        {
              services.AddResponseCaching(options =>
            {
                options.UseCaseSensitivePaths = false;
                options.MaximumBodySize = 1024;
                options.SizeLimit = 100 * 1024*1024;
            });
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app.UseResponseCaching();
        }
        

2. 使用

 [ResponseCache(Duration = 30, VaryByQueryKeys = new[] { "q" })]
        public IActionResult Index(int q)
        {
            _logger.LogWarning($"我是一个路径：{HttpContext.Request.Host}");
            return View(model:DateTime.Now.ToString());
        }

ResponseCache中间件使用的 HTTP 标头

缓存条件

请求必须导致服务器响应，状态代码为200（正常）。
请求方法必须为 GET 或 HEAD。
在 Startup.Configure中，响应缓存中间件必须置于需要缓存的中间件之前。
Authorization 标头不得存在。
Cache-Control 标头参数必须是有效的，并且响应必须标记为 "public" 且未标记为 "private"。
如果 Cache-Control 标头不存在，则 Pragma: no-cache 标头不得存在，因为 Cache-Control 标头在存在时将覆盖 Pragma 标头。
Set-Cookie 标头不得存在。
Vary 标头参数必须有效且不等于 *。
Content-Length 标头值（如果已设置）必须与响应正文的大小匹配。
不使用 IHttpSendFileFeature。
Expires 标头和 max-age 和 s-maxage 缓存指令指定的响应不能过时。
响应缓冲必须成功。 响应的大小必须小于配置的或默认 SizeLimit。 响应的正文大小必须小于配置的或默认的 MaximumBodySize。
"请求" 或 "响应" 标头字段中不得存在 "no-store" 指令。

[参考]
ASP.NET Core ResponseCache进行缓存操作