.NET Core第27天_CacheTagHelper的使用

-
 


.net core mvc框架微軟有特別封裝緩存標籤協助程序(CacheTagHelper)。
CacheTagHelper:主要用於View中的資料緩存，原生HTML是沒有任何和cache有關的 tag的。


CacheTagHelper主要繼承自CacheTagHelperBase

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
using Microsoft.AspNetCore.Razor.TagHelpers;
using Microsoft.Extensions.Caching.Memory;
using System.Runtime.CompilerServices;
using System.Text.Encodings.Web;
using System.Threading.Tasks;

namespace Microsoft.AspNetCore.Mvc.TagHelpers
{
    //
    // 摘要:
    //     Microsoft.AspNetCore.Razor.TagHelpers.TagHelper implementation targeting <cache>
    //     elements.
    public class CacheTagHelper : CacheTagHelperBase
    {
        //
        // 摘要:
        //     Prefix used by Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelper instances when
        //     creating entries in Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelper.MemoryCache.
        public static readonly string CacheKeyPrefix;

        //
        // 摘要:
        //     Creates a new Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelper.
        //
        // 參數:
        //   factory:
        //     The factory containing the private Microsoft.Extensions.Caching.Memory.IMemoryCache
        //     instance used by the Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelper.
        //
        //   htmlEncoder:
        //     The System.Text.Encodings.Web.HtmlEncoder to use.
        public CacheTagHelper(CacheTagHelperMemoryCacheFactory factory, HtmlEncoder htmlEncoder);

        //
        // 摘要:
        //     Gets or sets the Microsoft.Extensions.Caching.Memory.CacheItemPriority policy
        //     for the cache entry.
        [HtmlAttributeName("priority")]
        public CacheItemPriority? Priority { get; set; }
        //
        // 摘要:
        //     Gets the Microsoft.Extensions.Caching.Memory.IMemoryCache instance used to cache
        //     entries.
        protected IMemoryCache MemoryCache { get; }

        [AsyncStateMachine(typeof(<ProcessAsync>d__11))]
        public override Task ProcessAsync(TagHelperContext context, TagHelperOutput output);
    }
}

而CacheTagHelperBase繼承自TagHelper

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
using Microsoft.AspNetCore.Mvc.Rendering;
using Microsoft.AspNetCore.Mvc.ViewFeatures;
using Microsoft.AspNetCore.Razor.TagHelpers;
using System;
using System.Text.Encodings.Web;

namespace Microsoft.AspNetCore.Mvc.TagHelpers
{
    //
    // 摘要:
    //     Microsoft.AspNetCore.Razor.TagHelpers.TagHelper base implementation for caching
    //     elements.
    public abstract class CacheTagHelperBase : TagHelper
    {
        //
        // 摘要:
        //     The default duration, from the time the cache entry was added, when it should
        //     be evicted. This default duration will only be used if no other expiration criteria
        //     is specified. The default expiration time is a sliding expiration of 30 seconds.
        public static readonly TimeSpan DefaultExpiration;

        //
        // 摘要:
        //     Creates a new Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelperBase.
        //
        // 參數:
        //   htmlEncoder:
        //     The Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelperBase.HtmlEncoder to use.
        public CacheTagHelperBase(HtmlEncoder htmlEncoder);

        public override int Order { get; }
        //
        // 摘要:
        //     Gets or sets the Microsoft.AspNetCore.Mvc.TagHelpers.CacheTagHelperBase.ViewContext
        //     for the current executing View.
        [HtmlAttributeNotBound]
        [ViewContext]
        public ViewContext ViewContext { get; set; }
        //
        // 摘要:
        //     Gets or sets a System.String to vary the cached result by.
        [HtmlAttributeName("vary-by")]
        public string VaryBy { get; set; }
        //
        // 摘要:
        //     Gets or sets a comma-delimited set of HTTP request headers to vary the cached
        //     result by.
        [HtmlAttributeName("vary-by-header")]
        public string VaryByHeader { get; set; }
        //
        // 摘要:
        //     Gets or sets a comma-delimited set of query parameters to vary the cached result
        //     by.
        [HtmlAttributeName("vary-by-query")]
        public string VaryByQuery { get; set; }
        //
        // 摘要:
        //     Gets or sets a comma-delimited set of route data parameters to vary the cached
        //     result by.
        [HtmlAttributeName("vary-by-route")]
        public string VaryByRoute { get; set; }
        //
        // 摘要:
        //     Gets or sets a comma-delimited set of cookie names to vary the cached result
        //     by.
        [HtmlAttributeName("vary-by-cookie")]
        public string VaryByCookie { get; set; }
        //
        // 摘要:
        //     Gets or sets a value that determines if the cached result is to be varied by
        //     the Identity for the logged in Microsoft.AspNetCore.Http.HttpContext.User.
        [HtmlAttributeName("vary-by-user")]
        public bool VaryByUser { get; set; }
        //
        // 摘要:
        //     Gets or sets a value that determines if the cached result is to be varied by
        //     request culture.
        //     Setting this to true would result in the result to be varied by System.Globalization.CultureInfo.CurrentCulture
        //     and System.Globalization.CultureInfo.CurrentUICulture.
        [HtmlAttributeName("vary-by-culture")]
        public bool VaryByCulture { get; set; }
        //
        // 摘要:
        //     Gets or sets the exact System.DateTimeOffset the cache entry should be evicted.
        [HtmlAttributeName("expires-on")]
        public DateTimeOffset? ExpiresOn { get; set; }
        //
        // 摘要:
        //     Gets or sets the duration, from the time the cache entry was added, when it should
        //     be evicted.
        [HtmlAttributeName("expires-after")]
        public TimeSpan? ExpiresAfter { get; set; }
        //
        // 摘要:
        //     Gets or sets the duration from last access that the cache entry should be evicted.
        [HtmlAttributeName("expires-sliding")]
        public TimeSpan? ExpiresSliding { get; set; }
        //
        // 摘要:
        //     Gets or sets the value which determines if the tag helper is enabled or not.
        [HtmlAttributeName("enabled")]
        public bool Enabled { get; set; }
        //
        // 摘要:
        //     Gets the System.Text.Encodings.Web.HtmlEncoder which encodes the content to be
        //     cached.
        protected HtmlEncoder HtmlEncoder { get; }
    }
}

他主要多一層繼承關係



新建CacheController.cs

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Net5App6.Controllers
{
    public class CacheController : Controller
    {
        public IActionResult Index()
        {
            return View();
        }
    }
}




跟相應的Index檢視

1
2
3
4
5
6
7
@{ 
    ViewData["Title"] = "CacheTahHelper Test";
}

<cache>
    @DateTime.Now
</cache>



當運行起來第一次時間跟之後再刷新都是第一次運行的緩存時間點，不會改變。
當再次刷新訪問會從緩存區將資料拿出藉此會發現效率較快，但資料筆叫不即時也可能不太適用需要即時資料更新呈現的網頁資料。


enabled
<cache>預設有一個屬性叫enabled，默認情況為true代表要有緩存機至，而當有特別去設定為false時則會關閉此機制。(較少用)


expires-on
<cache>其實也是有時限的過一陣子(默認20分鐘)在訪問會有更新，那要很精確去設置更新緩存時間則可以用該屬性，可以用於設定絕對緩存到期日期。
要用DateTime設置絕對日期時間點(可到秒)

一個範例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
@{ 
    ViewData["Title"] = "CacheTahHelper Test";
}

<cache>
    時間點(啟動緩存):@DateTime.Now
</cache>
<br>
<cache enabled="false">
    時間點(關閉緩存):@DateTime.Now
</cache>
<br>
<cache expires-on="@new DateTime(2021,8,4,17,5,30)">
    時間點(關閉緩存):@DateTime.Now
</cache>

預設第一個都無論怎麼重整都不變
第二個則是一直變

當超過我們expires-on設置的時間後(超過到8/4下午5點5分30秒後)
可以看到第三個cache 資料也更新了






expires-after 
要用TimeSpan來設置時間區間，用於設定緩存時間長度。
通常會搭配TimeSpan跟FromMinutes()、FromSeconds()等方法設置By分鐘或秒為單位的緩存時長，比方指定過期時間長為30分鐘。

整併上述範本來比較

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
@{
    ViewData["Title"] = "CacheTahHelper Test";
}

<cache>
    時間點(啟動緩存):@DateTime.Now
</cache>
<br>
<cache enabled="false">
    時間點(關閉緩存):@DateTime.Now
</cache>
<br>
<cache expires-on="@new DateTime(2021,8,4,17,5,30)">
    時間點(直到特定時間才更新):@DateTime.Now
</cache>
<br>
<cache expires-after="@TimeSpan.FromSeconds(5)">
    時間點(過一段時間5秒才更新):@DateTime.Now
</cache>


expire-sliding
使用該屬性可以用於設置緩存資料未被存取訪問時該緩存資料要被逐出的時間。

1
2
3
4
5
6
7
@{
    ViewData["Title"] = "CacheTahHelper Test";
}

<cache expires-sliding="@TimeSpan.FromSeconds(5)">
    時間點(expires-sliding):@DateTime.Now
</cache>

比方這裡設置5秒則代表只要在沒超過5秒的期間就刷新，資料會一直保留。
當超過5秒間隔才刷新時緩存就會更新。


vary-by-header
使用該屬性接收逗號分隔的表頭值列表，於表頭有發生更改時候觸發緩存刷新。


vary-by-query
使用該屬性可接收URL上query string後方夾帶參數，以逗號分隔，當參數列表發生改變則更新緩存。



vary-by-route
當路由參數發生改變時觸發緩存更新。




















留言

張貼留言

這個網誌中的熱門文章

何謂淨重(Net Weight)、皮重(Tare Weight)與毛重(Gross Weight)

-
圖片
當談到貨物的重量時，往往會分成所謂的淨重(Net Weight)與毛重(Gross Weight)。 會有以下公式關係存在 淨重=毛重-皮重(包裝物的重量) 毛重=淨重+皮重 淨重( Net Weight 縮寫為N.W.) 指物品本身的重量，不包括容器或包裝材料的重量。 凈重是國際貿易中最常見的計重辦法。 例如，如果運輸原材料，原材料的重量就是所運輸貨物的淨重。包裝原材料的容器或包裝不計入淨重。同樣地，當我們考慮一罐豆子時，罐子內所含物品的重量就算作淨重。因此，淨重將包括豆子、罐頭里的任何液體，以及保存豆子所含的物品。 大多數 以重量為計價的貨物買賣 ，採用此計價方法。 若合同中並未明確規範以何種方式計量和計價時，按慣例以凈重計價。 毛重( Gross Weight 縮寫G.W.) 貨物連同它的包裝的重量，是你托運的所有物品的總重量。 皮重(Tare Weight) 指商品外包裝材料的重量(即運輸包裝的重量)，不包括內包裝材料和襯墊物的重量。 比方一個空的貨櫃、容器、或任何包裝材料的重量。 Net Net Weight純淨重 (指從Net Weight中扣除內包裝後的重量) 進出口商品為了因應運輸及消費需求, 一般都有內包裝與外包裝。 一般在買賣合同與信用狀中,通常只要求於裝箱單上註明Gross Weight和Net Weight即可, 但有些L/C 要求 Net Net Weight,大多是海關徵收從量稅時的依據 運輸重量對於航運業或者航空運輸等各自都通用這些術語 為何特別在意重量? 主要就在於會影響像是傳輸安全乘載限制。 就運輸層面(不同方式的運輸) 航空運輸：對機長而言，毛重包括皮重、產品淨重以及飛機、燃料、乘客和機組人員的重量。 公路/鐵路運輸:對於火車車長而言，毛重包括產品淨重、皮重和運輸車輛的重量。 水路航運運輸：對船長而言，毛重就是淨重和皮重之和。 就公司ERP成本角度 成本一般都會採用 "淨重" 主要是因為若用毛重，可能會有輔材不可控因素存在 比方一個 5cm 固定塑膠件，今天用一個 10cm 紙箱測重，明天用一個 100cm 紙箱測重，那可能就容易導致ERP資料比較會失真。 就物流層面來探討 通常還會有一名詞即所謂「實際重量」(Actual Weight) 根據稱重(過磅)所得到的重量，實際重量分為實際毛重(Gross Weig...
閱讀完整內容

Architecture(架構) 和 Framework(框架) 有何不同?_軟體設計前的事前規劃的藍圖概念

-
圖片
一個應用程式(軟體) 不管是  互動拍照 也好、 投影也好、車牌偵測... 舞台演唱會後方電視牆的互動應用程序、 粒子特效、3D或2D遊戲  等等 開發者通常都需要在一開始做規劃 ㄟ  假設我今天要寫 跟影像有關 可能需要偵測、可能需要提取前景、可能需要偵測圓形 之類的 我有  emgucv 、AForge.Net、 opencv 等等可以用 但是 假設我今天要做的應用程序是需要有視窗介面的~~ emgucv 跟 C# windows form 媒合性 就很高 而且直接在 visual studio 做開發 opencv 我可能還需要依賴 Qt 之類等等  framework 假設我今天是要寫一個 演唱會電視牆互動粒子特效 可能就會挑   openframeworks  、 processing 、kinect 來寫互動 Achitecture  --->全稱 :  Software Architecture   軟體架構 Achitecture   由好多 framework 組成 軟體架構（Software Architecture）是一種軟體在開發前的設計藍圖， 用來告訴軟體的結構，功能，介面，用法，與其他系統的構連以及資料交換等等規範， 但它並沒有叫你要用什麼方式實作， 因此軟體架構通常會產生文件，圖樣，原型以及規格等， 就是沒有可用的程式碼，因為那不是軟體架構應該有的東西， 就像蓋房子時是給你藍圖，而不是一幢蓋好的房子。 軟體框架（Framework):是一個已經成形的方法，而且有程式碼實體 （例如鋼構工法也是要有鋼材才能做），並且會告訴你要如何使用它 （即 Framework Documentation，MSDN Library 即為一最佳例子）
閱讀完整內容

經得起原始碼資安弱點掃描的程式設計習慣培養(五)_Missing HSTS Header

-
圖片
  接續前幾篇系列 經得起原始碼資安弱點掃描的程式設計習慣培養(一)_OWASP Top 10(十大網站安全風險)_學習寫更安全程式碼的網站推薦 經得起原始碼資安弱點掃描的程式設計習慣培養(二)_8.Insecure Deserialization ：不安全的反序列化漏洞ASP.NET處理方式 經得起原始碼資安弱點掃描的程式設計習慣培養(三)_7.Cross Site Scripting(XSS)_Stored XSS_Reflected XSS All Clients 經得起原始碼資安弱點掃描的程式設計習慣培養(四)_1.Injection注入攻擊_SQL Injection)_order by 語句正確參數化套入 最近又遇到被若安掃描到高風險要修正的程式碼啦.... 一看這還真是搞不懂該怎麼修呢 HSTS(HTTP Strict Transport Security)  主要是一份國際標準規格 (RFC 6797) 的網際網路瀏覽安全機制， 用於宣告瀏覽器與伺服器之間通訊方式必須強制採用 TLS/SSL 加密通道。 只要從伺服器端送出一個 Strict-Transport-Security 標頭 (Header) 給瀏覽器，即可告知瀏覽器於未來的某段時間內一律使用 SSL 來和該網站連接 (設定可涵蓋所有子域名網站)， 一旦發生憑證失效情況，使用者將無法再瀏覽該網站，如此一來便可大幅減少中間人攻擊的問題發生。 再更白話一點 HSTS Header 就是負責將 http 強制轉為 https CheckMarx掃碼報告給的說明 ============================================================ 風險: 如果web config沒有設置HSTS表頭、"max-age"(有效期)不足一年， 或沒有設定"includeSubDomains"(包含所有子網域)，可能會使用戶容易遭受中間人攻擊。 發生原因: 許多使用者只要在瀏覽器的網址列輸入網域名稱(Domain Name)即可瀏覽網站， 並沒有輸入協定(Protocol)的名稱。 瀏覽器會自動假設使用者使用的是HTTP協定而不是有加密機制的HTTPS協定。 在第一次發出前往特定網站的請求時，攻擊者可以執行中間人攻擊並將用戶轉址到...
閱讀完整內容