CacheOrchestrator.EFCore.Invalidation 3.0.0-beta.2

CacheOrchestrator.EFCore.Invalidation

CacheOrchestrator unifies the configuration of Output Cache, data cache, and client Cache-Control within a single domain model. It ensures seamless coordination and cache invalidation across all layers while significantly reducing boilerplate code.

This package hooks EF Core SaveChanges: map a CLR type to (domain, entityKind); after a successful save, matching entity tags are purged through ICacheOrchestratorInvalidator.

Install

dotnet add package CacheOrchestrator.EFCore.Invalidation --prerelease

Config

Domain policy (same as the rest of CacheOrchestrator). Optional interceptor options:

{
  "Cache": {
    "Domains": {
      "catalog": {
        "Version": "1",
        "DataCache": { "TtlSeconds": 300 },
        "OutputCache": { "TtlSeconds": 60 }
      }
    },
    "EFCore": {
      "Invalidation": {
        "Enabled": true
      }
    }
  }
}

Example

dotnet add package CacheOrchestrator --prerelease
dotnet add package CacheOrchestrator.EFCore.Invalidation --prerelease

builder.Services.AddCacheOrchestrator(builder.Configuration);
builder.Services.AddCacheOrchestratorEfCoreInvalidation(builder.Configuration);

builder.Services.AddDbContext<AppDbContext>((sp, opt) =>
{
    opt.UseSqlServer(connectionString);
    opt.AddCacheOrchestratorInvalidation(sp);
});

// In OnModelCreating (or Map<T> / [CacheEntity]):
// modelBuilder.Entity<Product>().CacheInvalidate("catalog", "products");

var app = builder.Build();
app.UseCacheOrchestrator();

app.MapGet("/api/products/{id}", async (HttpContext http, string id, IDomainDataCache cache, AppDbContext db) =>
{
    var data = await cache.GetOrSetEntityAsync(http, async ct =>
    {
        Product? p = await db.Products.AsNoTracking().FirstOrDefaultAsync(x => x.Id.ToString() == id, ct);
        return p is null ? null : new ProductDto(p.Id, p.Price);
    });
    return data is null ? Results.NotFound() : Results.Json(data);
})
.CacheOutputWithDomain("catalog", resourceRouteKey: "id", entityKind: "products");

app.MapPut("/api/products/{id}", async (string id, UpdatePriceBody body, AppDbContext db, CancellationToken ct) =>
{
    Product product = await db.Products.SingleAsync(x => x.Id.ToString() == id, ct);
    product.Price = body.Price;
    await db.SaveChangesAsync(ct); // interceptor invalidates — no manual Invalidate*
    return Results.NoContent();
});

Tracked SaveChanges invalidates automatically; ExecuteUpdate / ExecuteDelete require manual Invalidate*. More layouts: composition §8–§9 · composition how-to.

Related packages

Documentation

• EF Core invalidation
• Packages and composition · composition how-to
• Repository

License

MIT — LICENSE.md