Merge pull request #5 from Jakab-Laszlo/feature/memory-cache

Memory cache extensions
+semver:minor

Author: tibitoth

src/AutSoft.Core/Caching/MemoryCacheExtensions.cs

@@ -0,0 +1,93 @@
+using Microsoft.Extensions.Caching.Memory;
+
+namespace AutSoft.Common.Caching;
+
+/// <summary>
+/// Extension functions for <see cref="IMemoryCache"/>
+/// </summary>
+public static class MemoryCacheExtensions
+{
+    /// <summary>
+    /// Get or create a cached element with error handling
+    /// </summary>
+    /// <typeparam name="TItem">The type of the cached element</typeparam>
+    /// <param name="cache">An <see cref="IMemoryCache"/> object</param>
+    /// <param name="key">The key of the cached element</param>
+    /// <param name="factory">The factory method, which can create the element if it isn't cached</param>
+    /// <param name="options">Options of the caching</param>
+    /// <returns>The finded or created element</returns>
+    public static async Task<TItem> GetOrCreateWithErrorHandlingAsync<TItem>(
+        this IMemoryCache cache,
+        string key,
+        Func<ICacheEntry, Task<TItem>> factory,
+        MemoryCacheEntryOptions? options = null)
+    {
+        try
+        {
+            return await cache.GetOrCreateAsync(key, entry =>
+            {
+                entry.SetOptions(options);
+                return factory(entry);
+            });
+        }
+        catch
+        {
+            cache.Remove(key);
+            throw;
+        }
+    }
+
+    /// <summary>
+    /// Create or override an element in the cache
+    /// </summary>
+    /// <typeparam name="TItem">The type of the cached element</typeparam>
+    /// <param name="cache">An <see cref="IMemoryCache"/> object</param>
+    /// <param name="key">The key of the cached element</param>
+    /// <param name="value">The cached value</param>
+    /// <param name="size">The size of the cached value</param>
+    /// <param name="options">Options of the caching</param>
+    public static void SetWithErrorHandling<TItem>(
+        this IMemoryCache cache,
+        string key,
+        TItem value,
+        int size,
+        MemoryCacheEntryOptions? options = null)
+    {
+        try
+        {
+            using var entry = cache.CreateEntry(key);
+            entry.SetOptions(options);
+            entry.Size = size;
+            entry.Value = value;
+        }
+        catch
+        {
+            cache.Remove(key);
+            throw;
+        }
+    }
+
+    private static void SetOptions(this ICacheEntry entry, MemoryCacheEntryOptions? options = null)
+    {
+        if (options == null)
+        {
+            entry.AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(1);
+            entry.SlidingExpiration = TimeSpan.FromMinutes(10);
+            entry.Priority = CacheItemPriority.Normal;
+        }
+        else
+        {
+            entry.AbsoluteExpirationRelativeToNow = options.AbsoluteExpirationRelativeToNow;
+            entry.SlidingExpiration = options.SlidingExpiration;
+            entry.Priority = options.Priority;
+        }
+    }
+
+    /// <summary>
+    /// Invalidate a cached element's value
+    /// </summary>
+    /// <param name="cache">An <see cref="IMemoryCache"/> object</param>
+    /// <param name="key">The key of the cached element</param>
+    public static void Invalidate(this IMemoryCache cache, string key)
+        => cache.Remove(key);
+}