SplatDev.Cache.Hybrid 1.0.2

SplatDev.Cache.Hybrid

Microsoft.Extensions.Caching.Hybrid (HybridCache) adapter for SplatDev.Cache abstractions — L1/L2 caching with stampede protection. Requires .NET 10+.

Compatibility

This package targets net10.0 only. For Umbraco 13 (net8.0), use SplatDev.Cache.Redis or the built-in IMemoryCache.

Installation

dotnet add package SplatDev.Cache.Hybrid

Configuration

Basic registration

using SplatDev.Cache.Hybrid.Extensions;

builder.Services.AddHybridCacheProvider();

This registers HybridCache via AddHybridCache() (L1 = IMemoryCache, L2 = configured distributed cache) and exposes it as ICacheProvider.

Custom options

builder.Services.AddHybridCacheProvider(options =>
{
    options.MaximumKeyLength = 1024;
    options.DefaultEntryOptions = new HybridCacheEntryOptions
    {
        Expiration = TimeSpan.FromMinutes(30),
    };
});

With distributed cache (L2)

If you also register a distributed cache (IDistributedCache), HybridCache automatically uses it as the L2 backend:

// L1 = MemoryCache, L2 = Redis
builder.Services.AddStackExchangeRedisCache(o => o.Configuration = "...");
builder.Services.AddHybridCacheProvider();

Usage

using SplatDev.Cache;

public class SessionService
{
    private readonly ICacheProvider _cache;

    public SessionService(ICacheProvider cache) => _cache = cache;

    public async Task<Session?> GetSessionAsync(string sessionId)
    {
        return await _cache.GetOrCreateAsync(
            $"session:{sessionId}",
            async ct => await LoadFromDatabaseAsync(sessionId, ct),
            CacheEntryOptions.WithAbsoluteExpiration(TimeSpan.FromMinutes(20)),
            CancellationToken.None);
    }
}

Features

• Full ICacheProvider implementation backed by Microsoft.Extensions.Caching.Hybrid
• Stampede protection — concurrent requests for the same key share a single factory execution
• L1 cache (IMemoryCache) with configurable local expiration
• Optional L2 distributed cache via IDistributedCache
• Thread-safe by design (HybridCache handles concurrency internally)
• Async-first with sync bridge via GetAwaiter().GetResult()

Known limitations

• Synchronous Get<T> throws InvalidOperationException — use GetOrCreate<T> or async methods.
• .NET 10+ only — the Microsoft.Extensions.Caching.Hybrid package does not support .NET 8.

Dependencies

SplatDev.Cache.Hybrid — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

1.0.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.