Net.Cache 1.3.1

Net.Cache

Overview

Net.Cache is a comprehensive caching library for .NET, designed to offer versatile tools for cache management. The library focuses on facilitating key-value based caching operations and provides a default implementation with InMemoryStorageProvider. It allows for easy integration and extension, enabling developers to use different caching strategies while maintaining a consistent interface.

Features

• Generic Caching Mechanism: Supports any data type for keys and values, requiring keys to be equatable and non-nullable.
• Default In-Memory Caching: Includes InMemoryStorageProvider for out-of-the-box in-memory caching.
• Customizable Storage Providers: Easily extend or implement custom storage providers to suit various caching needs.
• Retrieval and Management: Utilize Get, Add, Delete, and Update methods for managing cache contents.
• Dynamic Cache Management: Efficiently handle caching with the ability to dynamically add or update values when not present using GetOrAdd.

Getting Started

Installation

Install Net.Cache via the NuGet package manager or clone the repository into your project.

Usage

Implementing Custom Storage Providers

Create custom storage providers by implementing the IStorageProvider<TKey, TValue> interface. Alternatively, use the provided InMemoryStorageProvider<TKey, TValue>.

var inMemoryStorage = new InMemoryStorageProvider<int, string>();

Using CacheProvider

Manage your caching logic with CacheProvider<TKey, TValue>, which can handle multiple storage providers including custom ones.

var cache = new CacheProvider<int, string>(inMemoryStorage);

Storing, Retrieving, and Managing Values

// Storing a value
cache.Add(1, "Hello World");

// Retrieving a value
string value = cache.Get(1); // Outputs: Hello World

// Updating a value
cache.Update(1, "Updated Value");

// Deleting a value
cache.Delete(1);

Adding Values Dynamically

Leverage the GetOrAdd method to add values to the cache dynamically if they don't already exist, with or without additional parameters.

// Adding a value dynamically without parameters
string value = cache.GetOrAdd(2, () => "New Value");

// Adding a value dynamically with parameters
string complexValue = cache.GetOrAdd(3, x => $"Value with {x.Length} parameters", "param1", "param2");