microservice.toolkit.cachemanager v0.11.1 — nugetz
MpStyle/microservice.toolkit.cachemanagerv0.11.1
.NET 8.0.NET Std2.1
Common interface to manage cache using different providers.
Get Started
$ dotnet add package microservice.toolkit.cachemanagerbool Set(string, TValue, long);
Task<bool> Set<TValue>(string key, TValue value)
bool Set<TValue>(string, TValue);
Task<bool> Set<TValue>(string key, TValue value, long issuedAt)
Adds an entry in the cache provider without expiration time.
TValue Get(string);
Task<TValue> Get<TValue>(string key)
Delete(string);
Task<bool> Delete(string key);
Removed the entry from the cache provider.
Implementations
In memory
<a name="inmemory"></a>
Naif version of an in-memory cache implementation.
var manager = new InMemoryCacheManager();
You can specify value serializer, choose between "Newtonsoft JSON", "XML" and "System.Text.Json" (default).\
Newtonsoft JSON
Install Newtonsoft JSON dependency:
dotnet add package Newtonsoft.Json --version 13.0.2
var manager = new InMemoryCacheManager(new NewtonsoftJsonCacheValueSerializer());
var manager = new InMemoryCacheManager(new JsonCacheValueSerializer());
var manager = new InMemoryCacheManager(new XmlCacheValueSerializer());
SQLite cache manager
<a name="sqlite"></a>
To start using SQLite cache manager, first install the required package:
<PackageReference Include="Microsoft.Data.SQLite" Version="5.0.10" />
CREATE TABLE cache(
id TEXT PRIMARY KEY,
value TEXT NOT NULL,
issuedAt INTEGER NOT NULL
);
And instantiate the cache manger:
var connectionManager = new SqliteConnection($"[CONNECTION_STRING]");
var manager = new SQLiteCacheManager(connectionManager);
You can specify value serializer, choose between "Newtonsoft JSON", "XML" and "System.Text.Json" (default).\
Newtonsoft JSON
Install Newtonsoft JSON dependency:
dotnet add package Newtonsoft.Json --version 13.0.2
var manager = new SQLiteCacheManager(connectionManager, new NewtonsoftJsonCacheValueSerializer());
var manager = new SQLiteCacheManager(connectionManager, new JsonCacheValueSerializer());
var manager = new SQLiteCacheManager(connectionManager, new XmlCacheValueSerializer());
MySQL cache manager
<a name="mysql"></a>
To start using MySql cache manager, first install the required package:
<PackageReference Include="MySqlConnector" Version="1.3.12" />
CREATE TABLE cache(
id VARCHAR(256) PRIMARY KEY,
value TEXT NOT NULL,
issuedAt BIGINT NOT NULL
);
And instantiate the cache manger:
var connectionManager = new MySqlConnection($"[CONNECTION_STRING]");
var manager = new MysqlCacheManager(connectionManager);
You can specify value serializer, choose between "Newtonsoft JSON", "XML" and "System.Text.Json" (default).\
Newtonsoft JSON
Install Newtonsoft JSON dependency:
dotnet add package Newtonsoft.Json --version 13.0.2
var manager = new MysqlCacheManager(connectionManager, new NewtonsoftJsonCacheValueSerializer());
var manager = new MysqlCacheManager(connectionManager, new JsonCacheValueSerializer());
var manager = new MysqlCacheManager(connectionManager, new XmlCacheValueSerializer());
Memcached
<a name="memcached"></a>
To start using Memcached cache manager, first install the required package:
<PackageReference Include="Enyim.Memcached2" Version="0.6.8" />
var manager = new MemcachedCacheManager("localhost:11211");
Or, if you are using a cluster:
var manager = new MemcachedCacheManager("localhost:11211,localhost:11212");
Redis
<a name="redis"></a>
To start using Redis cache manager, first install the required package:
<PackageReference Include="StackExchange.Redis" Version="2.2.62" />
var manager = new RedisCacheManager("localhost:6379");
You can specify value serializer, choose between "Newtonsoft JSON", "XML" and "System.Text.Json" (default).\
Newtonsoft JSON
Install Newtonsoft JSON dependency:
dotnet add package Newtonsoft.Json --version 13.0.2
var manager = new RedisCacheManager("localhost:6379", new NewtonsoftJsonCacheValueSerializer());
var manager = new RedisCacheManager("localhost:6379", new JsonCacheValueSerializer());
var manager = new RedisCacheManager("localhost:6379", new XmlCacheValueSerializer());
