.net core 静态文件中间件

• .net core 静态文件中间件
  • 静态文件中间件的能力
  • 目录结构
  • 支持指定相对路径的访问
  • 浏览目录
  • 映射其他目录和文件
  • UseFileServer
  • FileExtensionContentTypeProvider
  • 打造接口服务页

静态文件中间件的能力

• 支持指定相对路径
• 支持目录浏览
• 支持设置默认文档
• 支持多目录映射

目录结构

支持指定相对路径的访问

Startup.cs

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    app.UseStaticFiles();
    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

运行测试

默认访问静态文件的index.html

app.UseDefaultFiles();

运行测试

DefaultFilesOptions options = new DefaultFilesOptions();
options.DefaultFileNames.Clear();
//假设我们以 mydefault.html 为检索的对象
options.DefaultFileNames.Add("mydefault.html");
app.UseDefaultFiles(options);

浏览目录

添加目录服务

services.AddDirectoryBrowser();

启用网络应用目录浏览

app.UseDirectoryBrowser();

运行测试

映射其他目录和文件

添加 file 文件夹下的文件

app.UseStaticFiles(new StaticFileOptions {
    FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(),"file"))
});

运行测试

添加自定义路径访问

app.UseStaticFiles(new StaticFileOptions {
    RequestPath = "/files",
    FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(),"file"))
});

运行测试

添加到访问目录中去

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    //推荐使用 new PathString("/files") 的方式
    RequestPath = "/files",
    FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "file"))
});

运行测试

UseFileServer

下面代码启用了静态目录和默认文件，但不允许直接访问目录：

app.UseFileServer();

下面代码启用了静态目录和默认文件，目录浏览的功能：

app.UseFileServer(enableDirectoryBrowsing:true);

如果要指定具体的目录下

app.UseFileServer(new FileServerOptions() {
    FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(),@"flie")),
    RequestPath=new PathString("/files"),
    EnableDirectoryBrowsing = true
});

FileExtensionContentTypeProvider

var provider = new FileExtensionContentTypeProvider();
provider.Mappings[".myapp"] = "application/x-msdownload";
provider.Mappings[".htm3"] = "text/html";
provider.Mappings[".image"] = "image/png";
provider.Mappings[".rtf"] = "application/x-msdownload";
provider.Mappings.Remove(".mp4");
app.UseStaticFiles(new StaticFileOptions
{
    RequestPath = "/files",
    FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "file")),
    ContentTypeProvider = provider
});

当我们有其他不可识别 MIME 的时候我们可以默认当作其他类型进行处理。
例如：有不可识别 MIME 的时候，默认让它用 image/png 来识别。

app.UseStaticFiles(new StaticFileOptions
{
      ServeUnknownFileTypes =true,
      DefaultContentType = "image/png"
});

打造接口服务页

app.MapWhen(context =>
{
    return !context.Request.Path.Value.StartsWith("/api");
}, appBuilder =>
{
    var option = new RewriteOptions();
    option.AddRewrite(".*","/index.html",true);
    appBuilder.UseRewriter(option);
    appBuilder.UseStaticFiles();
});