EasyCaching

EasyCaching is an open-source caching library that contains basic usages and some advanced usages of caching which can help us to handle caching more easily!

CI Build Status

| Platform | Build Server | Master Status | Dev Status | |--------- |------------- |---------|---------| | Github Action | Linux/Windows | | |

Nuget Packages

| Package Name | Version | Downloads |-----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------| --------------------------------------------------------------------------------- | EasyCaching.Core | | | EasyCaching.InMemory | | | EasyCaching.Redis | | | EasyCaching.Memcached | | | EasyCaching.SQLite | | | EasyCaching.HybridCache | | | EasyCaching.CSRedis | | | EasyCaching.FreeRedis | | | EasyCaching.FasterKv | | | EasyCaching.Disk | | | EasyCaching.LiteDB | | | EasyCaching.Interceptor.Castle | | | EasyCaching.Interceptor.AspectCore | | | EasyCaching.Serialization.MessagePack | | | EasyCaching.Serialization.Json | | | EasyCaching.Serialization.SystemTextJson | | | EasyCaching.Serialization.Protobuf | | | EasyCaching.Serialization.MemoryPack | | | EasyCaching.Bus.RabbitMQ | | | EasyCaching.Bus.RabbitMQStream | | | EasyCaching.Bus.Redis | | | EasyCaching.Bus.CSRedis | | | EasyCaching.Bus.ConfluentKafka | | | EasyCaching.Bus.Zookeeper | | | EasyCaching.ResponseCaching | |

Basic Usages

Step 1 : Install the package

Choose caching provider that you need and install it via Nuget.

Install-Package EasyCaching.InMemory
Install-Package EasyCaching.Redis
Install-Package EasyCaching.SQLite
Install-Package EasyCaching.Memcached
Install-Package EasyCaching.FasterKv

Step 2 : Configure Startup class

Each caching provider has it's own configuration options.

Here is a sample configuration for InMemory and Redis caching provider.

public class Startup
{
    //...
    
    public void ConfigureServices(IServiceCollection services)
    {
        //configuration
        services.AddEasyCaching(options => 
        {
            //use memory cache that named default
            options.UseInMemory("default");

            // // use memory cache with your own configuration
            // options.UseInMemory(config => 
            // {
            //     config.DBConfig = new InMemoryCachingOptions
            //     {
            //         // scan time, default value is 60s
            //         ExpirationScanFrequency = 60, 
            //         // total count of cache items, default value is 10000
            //         SizeLimit = 100 
            //     };
            //     // the max random secon