NewLife.Redis.Extensions

NewLife.Redis.Extensions

ASP.NET Core Redis 深度集成扩展

NewLife.Redis.Extensions 是 NewLife.Redis 为 ASP.NET Core 提供的官方集成扩展包，提供 IDistributedCache 分布式缓存、IDataProtection 密钥持久化、DI 自动注入等开箱即用能力。

🆕 本包是旧包 NewLife.Extensions.Caching.Redis（v5.5）的继任者。如果你正在使用旧包，请参阅迁移指引。

功能概览

安装

dotnet add package NewLife.Redis.Extensions

快速开始

注册服务

using NewLife.Redis.Extensions;

var builder = WebApplication.CreateBuilder(args);

// 一行注册，自动注入 FullRedis / IDistributedCache / ICache / ICacheProvider
builder.Services.AddDistributedRedisCache(options =>
{
    options.Server   = "127.0.0.1:6379";
    options.Password = "pass";
    options.Db       = 0;
    options.Prefix   = "myapp:";
});

使用 IDistributedCache

public class HomeController : Controller
{
    private readonly IDistributedCache _cache;

    public HomeController(IDistributedCache cache)
    {
        _cache = cache;
    }

    public async Task<IActionResult> Index()
    {
        var value = await _cache.GetStringAsync("greeting");
        if (value == null)
        {
            value = "Hello, Redis!";
            await _cache.SetStringAsync("greeting", value,
                new DistributedCacheEntryOptions { AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(1) });
        }
        return Content(value);
    }
}

使用 FullRedis 完整功能

由于 RedisCache 继承自 FullRedis，注入后可直接使用全部 Redis 数据结构：

public class UserService
{
    private readonly FullRedis _redis;

    public UserService(FullRedis redis)
    {
        _redis = redis;
    }

    public void SaveUser(User user)
    {
        var list = _redis.GetList<User>("users");
        list.Add(user);

        var hash = _redis.GetDictionary<String>("user:" + user.Id);
        hash["Name"]  = user.Name;
        hash["Email"] = user.Email;
    }
}

数据保护密钥持久化

builder.Services.AddDataProtection()
    .PersistKeysToRedis(redis, "DataProtection-Keys");

更多 Redis 操作请参考 NewLife.Redis 主文档。

从旧包迁移

本包是 NewLife.Extensions.Caching.Redis（v5.5）的直接继任者，提供了更好的架构和更多功能：

迁移步骤：

1. 卸载旧包、安装新包
2. 更换命名空间：NewLife.Extensions.Caching.Redis → NewLife.Redis.Extensions
3. 更换 DI 注册方式：services.AddRedis(configString) → services.AddDistributedRedisCache(options => {...})

相关链接

• NewLife.Redis 主仓库
• NewLife.Redis 中文文档
• NuGet 包
• 新生命团队官网