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屬性 。