Masuit.Tools/Masuit.Tools.AspNetCore/AspNetCore/Extensions/ControllerExtensions.cs

using Masuit.Tools.AspNetCore.ResumeFileResults.ResumeFileResult;
using Masuit.Tools.Mime;
using Microsoft.AspNetCore.Mvc;

namespace Masuit.Tools.AspNetCore.ResumeFileResults.Extensions;

/// <summary>
/// Controller扩展方法
/// </summary>
public static class ControllerExtensions
{
    private static readonly IMimeMapper MimeMapper = new MimeMapper();

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="fileContents">文件二进制流</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeFileContentResult ResumeFile(this ControllerBase controller, byte[] fileContents, string contentType, string fileDownloadName)
    {
        return ResumeFile(controller, fileContents, contentType, fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="fileContents">文件二进制流</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeFileContentResult ResumeFile(this ControllerBase controller, byte[] fileContents, string fileDownloadName)
    {
        return ResumeFile(controller, fileContents, MimeMapper.GetMimeFromPath(fileDownloadName), fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="fileContents">文件二进制流</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <param name="etag">ETag</param>
    /// <returns></returns>
    public static ResumeFileContentResult ResumeFile(this ControllerBase controller, byte[] fileContents, string contentType, string fileDownloadName, string etag)
    {
        return new ResumeFileContentResult(fileContents, contentType, etag)
        {
            FileDownloadName = fileDownloadName
        };
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="stream">文件二进制流</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeFileStreamResult ResumeFile(this ControllerBase controller, Stream stream, string contentType, string fileDownloadName)
    {
        return ResumeFile(controller, stream, contentType, fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="stream">文件二进制流</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeFileStreamResult ResumeFile(this ControllerBase controller, Stream stream, string fileDownloadName)
    {
        return ResumeFile(controller, stream, MimeMapper.GetMimeFromPath(fileDownloadName), fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="stream">文件二进制流</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <param name="etag">ETag</param>
    /// <returns></returns>
    public static ResumeFileStreamResult ResumeFile(this ControllerBase controller, Stream stream, string contentType, string fileDownloadName, string etag)
    {
        if (stream.CanSeek)
        {
            stream.Seek(0, SeekOrigin.Begin);
        }

        return new ResumeFileStreamResult(stream, contentType, etag)
        {
            FileDownloadName = fileDownloadName
        };
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="virtualPath">服务端本地文件的虚拟路径</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeVirtualFileResult ResumeFile(this ControllerBase controller, string virtualPath, string contentType, string fileDownloadName)
    {
        return ResumeFile(controller, virtualPath, contentType, fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="virtualPath">服务端本地文件的虚拟路径</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumeVirtualFileResult ResumeFile(this ControllerBase controller, string virtualPath, string fileDownloadName)
    {
        return ResumeFile(controller, virtualPath, MimeMapper.GetMimeFromPath(virtualPath), fileDownloadName, null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="virtualPath">服务端本地文件的虚拟路径</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <param name="etag">ETag</param>
    /// <returns></returns>
    public static ResumeVirtualFileResult ResumeFile(this ControllerBase controller, string virtualPath, string contentType, string fileDownloadName, string etag)
    {
        return new ResumeVirtualFileResult(virtualPath, contentType, etag)
        {
            FileDownloadName = fileDownloadName
        };
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="physicalPath">服务端本地文件的物理路径</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumePhysicalFileResult ResumePhysicalFile(this ControllerBase controller, string physicalPath, string contentType, string fileDownloadName)
    {
        return ResumePhysicalFile(controller, physicalPath, contentType, fileDownloadName, etag: null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="physicalPath">服务端本地文件的物理路径</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <returns></returns>
    public static ResumePhysicalFileResult ResumePhysicalFile(this ControllerBase controller, string physicalPath, string fileDownloadName)
    {
        return ResumePhysicalFile(controller, physicalPath, MimeMapper.GetMimeFromPath(physicalPath), fileDownloadName, etag: null);
    }

    /// <summary>
    /// 可断点续传和多线程下载的FileResult
    /// </summary>
    /// <param name="controller"></param>
    /// <param name="physicalPath">服务端本地文件的物理路径</param>
    /// <param name="contentType">Content-Type</param>
    /// <param name="fileDownloadName">下载的文件名</param>
    /// <param name="etag">ETag</param>
    /// <returns></returns>
    public static ResumePhysicalFileResult ResumePhysicalFile(this ControllerBase controller, string physicalPath, string contentType, string fileDownloadName, string etag)
    {
        return new ResumePhysicalFileResult(physicalPath, contentType, etag)
        {
            FileDownloadName = fileDownloadName
        };
    }
}