Headless.Caching.Abstractions 0.4.15

.NET 10.0

dotnet add package Headless.Caching.Abstractions --version 0.4.15

NuGet\Install-Package Headless.Caching.Abstractions -Version 0.4.15

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Headless.Caching.Abstractions" Version="0.4.15" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Headless.Caching.Abstractions" Version="0.4.15" />
                    

                            Directory.Packages.props

<PackageReference Include="Headless.Caching.Abstractions" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Headless.Caching.Abstractions --version 0.4.15

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Headless.Caching.Abstractions, 0.4.15"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Headless.Caching.Abstractions@0.4.15

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Headless.Caching.Abstractions&version=0.4.15
                    

                            Install as a Cake Addin

#tool nuget:?package=Headless.Caching.Abstractions&version=0.4.15
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Headless.Caching.Abstractions

Defines the unified caching interface for both in-memory and distributed cache implementations.

Problem Solved

Provides a provider-agnostic caching API, enabling seamless switching between memory and Redis caches without changing application code.

Key Features

ICache - Core interface for all cache operations:
- Upsert/Get/Remove with expiration
- Bulk operations (UpsertAll, GetAll, RemoveAll)
- Prefix-based operations (GetByPrefix, RemoveByPrefix)
- Atomic operations (TryInsert, TryReplace, Increment, SetIfHigher/Lower)
- Set operations (SetAdd, SetRemove, GetSet)
IInMemoryCache - Marker interface for in-memory implementations
IDistributedCache - Marker interface for distributed implementations
ICache<T> - Strongly-typed cache wrapper
CacheValue<T> - Cache result with HasValue semantics

Installation

dotnet add package Headless.Caching.Abstractions

Usage

public sealed class ProductService(ICache cache)
{
    public async Task<Product?> GetProductAsync(int id, CancellationToken ct)
    {
        var key = $"product:{id}";
        var cached = await cache.GetAsync<Product>(key, ct).ConfigureAwait(false);

        if (cached.HasValue)
            return cached.Value;

        var product = await _repository.GetAsync(id, ct).ConfigureAwait(false);
        if (product is not null)
            await cache.UpsertAsync(key, product, TimeSpan.FromMinutes(10), ct).ConfigureAwait(false);

        return product;
    }
}

Configuration

No configuration required. This is an abstractions-only package.

Dependencies

None.

Side Effects

None. This is an abstractions package.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- CommunityToolkit.HighPerformance (>= 8.4.2)
- Headless.Extensions (>= 0.4.15)
- Humanizer.Core (>= 3.0.10)
- IdGen (>= 3.0.7)
- JetBrains.Annotations (>= 2025.2.4)
- libphonenumber-csharp (>= 9.0.30)
- Microsoft.Bcl.TimeProvider (>= 10.0.8)
- morelinq (>= 4.4.0)
- Nito.AsyncEx (>= 5.1.2)
- Nito.Disposables (>= 2.5.0)
- Polly.Core (>= 8.6.6)
- System.Reactive (>= 6.1.0)
- TimeZoneConverter (>= 7.2.0)

NuGet packages (6)

Showing the top 5 NuGet packages that depend on Headless.Caching.Abstractions:

Package	Downloads
Headless.Api.Core Package Description	143
Headless.Features.Core Package Description	100
Headless.Caching.Redis Package Description	89
Headless.Caching.Hybrid Package Description	85
Headless.Caching.Memory Package Description	85