本文主要介紹了快取的概念,以及如何在伺服器記憶體中儲存內容。今天的目標是利用IDistributedCache來做一些分散式快取,這樣我們就可以橫向擴充套件我們的web應用程式。
在本教程中,我將使用Redis作為快取。Redis是一個可靠的快速記憶體快取,可以儲存多種型別的物件。Redis正在被Twitter, Github, Instagram, Stackoverflow等巨頭使用。
你可以在https://github.com/sahan91/DistributedCacheAspNetCoreRedis找到示例程式碼。
這是我們實現後的一個快照。
- 使用者請求一個User物件。
- App server檢查快取中是否已經有使用者,如果存在則返回物件。
- App server通過HTTP呼叫來檢索使用者列表。
- Users service將使用者列表返回給App server。
- App server將使用者列表傳送到分散式(Redis)快取。
- App server獲得快取的版本,直到它過期(TTL)。
- 使用者獲取快取的User物件。
我們稱其為分散式快取的主要原因是,它位於應用伺服器之外(與傳統的記憶體快取相反),如果需要的話,我們可以靈活地水平擴充套件它(在雲中操作時)。來看看在企業應用程式中是如何有用的。
IDistributedCache介面為我們提供了一組操作快取的方法。這裡總結了幾種不同的方法。
搭建一個示例應用程式
我們將用ASP.NET Core 5建立一個Web MVC應用程式。
dotnet new mvc -n DistributedCachedotnet new slndotnet sln add DistributedCache
讓我們繼續從NuGet新增Redis客戶端包。
dotnet add package Microsoft.Extensions.Caching.StackExchangeRedis --version 5.0.1
建立一個Redis docker容器
假設已經在你的機器上安裝了Docker。這是很方便的,你可以在任何想要開發的時候啟動自己的Redis容器。
docker run --name redis-cache -p 5002:6379 -d redis
使用官方的Redis映象,建立一個名為redis-cache的容器,並將容器的6379埠繫結到主機的5002埠。如果你在本地沒有Redis的映象,它會從DockerHub獲取它。接下來讓我們驗證docker例項是否啟動並執行。
docker ps -a
現在我們已經有了Redis容器並執行,接下來配置我們的web應用程式。
應用程式配置
因為我們已經新增了所需的NuGet包,我們只需要在應用的DI容器中註冊,並告訴它在哪裡可以找到我們的Redis例項。
services.AddStackExchangeRedisCache(options =>{ options.Configuration = Configuration.GetSection("Redis")["ConnectionString"]; });
當我們在服務物件上呼叫AddStackExchangeRedisCache時,它會在底層通過IDistributedCache介面註冊一個RedisCache類的單例。
services.Add(ServiceDescriptor.Singleton<IDistributedCache, RedisCache>());
因為我們已經在5002埠上啟動並執行了Docker例項,所以我們可以在配置中設定它。
"Redis": { "ConnectionString": "localhost:5002"}
實現
這個功能很簡單,下面是我們要做的:
- 獲取快取的使用者(如果有的話)並顯示其電子郵件地址
- 用於呼叫HTTP快取使用者列表的按鈕
- 清除快取的按鈕
UI將類似於以下。
讓我們看看程式的入口,HomeController類。
public async Task<IActionResult> Index(){ var users = (await _cacheService.GetCachedUser())?.FirstOrDefault(); return View(users); } public async Task<IActionResult> CacheUserAsync(){ var users = await _usersService.GetUsersAsync(); var cacheEntry = users.First(); return View(nameof(Index), cacheEntry); } public IActionResult CacheRemoveAsync(){ _cacheService.ClearCache(); return RedirectToAction(nameof(Index)); }
這裡的程式碼很容易解釋,我們在Index、CacheUserAsync和cacheeremoveasync中實現了之前的3個內容。
跳過所有其他管道程式碼,並展示我們如何使用Redis快取獲取和設定值。真正神奇的事情發生在ICacheProvider類中。
在GetFromCache方法中,我們使用給定的鍵(在本例中為_Users)呼叫GetStringAsync。值得注意的是,在將它返回給呼叫者之前,我們需要將它反序列化為我們想要的型別。類似地,序列化我們的使用者列表,並將它作為字串儲存在Redis快取中的_Users鍵下。
public class CacheProvider : ICacheProvider{ private readonly IDistributedCache _cache; public CacheProvider(IDistributedCache cache) { _cache = cache; } public async Task<T> GetFromCache<T>(string key) where T : class { var cachedResponse = await _cache.GetStringAsync(key); return cachedResponse == null ? null : JsonSerializer.Deserialize<T>(cachedResponse); } public async Task SetCache<T>(string key, T value, DistributedCacheEntryOptions options) where T : class { var response = JsonSerializer.Serialize(value); await _cache.SetStringAsync(key, response , options); } public async Task ClearCache(string key) { await _cache.RemoveAsync(key); } }
我們可以連線到容器,開啟redis-cli檢視裡面有什麼。
docker exec -it redis-cache redis-cli
進入後,可以發出hgetall _Users命令來檢查快取中有哪些內容。
結論
在本文中,我們將使用ASP.NET Core提供的IDistributedCache介面,使用Redis作為後臺儲存。這種方法可以用來利用Azure Redis快取等雲服務,用於響應快取、會話儲存等。
原文連結:https://sahansera.dev/distributed-caching-aspnet-core-redis/