BuildingBlocks.Caching

İki paket birlikte hibrit cache stratejisini oluşturur:

BuildingBlocks.Caching — IHybridRequestCache soyutlaması; Microsoft.Extensions.Caching.Hybrid (HybridCache) üzerine stampede protection + tag-based invalidation + multi-instance broadcast hook ekler.
BuildingBlocks.Caching.Redis — L2 backend’i; IDistributedCache implementasyonları ve distributed lock sağlar.

Üst seviye cache mimarisi (L1/L2 stratejisi, invalidation, multi-instance) Cache Mimarisi grubunda anlatılır. Bu sayfa paket arayüzlerine odaklanır.

`IHybridRequestCache`

HybridCache’i doğrudan inject etmek yerine bu arayüz kullanılır — domain-friendly imza ve multi-instance broadcast hook için.

Metot	İmza	Amaç
`GetOrCreateAsync<T>`	`ValueTask<T> GetOrCreateAsync<T>(string key, Func<CancellationToken, ValueTask<T>> factory, HybridCacheEntryOptions? options = null, IReadOnlyCollection<string>? tags = null, CancellationToken = default)`	Cache’te varsa döner, yoksa factory’yi çağırır (stampede-safe)
`RemoveAsync`	`ValueTask RemoveAsync(string key, CancellationToken = default)`	Tek key’i L1+L2’den siler (diğer instance’ların L1’ini etkilemez)
`RemoveByTagAsync`	`ValueTask RemoveByTagAsync(string tag, CancellationToken = default)`	Bir tag’e bağlı tüm entry’leri invalidate eder (lazy); broadcast açıksa diğer node’lara yayılır
`RemoveByTagsAsync`	`ValueTask RemoveByTagsAsync(IReadOnlyCollection<string> tags, CancellationToken = default)`	Toplu tag invalidation
`RemoveByTagLocallyAsync`	`ValueTask RemoveByTagLocallyAsync(string tag, CancellationToken = default)`	Sadece local invalidation — tekrar broadcast yapmaz (loop önleme; integration event handler’ında kullanılır)

`CacheOptions`

Cache bölümüne bind edilir. Yalnızca spec/DB query cache’ini (CachedRepository) etkiler; auth/token cache’leri (UserContext, JWKS, PKCE) HybridCache’i doğrudan kullanır ve bu bayraklardan etkilenmez.

Üye	Tip	Varsayılan	Açıklama
`Enabled`	`bool`	—	Spec/DB query cache kill-switch’i. `false` ise `CachedRepository` raw EFCore’a düşer
`L1`	`CacheTierOptions`	`Ttl = 1 dk`	In-process memory katmanı
`L2`	`CacheTierOptions`	`Ttl = 5 dk`	Redis katmanı (spec `WithCacheTtl(...)` ile per-entry override edebilir)
`BroadcastTagInvalidation`	`bool`	`false`	Multi-instance L1 senkronu için integration event yayını

IRemoteTagBroadcaster çok-instance tag broadcast kontratıdır; varsayılan NoopRemoteTagBroadcaster (tek-node). Multi-pod’da Application katmanı bunu MassTransit/Redis pub-sub implementasyonuyla değiştirir.

DI kaydı — `AddCache`

public static IServiceCollection AddCache(this IServiceCollection services, IConfiguration configuration)
{
    services.Configure<CacheOptions>(o => configuration.GetSection("Cache").Bind(o));
    services.AddMemoryCache();
    services.AddSingleton<IHybridRequestCache, HybridRequestCache>();
    services.TryAddSingleton<IRemoteTagBroadcaster, NoopRemoteTagBroadcaster>();
    return services;
}

{
  "Cache": {
    "Enabled": true,
    "L1": { "Ttl": "00:01:00" },
    "L2": { "Ttl": "00:05:00" },
    "BroadcastTagInvalidation": false
  }
}

Kayıt sırası kritiktir. HybridCache, L2 backend’i (IDistributedCache, Redis) önceden register edilmiş olmasını bekler. Doğru sıra:

builder.Services.AddRedisCache(builder.Configuration);   // 1. L2 backend (IDistributedCache)
builder.Services.AddCache(builder.Configuration);        // 2. IHybridRequestCache + CacheOptions
builder.Services.AddHybridCache(...);                    // 3. HybridCache — L2'yi görür

AddCache HybridCache’i kendisi register etmez — Program.cs AddHybridCache(...)’ı AddRedisCache’ten sonra çağırır. Sıra bozulursa HybridCache L2’yi göremez ve L1-only çalışır.