DragonHoard's fast in memory cache.
Get Started
$ dotnet add package DragonHoard.InMemoryReadme
Dragon Hoard
Dragon Hoard is a fast, thread safe, developer friendly in-memory caching service.
Setting Up the Library
Dragon Hoard can be set up using the ServiceCollection extension depending on the cache you want to set up:
ServiceCollection.AddInMemoryHoard();
The above code adds the faster/lighter in-memory cache while:
ServiceCollection.AddMemoryCacheHoard();
That allows the system to wrap Microsoft.Extensions.Caching.Memory.MemoryCache. Note that they are in separate Nuget packages so you'll have to download the one that you want.
Basic Usage
The main class of interest is the Cache class found in DragonHoard.Core:
public class ExampleClass
{
public ExampleClass(Cache myCache)
{
MyCache = myCache;
}
private Cache MyCache { get; set; }
public void SomeMethod()
{
var Cache = MyCache.GetOrAddCache("CacheName");
}
}
The Cache object has a singleton lifespan and acts as a repository for your various caches. Note that it's generally a good idea to split caches based on their purpose so they can be treated accordingly and to reduce read/write contention. Once you have the ICache object that the GetOrAddCache method returns you have a couple of methods:
Cache.Set(...) // Used to set a key/value pair in the cache using various settings. You can specify absolute expiration, sliding, priority, size, and any tags that should be associated with the entry.
Cache.Remove(...) // Used to remove an entry based on the key.
Cache.TryGetValue(...) // Used to retrieve an entry from the cache based on the key.
Cache.RemoveByTag(...) // Will remove all entries that have been tagged with the corresponding string.
Cache.GetByTag(...) // Returns an array containing all entries that were tagged using the string.
Cache.Compact(...) // Used to remove a percentage of items from the cache.