KeyLockedMemoryCache 1.0.0

KeyLockedMemoryCache

KeyLockedMemoryCache es una librería ligera, rápida y sin dependencias externas que proporciona un sistema de caché en memoria con bloqueo por clave, evitando cargas duplicadas y garantizando acceso thread-safe en aplicaciones .NET.

Funciona en:

• .NET Framework 4.6.1+
• .NET Core 2.0+
• .NET 5/6/7/8
• C#
• VB.NET
• Microservicios en IIS o entornos sin réplicas

Ideal para escenarios donde se necesita un caché local extremadamente rápido sin la complejidad de Redis u otros sistemas distribuidos.

🚀 Características principales

• Thread-safe mediante locking por clave
• Doble chequeo para evitar cargas redundantes
• Cache-aside pattern listo para producción
• Limpieza automática de locks al expirar las claves
• Sin dependencias externas
• Compatible con todo .NET moderno
• Ultra rápido (in-process, sin serialización ni red)

📦 Instalación

Desde NuGet: Install-Package KeyLockedMemoryCache

🧠 Uso básico en C#

----csharp using KeyLockedMemoryCache;

var cache = new InternalCache<User>(30); // Expiración en minutos

var user = cache.GetOrAdd("user", userId, () ⇒ { return LoadUserFromDatabase(userId); });

🧠 Uso básico en VB.NET Imports KeyLockedMemoryCache

Dim cache As New InternalCache(Of User)(30)

Dim user = cache.GetOrAdd("user", userId, Function() Return LoadUserFromDatabase(userId) End Function)

🧩 API InternalCache<T>(int expirationMinutes) Crea una instancia de caché con expiración absoluta por minutos. T GetOrAdd(string prefix, object keyValue, Func<T> loader)

• Devuelve el valor desde caché si existe.
• Si no existe:
• Bloquea por clave
• Ejecuta el loader una sola vez
• Guarda el resultado en caché
• Devuelve el valor void Remove(string prefix, object keyValue) Elimina una entrada del caché y su lock asociado.

🏎️ Rendimiento KeyLockedMemoryCache está diseñado para ser extremadamente rápido:

• Acceso en nanosegundos (in-process)
• Sin serialización
• Sin red
• Sin DI obligatorio
• Sin dependencias pesadas Es ideal para microservicios sin réplicas, aplicaciones en IIS, APIs internas y cualquier escenario donde Redis sería excesivo.

🛠️ Ejemplos de uso comunes

• Cachear resultados de consultas a base de datos
• Cachear configuraciones o catálogos
• Evitar llamadas repetidas a servicios externos
• Reducir carga en microservicios internos
• Mejorar rendimiento en APIs de alta concurrencia

📄 Licencia MIT License.

✨ Autor Desarrollado por Cristian. Optimizado para arquitecturas reales, alto rendimiento y simplicidad.