File: Infrastructure\FileContentResultExecutor.cs
Web Access
Project: src\src\Mvc\Mvc.Core\src\Microsoft.AspNetCore.Mvc.Core.csproj (Microsoft.AspNetCore.Mvc.Core)
// 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 Microsoft.Extensions.Logging;
using Microsoft.Net.Http.Headers;
 
namespace Microsoft.AspNetCore.Mvc.Infrastructure;
 
/// <summary>
/// A <see cref="IActionResultExecutor{FileContentResult}"/>
/// </summary>
public partial class FileContentResultExecutor : FileResultExecutorBase, IActionResultExecutor<FileContentResult>
{
    /// <summary>
    /// Intializes a new <see cref="FileContentResultExecutor"/>.
    /// </summary>
    /// <param name="loggerFactory">The factory used to create loggers.</param>
    public FileContentResultExecutor(ILoggerFactory loggerFactory)
        : base(CreateLogger<FileContentResultExecutor>(loggerFactory))
    {
    }
 
    /// <inheritdoc />
    public virtual Task ExecuteAsync(ActionContext context, FileContentResult result)
    {
        ArgumentNullException.ThrowIfNull(context);
        ArgumentNullException.ThrowIfNull(result);
 
        Log.ExecutingFileResult(Logger, result);
 
        var (range, rangeLength, serveBody) = SetHeadersAndLog(
            context,
            result,
            result.FileContents.Length,
            result.EnableRangeProcessing,
            result.LastModified,
            result.EntityTag);
 
        if (!serveBody)
        {
            return Task.CompletedTask;
        }
 
        return WriteFileAsync(context, result, range, rangeLength);
    }
 
    /// <summary>
    /// Writes the file content.
    /// </summary>
    /// <param name="context">The action context.</param>
    /// <param name="result">The <see cref="FileContentResult"/>.</param>
    /// <param name="range">The <see cref="RangeItemHeaderValue"/>.</param>
    /// <param name="rangeLength">The length of the range.</param>
    protected virtual Task WriteFileAsync(ActionContext context, FileContentResult result, RangeItemHeaderValue? range, long rangeLength)
    {
        ArgumentNullException.ThrowIfNull(context);
        ArgumentNullException.ThrowIfNull(result);
 
        if (range != null && rangeLength == 0)
        {
            return Task.CompletedTask;
        }
 
        if (range != null)
        {
            Log.WritingRangeToBody(Logger);
        }
 
        var fileContentStream = new MemoryStream(result.FileContents);
        return WriteFileAsync(context.HttpContext, fileContentStream, range, rangeLength);
    }
 
    private static partial class Log
    {
        public static void ExecutingFileResult(ILogger logger, FileResult fileResult)
        {
            if (logger.IsEnabled(LogLevel.Information))
            {
                var fileResultType = fileResult.GetType().Name;
                ExecutingFileResultWithNoFileName(logger, fileResultType, fileResult.FileDownloadName);
            }
        }
 
        [LoggerMessage(2, LogLevel.Information, "Executing {FileResultType}, sending file with download name '{FileDownloadName}' ...", EventName = "ExecutingFileResultWithNoFileName", SkipEnabledCheck = true)]
        private static partial void ExecutingFileResultWithNoFileName(ILogger logger, string fileResultType, string fileDownloadName);
 
        [LoggerMessage(17, LogLevel.Debug, "Writing the requested range of bytes to the body...", EventName = "WritingRangeToBody")]
        public static partial void WritingRangeToBody(ILogger logger);
    }
}