Cirreum.QueryCache.Distributed 1.0.16

Cirreum.QueryCache.Distributed

Distributed caching adapter for Cirreum Conductor's query caching system

Overview

Cirreum.QueryCache.Distributed provides a distributed caching implementation for the Cirreum Conductor framework by adapting ASP.NET Core's IDistributedCache interface to Cirreum's ICacheableQueryService. This enables caching of CQRS query results across multiple application instances using any distributed cache provider (Redis, SQL Server, NCache, etc.).

Installation

dotnet add package Cirreum.QueryCache.Distributed

Usage

// In your Startup.cs or Program.cs
services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = "localhost:6379";
});

// Add Cirreum distributed query caching
services.AddDistributedQueryCaching();

The service automatically registers as a singleton implementation of ICacheableQueryService and uses the configured IDistributedCache for storage.

Configuration Options

You can optionally configure JSON serialization options:

services.AddDistributedQueryCaching(options =>
{
    options.JsonSerializerOptions = new JsonSerializerOptions
    {
        PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
        DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
    };
});

Features

• Distributed Cache Integration: Works with any IDistributedCache implementation
• JSON Serialization: Configurable JSON serialization for cached objects
• Failure Expiration: Supports different cache durations for failed results
• Async Operations: Fully async with CancellationToken support
• Conductor Integration: Seamlessly integrates with Cirreum Conductor's caching pipeline

Limitations

• No Tag-Based Eviction: The RemoveByTagAsync and RemoveByTagsAsync methods are not supported due to IDistributedCache limitations. These methods will throw NotSupportedException.
• Requires External Cache: This package doesn't provide a distributed cache implementation. You must configure one separately (e.g., Redis, SQL Server, NCache).

Requirements

• .NET 10.0 or later
• Cirreum.Core 1.0.16 or later
• A configured IDistributedCache implementation

Contribution Guidelines

1. Be conservative with new abstractions
   The API surface must remain stable and meaningful.

2. Limit dependency expansion
   Only add foundational, version-stable dependencies.

3. Favor additive, non-breaking changes
   Breaking changes ripple through the entire ecosystem.

4. Include thorough unit tests
   All primitives and patterns should be independently testable.

5. Document architectural decisions
   Context and reasoning should be clear for future maintainers.

6. Follow .NET conventions
   Use established patterns from Microsoft.Extensions.* libraries.

Versioning

Cirreum.QueryCache.Distributed follows Semantic Versioning:

• Major - Breaking API changes
• Minor - New features, backward compatible
• Patch - Bug fixes, backward compatible

Given its foundational role, major version bumps are rare and carefully considered.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Cirreum Foundation Framework
Layered simplicity for modern .NET