TheAdvDistributedOutputCache 1.0.10

TheAdvDistributedOutputCache

TheAdvDistributedOutputCache là middleware Output Caching nâng cao cho ASP.NET Core (.NET 9), hỗ trợ:

✅ Redis + Local Memory Cache
✅ Distributed Lock (RedLock) tránh cache stampede
✅ Per-route TTL Cache
✅ Cache Busting tự động khi có PUT/POST/DELETE
✅ Xóa cache theo pattern & nhiều key liên quan
✅ Redis Key Prefix riêng cho từng project

🚀 Cài đặt

Bạn có thể cài trực tiếp từ NuGet.org:

dotnet add package TheAdvDistributedOutputCache

<PackageReference Include="TheAdvDistributedOutputCache" Version="1.0.*" />

1. Cấu hình appsettings.json 
{
  "CacheOptions": {
    "Prefix": "productA:cache:" 
  }
}

2. Đăng ký Redis Cache + Middleware Trong Program.cs:
using DistributedOutputCache.Cache;
using DistributedOutputCache.Models;
using DistributedOutputCache.Middleware;
using StackExchange.Redis;

var builder = WebApplication.CreateBuilder(args);

// ✅ Load Redis Key Prefix từ cấu hình
builder.Services.Configure<CacheOptions>(
    builder.Configuration.GetSection("CacheOptions")
);

// ✅ Đăng ký Redis & Cache
builder.Services.AddMemoryCache();
builder.Services.AddSingleton<IConnectionMultiplexer>(
    ConnectionMultiplexer.Connect("localhost:6379")
);
builder.Services.AddSingleton<ILocalCacheService, LocalCacheService>();
builder.Services.AddSingleton<IRedisLockHelper>(
    sp => new RedisLockHelper(new[] { "localhost:6379" })
);
builder.Services.AddSingleton<ICacheService, CacheService>();

builder.Services.AddControllers();

var app = builder.Build();

// TTL per-route
var cachePolicies = new List<CacheRoutePolicy>
{
    new CacheRoutePolicy { Pattern = "/api/products/*", Ttl = TimeSpan.FromHours(1) },
    new CacheRoutePolicy { Pattern = "/api/users/*", Ttl = TimeSpan.FromMinutes(5) }
};

// Cache busting rules
var bustingRules = new List<CacheBustingRule>
{
    new CacheBustingRule
    {
        TriggerPattern = "/api/products/*",
        BustPatterns = new[] { "httpcache:/api/products/*" }
    },
    new CacheBustingRule
    {
        TriggerPattern = "/api/users/*",
        BustPatterns = new[]
        {
            "httpcache:/api/users/*",
            "httpcache:/api/users/list*"
        }
    }
};

// ✅ Bật middleware Output Cache
app.UseOutputCache(TimeSpan.FromMinutes(10), cachePolicies, bustingRules);

app.MapControllers();
app.Run();

Cách hoạt động
GET /api/users/123 → cache response trong Redis + local memory
PUT /api/users/123 → tự động xóa cache httpcache:/api/users/123 + /api/users/list*
Distributed Lock tránh nhiều request cùng lúc hit DB
Per-route TTL → mỗi route có thời gian cache riêng

Yêu cầu
ASP.NET Core (.NET 9 trở lên)
Redis server (Standalone hoặc Cluster)

Tùy chọn
Prefix Redis Key → dễ quản lý nhiều project dùng chung Redis
Xóa cache theo pattern → busting nhiều key cùng lúc
Cache riêng từng user (future support)