Easy.Cache 1.0.0

Easy.Cache

Easy.Cache is a lightweight, flexible caching library for .NET applications supporting multi-layer caching with MemoryCache and Redis. It provides seamless serialization and optional expiration policies.

Features

• Multi-layer cache with MemoryCache and Redis
• Supports serialization with customizable serializers
• Optional expiration support (absolute and sliding expiration for MemoryCache; absolute expiration for Redis)
• Simple API with async support
• Easily extensible and configurable

Installation

dotnet add package Easy.Cache

Usage

MemoryCache

builder.Services.AddEasyCacheMemory();

Redis

builder.Services.AddEasyCacheRedis("your-redis-connection-string");

Multi-layer (Memory + Redis)

builder.Services.AddEasyCacheMultiLayer("your-redis-connection-string");

Example

public class TestController : ControllerBase
{
    private readonly CacheManager _cache;

    public TestController(CacheManager cache)
    {
        _cache = cache;
    }

    [HttpGet("set")]
    public async Task<IActionResult> SetData()
    {
        TimeSpan absoluteExpiration = TimeSpan.FromMinutes(10);
        TimeSpan slidingExpiration = TimeSpan.FromMinutes(2);

        await _cache.SetAsync("user:1", new { Name = "John", Age = 30 }, absoluteExpiration, slidingExpiration);
        //or
        //for Redis only:
        //await _cache.SetAsync("user:1", new { Name = "John", Age = 30 }, absoluteExpiration);
        //or
        //await _cache.SetAsync("user:1", new { Name = "John", Age = 30 }); // No expiration
        return Ok();
    }

    [HttpGet("get")]
    public async Task<IActionResult> GetData()
    {
        var user = await _cache.GetAsync<dynamic>("user:1");
        return Ok(user);
    }
}

Notes on Expiration

• MemoryCache supports both absolute and sliding expiration.
• Redis supports only absolute expiration (TTL). Sliding expiration is not natively supported on Redis.
• If no expiration is provided, cached data will remain indefinitely until removed.

Serializer

• Easy.Cache uses an ISerializer interface to support flexible serialization. A built-in JSON serializer (JsonCacheSerializer) is provided.

Contributing

• Contributions are welcome. Please open issues or pull requests for improvements or bug fixes.

License

MIT License

� 2025 Elmin Alirzayev / Easy Code Tools