SquidStd.Caching 0.27.0

<h1 align="center">SquidStd.Caching</h1>

In-memory backend for SquidStd.Caching. Provides an IMemoryCache-backed ICacheProvider with absolute TTL and eviction, wired to the shared typed ICacheService facade - registered with a single AddInMemoryCache() call.

The contract lives in SquidStd.Caching.Abstractions, so code written against ICacheService moves unchanged to a distributed cache: use this in-memory provider for single-process apps, tests, and local dev, then swap in SquidStd.Caching.Redis for production. Values are serialized as JSON in both cases, so cached shapes behave the same across providers.

Install

dotnet add package SquidStd.Caching

Usage

Register through the bootstrap - the provider is an ISquidStdService, so StartAsync / StopAsync manage its lifecycle for you:

using SquidStd.Caching.Abstractions.Interfaces;
using SquidStd.Caching.Extensions;
using SquidStd.Services.Core.Extensions;
using SquidStd.Services.Core.Services.Bootstrap;

var bootstrap = SquidStdBootstrap.Create(o => o.ConfigName = "myapp");
bootstrap.ConfigureServices(c => c.RegisterCoreServices().AddInMemoryCache());
await bootstrap.StartAsync();

Get / set with TTL

var cache = bootstrap.Resolve<ICacheService>();

await cache.SetAsync("greeting", "hello", TimeSpan.FromMinutes(5));
var value = await cache.GetAsync<string>("greeting");   // "hello", or default on a miss

var exists = await cache.ExistsAsync("greeting");        // true
var removed = await cache.RemoveAsync("greeting");       // true if the key existed

Omitting the TTL on SetAsync falls back to CacheOptions.DefaultTtl (no expiry when that is null).

Cache-aside with GetOrSetAsync

GetOrSetAsync returns the cached value, or runs the factory, stores the result, and returns it on a miss - the standard cache-aside pattern in one call:

public sealed record UserProfile(string Id, string Name);

var profile = await cache.GetOrSetAsync(
    $"user:{id}",
    async ct => await LoadProfileFromDatabaseAsync(id, ct),
    TimeSpan.FromMinutes(10)
);

Configuration

AddInMemoryCache takes an optional CacheOptions. Options are code-only - this package registers no YAML config section.

c.AddInMemoryCache(new CacheOptions
{
    DefaultTtl = TimeSpan.FromMinutes(5),
    KeyPrefix = "app:"
});

A connection-string overload is also available: AddInMemoryCache("memory://local?defaultTtlSeconds=300&keyPrefix=app:").

CacheMetricsProvider is registered as ICacheMetrics / IMetricProvider and exposes aggregate hit, miss, set, and remove counters plus the hit ratio to the metrics collection system.

Key types

Related

• Article: Caching
• Tutorial: Caching
• Production backend: SquidStd.Caching.Redis

License

MIT - part of SquidStd.