RetailSolutions.Shared.Cache 1.2.70

RetailSolutions.Shared.Cache

Biblioteca de abstrações para Redis com suporte a distributed locks usando RedLock.net.

Instalação

dotnet add package RetailSolutions.Shared.Cache

Ou via Package Manager Console:

Install-Package RetailSolutions.Shared.Cache

Uso

Configuração Básica

Registre os serviços Redis no seu HostApplicationBuilder:

using RetailSolutions.Shared.Cache;

var builder = Host.CreateApplicationBuilder(args);

var redisConnectionString = builder.Configuration.GetConnectionString("Redis");
builder.AddRedisLock(redisConnectionString, "NomeDaSuaAplicacao");

Configuração no appsettings.json

Adicione a string de conexão do Redis:

{
  "ConnectionStrings": {
    "Redis": "localhost:6379"
  }
}

Para ambientes de produção, você pode incluir autenticação e outras opções:

{
  "ConnectionStrings": {
    "Redis": "servidor:6379,password=senha,ssl=true,abortConnect=false"
  }
}

Serviços Registrados

O método AddRedisLock registra automaticamente:

• IDistributedLockFactory (singleton) - Factory para criar distributed locks
• IConnectionMultiplexer (scoped) - Conexão direta com Redis

Exemplo: Usando Distributed Lock

using RedLockNet;

public class ProcessamentoService
{
    private readonly IDistributedLockFactory _lockFactory;

    public ProcessamentoService(IDistributedLockFactory lockFactory)
    {
        _lockFactory = lockFactory;
    }

    public async Task ProcessarRecursoCompartilhado()
    {
        var resource = "recurso-compartilhado";
        var expiryTime = TimeSpan.FromSeconds(30);

        await using var redLock = await _lockFactory.CreateLockAsync(
            resource, 
            expiryTime
        );

        if (redLock.IsAcquired)
        {
            // Lógica crítica executada com lock distribuído
            await ProcessarDados();
        }
        else
        {
            // Lock não adquirido, outro processo está usando o recurso
            throw new InvalidOperationException("Recurso está sendo usado por outro processo");
        }
    }

    private Task ProcessarDados() => Task.CompletedTask;
}

Exemplo: Acesso Direto ao Redis

using StackExchange.Redis;

public class CacheService
{
    private readonly IConnectionMultiplexer _redis;

    public CacheService(IConnectionMultiplexer redis)
    {
        _redis = redis;
    }

    public async Task<string?> ObterValorAsync(string chave)
    {
        var db = _redis.GetDatabase();
        var valor = await db.StringGetAsync(chave);
        return valor.ToString();
    }

    public async Task DefinirValorAsync(string chave, string valor, TimeSpan? expiracao = null)
    {
        var db = _redis.GetDatabase();
        await db.StringSetAsync(chave, valor, expiracao);
    }
}

Dependências

• Microsoft.Extensions.Configuration (10.0.0)
• Microsoft.Extensions.DependencyInjection (10.0.0)
• Microsoft.Extensions.Hosting (10.0.1)
• RedLock.net (2.3.2)
• StackExchange.Redis (2.9.25)

Requisitos

• .NET 10.0 ou superior
• Instância Redis disponível

Tags

Gemco, RetailSolutions, Redis, Cache, DistributedLock, RedLock

Licença

Copyright © Retail Solutions