Anexia.Caching.GlobalCache 0.3.2

Anexia Caching

Package with wrapper arround MemoryCache with specified functions to get/set, cache objects.

Installation and configuration

Install the package via NuGet: "Anexia.Caching.GlobalCache"

public class CacheApp : BaseCache<AppModelToCache>
{
	//for MemoryCache
	public CacheApp()
		: base(sizeLimit: null, serializer: UTF8JsonSerializer.Instance)
	{}
	
	//for RedisCache
	public CacheApp(RedisConfigModel config)
		: base(config, typeKey: nameof(AppModelToCache))
	{}
}

protected void Application_Start()
{
	IBaseCache<AppModelToCache> bsCache = new CacheApp();
	bsCache.Insert(
		"key as object",
		"value as object",
		DateTime.UtcNow.AddMinutes(15));
}

Usage

It's a threadsafe implementation for Caching with .Net Standard 2.1. Used in every possible application needed.

Recommended

If you want to use RedisCache, test the Text.Json serializer with your model that you want to cache.
If Text.Json delivers error messages you have to create your own serilizer with the IBaseSerializer.

Testing

If you want to run the Redis cache tests, you have to have a Redis cache running on localhost

List of developers

• Alex Peruzzi <APeruzzi@anexia-it>
• Joachim Eckerl JEckerl@anexia-it.com
• Andreas Aigner AAigner@anexia-it.com

Code Coverage

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.2.1] - 2020-07-15

Added

• GetAllKeys() feature to get all the Keys from Cache object
• GetAllValues() feature to get all the Values from Cache object
• HasKey(key, out result) which checks if key is in the Cache with valid expariation date

Changed

• Fixed serialization bug which made string keys from getAllKeys not valid for cache.

[0.2.2] - 2021-02-10

Added

• Redis cache implemented trough, constructor customizable
• GetAllKeys() feature to get all the Keys from Cache object, works with Redis too
• GetAllValues() feature to get all the Values from Cache object, does not work with Redis cache
• HasKey(key, out result) which checks if key is in the Cache with valid expariation date, works with Redis too without out parameter

Changed

• Fixed serialization bug which made string keys from getAllKeys not valid for cache.

Known Issues

• GetAllKeys() works with Redis only if the port number is set in the configuration, gets all the keys from Redis cache not only which is meant for that region
• HasKey() finds all the keys located in the Cache not just for that region

[0.2.5] - 2021-05-26

Added

• Memory and Redis cache now accept sliding expiration during Insert
• Sliding expiration's default is half of the absolute expiration
• Remove method to delete cache key entry
• RemoveAsync to delete cache key entry async

Changed

• GetAllKeys() now returns keys without type key for Redis Cache

[0.2.6] - 2021-09-30

Added

• HasKeyAsync() for universal and redis cache
• HasKey() without item return for universal and redis cache

Changed

• Asynchronous expiration update after getting an item from redis cache

[0.2.7] - 2021-11-22

Breaking Changed

• ACIM.Sales-Namespaces renamed to Anexia.Caching-Namespaces

[0.2.8] - 2022-02-14

Fix

• Fixed issue, where getting all keys from a redis cache database doesn't work when having connection options defined in the redis' connection string

[0.2.9] - 2022-05-04

Added

• GetAllValues for Redis Cache implemented, use with caution

Fixed

• Asynchronous call in InsertAsync was not awaited

[0.2.10] - 2022-05-05

Fixed

• Connection error for GetAllKeys and GetAllValues

[0.2.11] - 2022-05-09

Fixed

• Task null exception when cache is empty - GetAllValues

[0.2.12] - 2022-05-12

Added

• AcquireLock and ReleaseLock for redis cache; Not implemented for in memory cache, since it is not a distributed cache and already thread safe

[0.3.0] - 2023-07-12

Added

• CI-NuGet-Deployment
• Extended Unit-Tests