🏗️ Architecture¶
CoreSystem.Cache.Redis implements the external storage contract consumed by
CoreSystem.Cache.
📋 Registration Flow¶
AddCoreCache()
│
└── CacheOptions
│
▼
AddCoreCacheRedis()
│
├── Redis connection
├── RedisCacheStorage
├── RedisTagIndex
├── Redis health state
└── Optional Redis resilience integration
│
▼
Core.Cache
│
└── IExternalCacheStorage
│
▼
RedisCacheStorage
RedisCacheStorage is registered as IExternalCacheStorage. The Redis provider
therefore supplies the external storage implementation consumed by the core
cache.
🗄️ Redis Storage¶
RedisCacheStorage implements:
GetAsyncSetAsyncRemoveAsyncExistsAsyncInvalidateByTagAsyncGetOrAddAsync
Values are serialized through IPayloadSerializer before being stored in
Redis.
⚡ Cache-Aside and Locking¶
GetOrAddAsync() first checks Redis. When the value is missing, it acquires a
distributed lock, checks Redis again, executes the factory, and stores the
generated value.
🏷️ Tags¶
RedisTagIndex maintains Redis sets for the relationship between cache keys and
tags. This supports tag invalidation and cleanup when entries are removed.
🩺 Health and Resilience¶
The provider registers a Redis health check that verifies connectivity through
PING and maintains Redis health state.
When a Redis resilience pipeline is configured through CoreSystem.Resilience,
Core.Cache.Redis applies Redis connection and timeout exceptions to the
configured retry and circuit-breaker strategies.