TL.Caching.Helpers 0.2.0

⚡ TL.Caching.Helpers

High-performance multilevel caching library for .NET: L1/L2 hybrid cache, RedLock stampede protection, GZip compression, and tenant partitioning.
Biblioteca de caching multinível de alta performance para .NET: cache híbrido L1/L2, proteção contra cache stampede com RedLock, compressão GZip e particionamento por tenant.

O TL.Caching.Helpers disponibiliza uma camada de cache corporativa completa, combinando cache em memória ultrarrápido (L1) com cache distribuído resiliente no Redis (L2). Conta com mecanismos avançados de Distributed Locking (RedLock) para erradicar o problema de Cache Stampede, compressão de tráfego e suporte nativo a isolamento multi-tenant.

📦 Instalação

Adicione o pacote ao seu projeto através do .NET CLI:

dotnet add package TL.Caching.Helpers

🚀 Funcionalidades Principais

💡 Exemplos de Uso

1. Injeção de Dependência no Program.cs

using Caching.Helpers.Extensions;

// Registra Redis distribuído
builder.Services.AddRedisCache(builder.Configuration);

// Registra Cache Hierárquico L1 (Memory) + L2 (Redis)
builder.Services.AddHierarchicalCache(builder.Configuration);

2. Consulta Segura contra Cache Stampede

using Caching.Helpers.Services;

public class CatalogoService
{
    private readonly LockedCacheService _cacheService;

    public CatalogoService(LockedCacheService cacheService)
    {
        _cacheService = cacheService;
    }

    public async Task<List<ProdutoDto>> ObterProdutosDestaqueAsync()
    {
        return await _cacheService.GetOrSetWithLockAsync(
            key: "produtos:destaque",
            factory: async () => await CarregarDoBancoDeDadosAsync(),
            expiration: TimeSpan.FromMinutes(10)
        );
    }

    private static async Task<List<ProdutoDto>> CarregarDoBancoDeDadosAsync()
    {
        await Task.Delay(50);
        return new List<ProdutoDto>
        {
            new("Notebook Corporativo", 4500.00m),
            new("Monitor UltraWide", 1800.00m)
        };
    }
}

public record ProdutoDto(string Nome, decimal Preco);

🏛️ Decisões Arquiteturais e Segurança

Para detalhes sobre locking distribuído, arquitetura de camadas e mitigação de latência:

• 📄 ADR-002: Decisões Arquiteturais do TL.Caching.Helpers

📄 Licença

Distribuído sob a licença MIT.