LinKit.Caching 1.0.0

LinKit.Caching

LinKit.Caching provides high-performance, Zero-Reflection, and Native AOT compatible caching abstractions and providers for LinKit.

🚀 Key Features

• Zero Reflection & Native AOT Ready: No runtime reflection or dynamic type emit. 100% Native AOT & Trimming safe.
• Pluggable Architecture: Includes high-throughput InMemoryCacheProvider out-of-the-box, with easy extension points for Distributed Caches (Redis, Garnet, Memcached).
• Compile-Time Key Resolution: Leverages ICacheKeyResolver<TRequest> for type-safe, compile-time cache key generation.
• Time-to-Live (TTL) & Sliding Expiration: Full support for absolute expiration and sliding expiration windows.

📦 Installation

dotnet add package LinKit.Caching

🛠️ Usage Guide

1. Register Caching Services in Program.cs

using LinKit.Caching;

var builder = WebApplication.CreateBuilder(args);

// Register default high-throughput In-Memory cache
builder.Services.AddLinKitCaching();

// Or supply a custom distributed cache provider (e.g., Redis):
// builder.Services.AddLinKitCaching<RedisCacheProvider>();

2. Inject and Use ICacheProvider

using LinKit.Caching;

public class GetProductByIdHandler : IQueryHandler<GetProductByIdQuery, ProductDto?>
{
    private readonly ICacheProvider _cache;
    private readonly IProductRepository _repository;

    public GetProductByIdHandler(ICacheProvider cache, IProductRepository repository)
    {
        _cache = cache;
        _repository = repository;
    }

    public async Task<ProductDto?> HandleAsync(GetProductByIdQuery query, CancellationToken ct)
    {
        string cacheKey = $"product:{query.ProductId}";

        // 1. Try get from cache
        var cached = await _cache.GetAsync<ProductDto>(cacheKey, ct);
        if (cached is not null)
        {
            return cached;
        }

        // 2. Fetch from database
        var product = await _repository.FindByIdAsync(query.ProductId, ct);
        if (product is not null)
        {
            // 3. Set cache with TTL
            await _cache.SetAsync(cacheKey, product, ttl: TimeSpan.FromMinutes(10), cancellationToken: ct);
        }

        return product;
    }
}

📄 License

Licensed under the MIT License.