File: ResourceAssetCollection.cs
Web Access
Project: src\src\Components\Components\src\Microsoft.AspNetCore.Components.csproj (Microsoft.AspNetCore.Components)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
using System.Collections;
using System.Collections.Frozen;
 
namespace Microsoft.AspNetCore.Components;
 
/// <summary>
/// Describes a mapping of static assets to their corresponding unique URLs.
/// </summary>
public sealed class ResourceAssetCollection : IReadOnlyList<ResourceAsset>
{
    /// <summary>
    /// An empty <see cref="ResourceAssetCollection"/>.
    /// </summary>
    public static readonly ResourceAssetCollection Empty = new([]);
 
    private readonly FrozenDictionary<string, ResourceAsset> _uniqueUrlMappings;
    private readonly FrozenSet<string> _contentSpecificUrls;
    private readonly IReadOnlyList<ResourceAsset> _resources;
 
    /// <summary>
    /// Initializes a new instance of <see cref="ResourceAssetCollection"/>
    /// </summary>
    /// <param name="resources">The list of resources available.</param>
    public ResourceAssetCollection(IReadOnlyList<ResourceAsset> resources)
    {
        var mappings = new Dictionary<string, ResourceAsset>(StringComparer.OrdinalIgnoreCase);
        var contentSpecificUrls = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
        _resources = resources;
        foreach (var resource in resources)
        {
            foreach (var property in resource.Properties ?? [])
            {
                if (property.Name.Equals("label", StringComparison.OrdinalIgnoreCase))
                {
                    if (mappings.TryGetValue(property.Value, out var value))
                    {
                        throw new InvalidOperationException($"The static asset '{property.Value}' is already mapped to {value.Url}.");
                    }
                    mappings[property.Value] = resource;
                    contentSpecificUrls.Add(resource.Url);
                }
            }
        }
 
        _uniqueUrlMappings = mappings.ToFrozenDictionary();
        _contentSpecificUrls = contentSpecificUrls.ToFrozenSet();
    }
 
    /// <summary>
    /// Gets the unique content-based URL for the specified static asset.
    /// </summary>
    /// <param name="key">The asset name.</param>
    /// <returns>The unique URL if availabe, the same <paramref name="key"/> if not available.</returns>
    public string this[string key] => _uniqueUrlMappings.TryGetValue(key, out var value) ? value.Url : key;
 
    /// <summary>
    /// Determines whether the specified path is a content-specific URL.
    /// </summary>
    /// <param name="path">The path to check.</param>
    /// <returns><c>true</c> if the path is a content-specific URL; otherwise, <c>false</c>.</returns>
    public bool IsContentSpecificUrl(string path) => _contentSpecificUrls.Contains(path);
 
    // IReadOnlyList<ResourceAsset> implementation
    ResourceAsset IReadOnlyList<ResourceAsset>.this[int index] => _resources[index];
    int IReadOnlyCollection<ResourceAsset>.Count => _resources.Count;
    IEnumerator<ResourceAsset> IEnumerable<ResourceAsset>.GetEnumerator() => _resources.GetEnumerator();
    IEnumerator IEnumerable.GetEnumerator() => _resources.GetEnumerator();
}