index.md

DKNet.AspCore.Idempotency.RedisStore

Redis-backed reservations and TTL-based response retention for .NET developers using DKNet idempotency.

✨ Why use it?

• Share a key ledger across hosts connected to the same Redis database.
• Reserve keys atomically without relational schema migrations.
• Expire reservations and completed values through Redis TTLs.

🚀 Quick Start

Use a .NET 10 ASP.NET Core project.

dotnet new web -f net10.0 -n PackageDemo
cd PackageDemo
dotnet add package DKNet.AspCore.Idempotency.RedisStore

Replace Program.cs with the example, then run dotnet run.

Set ConnectionStrings__Redis to a reachable Redis connection string. The Redis server must support the atomic SET NX GET operation used by StackExchange.Redis.

using DKNet.AspCore.Idempotency;
using DKNet.AspCore.Idempotency.RedisStore;
var builder = WebApplication.CreateBuilder(args);
var connection = builder.Configuration.GetConnectionString("Redis")
    ?? throw new InvalidOperationException("Set ConnectionStrings__Redis.");
builder.Services.AddIdempotencyWithRedisStore(connection);
var app = builder.Build();
app.MapPost("/orders", () => Results.Ok(new { Accepted = true }))
    .RequiredIdempotentKey();
await app.RunAsync();

POST twice with X-Idempotency-Key: order-1. The first returns 200 and the retry 409. Instances sharing this Redis database and prefix share the ledger.

🏗️ Architecture

The app supplies reachable Redis infrastructure. Existing multiplexer and distributed-cache registrations are retained independently; the store uses the multiplexer directly. No relational base, context or migration service participates.

🔄 How it works

The core filter decides 409 versus replay. Reservations expire separately from completed entries. Redis loss or eviction and handlers exceeding the reservation lifetime can permit another execution.

🧩 Features

• Register Redis connections and select the store — Reuse Redis connections and select the internal store.
• Reserve Redis keys and retain response values — Trace atomic set-and-get reservation, logical expiry, and TTL writes.

🔗 Related packages

• Idempotency — configure declaration, validation and replay.
• MsSqlStore — choose a SQL Server ledger.
• NpgsqlStore — choose PostgreSQL.
• Relational — read the shared SQL implementation, which Redis does not use.