文件服务器

Sisk 提供 Sisk.Http.FileSystem 命名空间，其中包含用于提供静态文件、目录列出和文件转换的工具。此功能允许您从本地目录提供文件，支持范围请求（音频/视频流）和自定义文件处理。

提供静态文件 #

提供静态文件的最简单方法是 Router.MapFileSystem。此方法将 URL 前缀映射到磁盘上的目录。

using Sisk.Core.Http;
using Sisk.Core.Http.FileSystem;

// 将服务器根映射到当前目录
mainRouter.MapFileSystem("/", Directory.GetCurrentDirectory());

// 将 /assets 映射到 "public/assets" 文件夹
mainRouter.MapFileSystem(
    "/assets",
    Path.Combine(Directory.GetCurrentDirectory(), "public", "assets"));

当请求匹配路由前缀时，HttpFileServerHandler 将在指定目录中查找文件。如果找到，它将提供该文件；否则，将返回 404 响应（如果访问被拒绝则返回 403）。

HttpFileServer.CreateServingRoute 在需要显式创建 Route 对象时仍然可用，但 MapFileSystem 是应用代码中最直接的选项。

这两种方法都会创建一个 PrefixRoute（Sisk 1.7 之前的正则路由），它是一个 dynamic route。静态路由始终在其之前进行测试，因此映射到 / 的文件服务器可作为其他路由未处理路径的回退。文件服务器路由不受 HttpServerConfiguration.ForceTrailingSlash 的影响。

HttpFileServerHandler #

若需更细致地控制文件的提供方式，您可以手动实例化并配置 HttpFileServerHandler。

var fileHandler = new HttpFileServerHandler("/var/www/html");

// 启用目录列出（默认禁用）
fileHandler.AllowDirectoryListing = true;

// 设置自定义路由前缀（此前缀将在请求路径中被去除）
fileHandler.RoutePrefix = "/public";

// 在 /public 下注册处理器
mainRouter.MapFileSystem("/public", fileHandler);

配置 #

属性	描述
`RootDirectoryPath`	提供文件的根目录的绝对或相对路径。
`RoutePrefix`	在解析文件时将从请求路径中去除的路由前缀。默认是 `/`。
`AllowDirectoryListing`	如果设置为 `true`，当请求目录且未找到索引文件时启用目录列出。默认是 `false`。
`FileConverters`	用于在提供文件之前转换文件的 `HttpFileServerFileConverter` 列表。

目录列出 #

当启用 AllowDirectoryListing 且用户请求目录路径时，Sisk 将生成一个 HTML 页面列出该目录的内容。

目录列出包括：

指向父目录的导航（..）。
子目录列表。
文件列表，显示大小和最后修改日期。

文件转换器 #

文件转换器允许您拦截特定文件类型并以不同方式处理。例如，您可能希望对图像进行转码、即时压缩文件，或使用部分内容（Range 请求）提供文件。

Sisk 包含两个用于媒体流的内置转换器：

HttpFileAudioConverter：处理 .mp3、.ogg、.wav、.flac、.ogv。
HttpFileVideoConverter：处理 .webm、.avi、.mkv、.mpg、.mpeg、.wmv、.mov、.mp4。

这些转换器支持 HTTP Range Requests，允许客户端在音频和视频文件中进行定位。

创建自定义转换器 #

要创建自定义文件转换器，请继承 HttpFileServerFileConverter 并实现 CanConvert 和 Convert。

using Sisk.Core.Http;
using Sisk.Core.Http.FileSystem;

public class MyTextConverter : HttpFileServerFileConverter
{
    public override bool CanConvert(FileInfo file)
    {
        // 仅适用于 .txt 文件
        return file.Extension.Equals(".txt", StringComparison.OrdinalIgnoreCase);
    }

    public override HttpResponse Convert(FileInfo file, HttpRequest request)
    {
        string content = File.ReadAllText(file.FullName);
        
        // 将所有文本内容转换为大写
        return new HttpResponse(200)
        {
            Content = new StringContent(content.ToUpper())
        };
    }
}

然后，将其添加到您的处理器：

var handler = new HttpFileServerHandler("./files");
handler.FileConverters.Add(new MyTextConverter());