ASP.NET Core缓存静态资源

背景

缓存样式表，JavaScript或图像文件等静态资源能够提升您网站的性能。在客户端，老是从缓存中加载一个静态文件，这样能够减小对服务器的请求数量，从而减小获取页面及其资源的时间。在服务器端，因为它们的请求较少，服务器能够处理更多的客户端而无需升级硬件。

虽然缓存是一件好事，但您必须确保客户端始终运行最新版本的应用程序。当您部署下一个版本的网站时，您不但愿客户端使用过期的缓存版本的文件。

方案:

为确保用户始终使用最新版本的文件，咱们必须为每一个文件版本提供一个惟一的URL。有不少策略：

• 使用查询字符串： http://sample.com/file.js?v=123
• 重命名文件： http://sample.com/file.123.js
• 建立一个目录： http://sample.com/123/file.js

ASP.NET Core提供了一种使用 TagHelper来追加版本与查询字符串的机制。它支持以静态资源为目标的最多见的HTML标签：script，link和img。全部你须要作的是在对应Html标签中追加asp-append-version="true"：

<link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
<script src="~/js/site.js" asp-append-version="true"></script>
<img src="~/images/banner1.svg" asp-append-version="true" />

在浏览器中的展示:

<link rel="stylesheet" href="/css/site.css?v=1wp5zz4e-mOPFx4X2O8seW_DmUtePn5xFJk1vB7JKRc" />
<script src="/js/site.js?v=EWaMeWsJBYWmL2g_KkgXZQ5nPe-a3Ichp0LEgzXczKo"></script>
<img src="/images/banner1.svg?v=GaE_EmkeBf-yBbrJ26lpkGd4jkOSh1eVKJaNOw9I4uk" />

每一个文件都会有对应的V值,并存储在一个
文件的URL如今是惟一的，而且会在文件更改时更改，因此咱们能够将缓存头添加到响应中，以指示客户端文件能够永久存储在缓存中IMemoryCache

实践

为了指示浏览器将文件存储在缓存中，咱们必须发送Cache-control头文件和Expires头文件以实现HTTP/1.0兼容性。为了添加这些头文件，咱们使用了OnPrepareResponse回调函数StaticFilesOptions。咱们来修改这个Startup.cs文件：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseStaticFiles(new StaticFileOptions
    {
        OnPrepareResponse = context =>
        {
            //缓存一年
            if (!string.IsNullOrEmpty(context.Context.Request.Query["v"]))
            {
                context.Context.Response.Headers.Add("cache-control", new[] { "public,max-age=31536000" });
                context.Context.Response.Headers.Add("Expires", new[] { DateTime.UtcNow.AddYears(1).ToString("R") }); // Format RFC1123
            }
        }
    });

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

 能够查看开发者控制台,发现静态资源都被缓存:

若是不想缓存某个静态文件,修改Startup.cs文件:

app.UseStaticFiles(new StaticFileOptions
            {
                OnPrepareResponse = context =>
                {
                    //缓存一年
                    //如下操做是UseStaticFiles内部默认实现
                    if (!string.IsNullOrEmpty(context.Context.Request.Query["v"]))//资源添加asp-append-version="true"后v是查询参数
                    {
                        //context.Context.Response.Headers.Add("cache-control", new[] { "public,max-age=31536000" });
                        context.Context.Response.Headers.Add("cache-control", new[] { "public,no-cache" });
                        context.Context.Response.Headers.Add("Expires", new[] { DateTime.UtcNow.AddYears(1).ToString("R") }); // Format RFC1123
                    }
                }
            });

 会发现不管怎么刷新,site.js?v=7mkNbU1tgQL1bUeZe3j2R151hKLhLDKO4BBaR-iqCy0文件永远都是从新请求,并无使用缓存机制

 

结论

使用HTTP缓存对于性能方面的缘由（客户端和服务器端）很是重要。使用ASP.NET Core，您能够利用提供的功能TagHelpers来生成版本控制的URL，并更改默认配置StaticFilesMiddleware为资源Urls添加header的Cache-control属性 。