using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Diagnostics.Contracts; using System.Linq; using StardewModdingAPI.Toolkit.Utilities; namespace StardewModdingAPI.Framework.Content { /// A low-level wrapper around the content cache which handles reading, writing, and invalidating entries in the cache. This doesn't handle any higher-level logic like localization, loading content, etc. It assumes all keys passed in are already normalized. internal class ContentCache { /********* ** Fields *********/ /// The underlying asset cache. private readonly IDictionary Cache; /********* ** Accessors *********/ /// Get or set the value of a raw cache entry. /// The cache key. public object this[string key] { get => this.Cache[key]; set => this.Cache[key] = value; } /// The current cache keys. public IEnumerable Keys => this.Cache.Keys; /********* ** Public methods *********/ /**** ** Constructor ****/ /// Construct an instance. /// The asset cache for the underlying content manager. public ContentCache(Dictionary loadedAssets) { this.Cache = loadedAssets; } /**** ** Fetch ****/ /// Get whether the cache contains a given key. /// The cache key. public bool ContainsKey(string key) { return this.Cache.ContainsKey(key); } /**** ** Normalize ****/ /// Normalize path separators in an asset name. /// The file path to normalize. [Pure] [return: NotNullIfNotNull("path")] public string? NormalizePathSeparators(string? path) { return PathUtilities.NormalizeAssetName(path); } /// Normalize a cache key so it's consistent with the underlying cache. /// The asset key. /// This is equivalent to with added file extension logic. [Pure] public string NormalizeKey(string key) { key = this.NormalizePathSeparators(key); return key.EndsWith(".xnb", StringComparison.OrdinalIgnoreCase) ? key[..^4] : key; } /**** ** Remove ****/ /// Remove an asset with the given key. /// The cache key. /// Whether to dispose the entry value, if applicable. /// Returns the removed key (if any). public bool Remove(string key, bool dispose) { // get entry if (!this.Cache.TryGetValue(key, out object? value)) return false; // dispose & remove entry if (dispose && value is IDisposable disposable) disposable.Dispose(); return this.Cache.Remove(key); } /// Purge matched assets from the cache. /// Matches the asset keys to invalidate. /// Whether to dispose invalidated assets. This should only be true when they're being invalidated as part of a dispose, to avoid crashing the game. /// Returns the removed keys (if any). public IEnumerable Remove(Func predicate, bool dispose) { List removed = new List(); foreach (string key in this.Cache.Keys.ToArray()) { if (predicate(key, this.Cache[key])) { this.Remove(key, dispose); removed.Add(key); } } return removed; } } }