File: StaticWebAssets\StaticWebAssetsLoader.cs
Web Access
Project: src\src\Hosting\Hosting\src\Microsoft.AspNetCore.Hosting.csproj (Microsoft.AspNetCore.Hosting)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
#nullable enable
 
using System.Diagnostics.CodeAnalysis;
using System.Reflection;
using Microsoft.AspNetCore.StaticWebAssets;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.FileProviders;
 
namespace Microsoft.AspNetCore.Hosting.StaticWebAssets;
 
/// <summary>
/// Loader for static web assets
/// </summary>
public class StaticWebAssetsLoader
{
    /// <summary>
    /// Configure the <see cref="IWebHostEnvironment"/> to use static web assets.
    /// </summary>
    /// <param name="environment">The application <see cref="IWebHostEnvironment"/>.</param>
    /// <param name="configuration">The host <see cref="IConfiguration"/>.</param>
    public static void UseStaticWebAssets(IWebHostEnvironment environment, IConfiguration configuration)
    {
        var manifest = ResolveManifest(environment, configuration);
        if (manifest != null)
        {
            using (manifest)
            {
                UseStaticWebAssetsCore(environment, manifest);
            }
        }
    }
 
    internal static void UseStaticWebAssetsCore(IWebHostEnvironment environment, Stream manifest)
    {
        var staticWebAssetManifest = ManifestStaticWebAssetFileProvider.StaticWebAssetManifest.Parse(manifest);
        var provider = new ManifestStaticWebAssetFileProvider(
            staticWebAssetManifest,
            (contentRoot) => new PhysicalFileProvider(contentRoot));
 
        environment.WebRootFileProvider = new CompositeFileProvider(new[] { provider, environment.WebRootFileProvider });
    }
 
    internal static Stream? ResolveManifest(IWebHostEnvironment environment, IConfiguration configuration)
    {
        try
        {
            var candidate = configuration[WebHostDefaults.StaticWebAssetsKey] ?? ResolveRelativeToAssembly(environment);
            if (candidate != null && File.Exists(candidate))
            {
                return File.OpenRead(candidate);
            }
 
            // A missing manifest might simply mean that the feature is not enabled, so we simply
            // return early. Misconfigurations will be uncommon given that the entire process is automated
            // at build time.
            return default;
        }
        catch
        {
            return default;
        }
    }
 
    [UnconditionalSuppressMessage("SingleFile", "IL3000:Assembly.Location",
        Justification = "The code handles if the Assembly.Location is empty by calling AppContext.BaseDirectory. Workaround https://github.com/dotnet/runtime/issues/83607")]
    private static string? ResolveRelativeToAssembly(IWebHostEnvironment environment)
    {
        if (string.IsNullOrEmpty(environment.ApplicationName))
        {
            return null;
        }
        var assembly = Assembly.Load(environment.ApplicationName);
        var assemblyLocation = assembly.Location;
        var basePath = string.IsNullOrEmpty(assemblyLocation) ? AppContext.BaseDirectory : Path.GetDirectoryName(assemblyLocation);
        return Path.Combine(basePath!, $"{environment.ApplicationName}.staticwebassets.runtime.json");
    }
}
#nullable restore