快速入门：使用 .NET Aspire 组件实现缓存

标签：缓存 AspireRedis cache 应用程序 Aspire NET

前言

云原生应用程序通常需要各种类型的可扩展缓存解决方案来提高性能。.NET Aspire 组件简化了连接到流行的缓存服务（例如 Redis）的过程，今天小编就为大家简单介绍一下如何使用 .NET Aspire 组件实现缓存。

本文的内容概要：

创建一个设置为使用 .NET Aspire 的基本 ASP.NET Core 应用程序。
添加.NET Aspire组件以连接到Redis并实现缓存。
配置 .NET Aspire 组件以满足特定要求。

环境准备

要使用 .NET Aspire，需要在本地安装以下软件：

.NET 8.0
.NET Aspire 工作负载：
使用 Visual Studio 安装程序
使用 dotnet workload install aspire 命令
Docker 桌面
集成开发环境 (IDE) 或代码编辑器，例如：
Visual Studio 2022 预览版 17.9 或更高版本（可选）
Visual Studio 代码（可选）

有关详细信息，请参阅.NET Aspire 设置和工具。

举例示范

1.新建一个工程文件

在 Visual Studio 顶部，导航到“文件” “新建” “项目...”。
在对话框窗口中，在项目模板搜索框中输入.NET Aspire ，然后选择.NET Aspire Starter Application。选择下一步。
在“配置新项目”屏幕上：

输入项目名称AspireRedis。
将其余值保留为默认值，然后选择“下一步”。

在附加信息屏幕上：

选择.NET 8.0 。
取消选中“使用 Redis 进行缓存”
最后选择创建。

Visual Studio 创建了一个新的 .NET Aspire 解决方案，其中包含以下项目：

AspireRedis.Web 具有默认 .NET Aspire 配置的 Blazor UI 项目。
AspireRedis.ApiService 具有默认 .NET Aspire 配置的最小 API，可为前端提供数据。
AspireRedis.AppHost 一个协调器项目，旨在连接和配置应用程序的不同项目和服务。
AspireRedis.ServiceDefaults 一个 .NET Aspire 共享项目，用于管理解决方案中与弹性、服务发现和遥测相关的项目中重复使用的配置。

2.使用输出缓存配置 UI

将.NET Aspire StackExchange Redis 输出缓存组件包添加到您的AspireStorage应用程序中：

dotnet add package Aspire.StackExchange.Redis.OutputCaching --prerelease

（1）在Blazor 项目的Program.csAspireRedis.Web文件中，紧接着该行之后，添加对AddRedisOutputCachevar builder = WebApplication.CreateBuilder(args);扩展方法的调用：

builder.AddRedisOutputCache("cache");

（2）在项目的_appsettings.json文件中AspireRedis.Web，添加对应的连接字符串信息：

"ConnectionStrings": {
  "cache": "localhost:6379"
}

（3）将 Blazor 项目的Home.razor文件的内容替换AspireRedis.Web为以下内容：

@page "/"
@attribute [OutputCache(Duration = 10)]

<PageTitle>Home</PageTitle>

<h1>Hello, world!</h1>

Welcome to your new app on @DateTime.Now

该组件包含该[OutputCache]属性，该属性缓存整个呈现的响应。该页面还包含一个调用@DateTime.Now来帮助验证响应是否已缓存。

3.使用分布式缓存配置 API

将.NET Aspire StackExchange Redis 分布式缓存组件包添加到您的AspireRedis应用程序中：

dotnet add package Aspire.StackExchange.Redis.DistributedCaching --prerelease

（1）在Program.cs文件的顶部，添加对AddRedisDistributedCache 的调用：

builder.AddRedisDistributedCache("cache");

（2）在项目的_appsettings.json文件中AspireRedis.ApiService，添加对应的连接字符串信息：

"ConnectionStrings": {
  "cache": "localhost:6379"
}

（3）在Program.cs文件中，将现有/weatherforecast端点代码替换为以下内容：

app.MapGet("/weatherforecast", async (IDistributedCache cache) =>
{
    var cachedForecast = await cache.GetAsync("forecast");

    if (cachedForecast is null)
    {
        var summaries = new[] { "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching" };
        var forecast = Enumerable.Range(1, 5).Select(index =>
        new AspireRedis.WeatherForecast
        (
            DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
            Random.Shared.Next(-20, 55),
            summaries[Random.Shared.Next(summaries.Length)]
        ))
        .ToArray();

        await cache.SetAsync("forecast", Encoding.UTF8.GetBytes(JsonSerializer.Serialize(forecast)), new ()
        {
            AbsoluteExpiration = DateTime.Now.AddSeconds(10)
        }); ;

        return forecast;
    }

    return JsonSerializer.Deserialize<IEnumerable<AspireRedis.WeatherForecast>>(cachedForecast);
})
.WithName("GetWeatherForecast");

4.配置应用程序宿主项目

更新项目的Program.csAspireRedis.AppHost文件以匹配以下代码：

var builder = DistributedApplication.CreateBuilder(args);

var redis = builder.AddRedisContainer("cache");

var apiservice = builder.AddProject<Projects.AspireRedis_ApiService>("apiservice")
    .WithReference(redis);

builder.AddProject<Projects.AspireRedis_Web>("webfrontend")
    .WithReference(apiservice)
    .WithReference(redis);

builder.Build().Run();

最后：在本地运行并测试应用程序

使用以下步骤测试应用程序的缓存行为：