Netcool.Caching 1.0.0

Netcool.Caching

Netcool.Caching offers enhanced extensions for Distributed caching in ASP.NET Core, both MemoryDistributeCache and RedisCache.

Configuration

Distributed Redis cache

builder.Services.AddNetcoolRedisCache(options =>
{
    options.Configuration = "localhost";
});

Distributed Memory Cache

builder.Services.AddNetcoolDistributedMemoryCache();

Use in application service

public class MyService : IService
{
    private readonly INetcoolDistributedCache _cache;

    public MyService(INetcoolDistributedCache cache)
    {
        _cache = cache;
    }

    public void SetCache()
    {
        var obj = new WeatherForecast
        {
            Date = DateTime.Now,
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        };
        _cache.SetObject("WeatherForecast", obj,
            new DistributedCacheEntryOptions { AbsoluteExpiration = DateTimeOffset.Now.AddMinutes(5) });
    }
}

Extensions

Set and get object

cache.SetObject("Person", new Person());
var person = cache.GetObject("Person");

await cache.SetObjectAsync("Person", new Person());
var person =await cache.GetObjectAsync("Person");

Increase and decrease

cache.SetString("count", "1");

var curr = cache.Increase("count",byValue:2, maxValue:10);
var curr2 = await cache.IncreaseAsync("count",2);

var res = cache.GetString("count");
Assert.AreEqual("3", res);
Assert.AreEqual(3, curr);

cache.SetString("count", "1");

var curr = cache.Decrease("count", byValue:2, minValue:1);
var curr2 = await cache.DecreaseAsync("count", byValue:2, minValue:1);

var res = cache.GetString("count");
Assert.AreEqual(1, curr);
Assert.AreEqual("1", res);

Object Serializer

The default object serializer is SystemTextJsonSerializer, you can change the JsonSerializerOptions.

builder.Services.AddNetcoolRedisCache(options =>
{
    options.Configuration = "localhost";
    options.ObjectSerializer = new SystemTextJsonSerializer(new JsonSerializerOptions());
});

Otherwise, you can customize your own serializer:

public class MySerializer : ISerializer
{
    private readonly JsonSerializerOptions _jsonSerializerOptions;

    public byte[] Serialize<T>(T obj)
    {
        return Encoding.UTF8.GetBytes(obj.ToString());
    }

    public T Deserialize<T>(byte[] bytes)
    {
        return (T)Convert.ChangeType(Encoding.UTF8.GetString(b).ToString(), typeof(T));
    }
}

Then configure at startup:

builder.Services.AddNetcoolRedisCache(options =>
{
    options.Configuration = "localhost";
    options.ObjectSerializer = new MySerializer();
});