ICache

This interface is used to mark a class to be a cache object. It gives you the full control on the implementations of your own cache object (i.e.: File Caching, SqLite Caching, XML Caching, Memory Caching, etc).

Methods

Below is the list of methods.

Name	Description
Add	Allows you to add a new cache item value into the cache storage.
Clear	Allows you to clear the cache storage.
Contains	Allows you to check whether the cache item exists by cache-key.
Get	Allows you to get an instance of the cache by cache-key.
Remove	Allows you to remove an existing cache item from the cache storage.

All methods has its own corresponding Async methods.

Use-Cases

You can use this feature to maximize the performance by using the 2nd layer cache for the static and look-up records (or those records that are not frequently changing or not changing at all).

How to Implement?

You have to manually create a class that implements this interface.

public class JsonCache : ICache
{
    public JsonCache(string path,
        string extension)
    {
        Path = path;
        Extension = extension;
        EnsureDirectory();
    }

    /*** Properties ***/

    public string Extension { get; }
    public string Path { get; }

    /*** Methods ***/

    public void Add<T>(string key,
        T value,
        int expiration = 180,
        bool throwException = true)
    {
        ...
    }

    public void Clear()
    {
        ...
    }

    ...
}

You have to implement all the methods needed by this interface. With this, you have the full control of you cacher object.

Usability

You can pass it on the constructor of the BaseRepository object.

public class StateRepository : BaseRepository<State, SqlConnection>
{
    public StateRepository(ISettings settings)
        : base(settings.Value.ConnectionString, new JsonCache(@"C:\cache", "jsoncache"))
    { }
}

And call the query operation like below.

using (var repository = new StateRepository(new AppSettings()))
{
    var states = repository.QueryAll(cacheKey: "CacheKey:States");
}

Or even to the constructor of DbRepository object.

public class DatabaseRepository : DbRepository<SqlConnection>
{
    public DatabaseRepository(ISettings settings)
        : base(settings.Value.ConnectionString, new JsonCache(@"C:\cache", "jsoncache"))
    { }
}

And call the query operation like below.

using (var repository = new DatabaseRepository(new AppSettings()))
{
    var states = repository.QueryAll<State>(cacheKey: "CacheKey:States");
}

Please consider to only create a single cache object within the application and have it passed as a singleton object in any fetch-calls or reporitories.