c# .Net Core静态文件服务器学习总结

1,792 阅读4分钟

概要:本文通过示例,讲解了 NET Core2.0 静态文件目录的相关知识,并附带解析,适合新手,并附带了完整的项目代码。(项目通过 vs2017 初始化的 ASP.NET Core 应用程序,之后选择***空项目***)

示例代码

  • 项目结构

    这里写图片描述

  • program.cs文件

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Logging;

namespace StaticFileServer
{
    public class Program
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseKestrel()
                .UseContentRoot(Directory.GetCurrentDirectory())  // 设置当前目录的内容
                .UseIISIntegration()
                .UseUrls("http://*:5000") // 使 项目在 5000端口被访问
                .UseStartup<Startup>()
                .Build();
    }
}

  • Startup.cs 文件
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.StaticFiles;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.FileProviders;

namespace StaticFileServer
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
          
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.UseStaticFiles(); // 使用默认文件夹 wwwroot 仅仅shi wwwroot对外可见
          
            app.Run(async (context) => 
            {
                await context.Response.WriteAsync("hello jesus");
            });
        }
    }
}
  • 运行效果:
    这里写图片描述
    解析: 这是一个基本的静态文件服务器, app.UseStaticFiles() 函数使当前内容目录下默认的 wwwroot中的文件可以被访问

那么问题来了,若想访问其他目录下的静态文件,该怎么办?

  • 设置任意目录下的静态文件可以访问代码:
  // 设置 指定目录的文件 可以被访问 start
            var staticfile = new StaticFileOptions();
            staticfile.FileProvider = new PhysicalFileProvider(@"C:\"); // 指定目录,这里指的是C盘,也可以指定其他目录
            app.UseStaticFiles(staticfile); 

我们吧startup.cs的***Configure*** 函数代码改为如下代码(增加了c盘文件可以访问):

 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            var staticfile = new StaticFileOptions();
            staticfile.FileProvider = new PhysicalFileProvider(@"C:\"); // 指定目录,这里指的是C盘,也可以指定其他目录
            app.UseStaticFiles(staticfile);  // 使用默认文件夹 wwwroot 仅仅shi wwwroot对外可见
          
            app.Run(async (context) => 
            {
                await context.Response.WriteAsync("hello jesus");
            });
        }
  • c盘文件展示
    这里写图片描述
  • 运行效果
    这里写图片描述

这样我们就可以访问任意目录下的文件了,那么问题来了,c盘中有个 叫 456.log 的文件,我们访问不了,原因是:服务器不能识别,怎么办?如何让服务器识别 所有类型的文件呢? 我们以 .log 为后缀的文件为例

  • 我们将***Configure*** 改为一下内容:
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            var staticfile = new StaticFileOptions();
            staticfile.FileProvider = new PhysicalFileProvider(@"C:\"); // 指定目录,这里指的是C盘,也可以指定其他目录

                // 设置 对应的文件类型(防止Mime type没事别出来,打不开或出现404错误)
                staticfile.ServeUnknownFileTypes = true;
                staticfile.DefaultContentType = "application/x-msdownload";// 设置默认 MIME TYPE
                var provider = new FileExtensionContentTypeProvider();
                provider.Mappings.Add(".log", "text/plain"); // 手动设置对应的 MIME TYPE
                staticfile.ContentTypeProvider = provider;

            app.UseStaticFiles(staticfile); // 使用默认文件夹 wwwroot 仅仅shi wwwroot对外可见
            // 设置 指定目录的文件 可以被访问 end

            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("hello jesus");
            });
        }

我们将不能识别的文件类型默认为 : "application/x-msdownload",即遇到我们没处理的,不能识别的类型统统下载下来。 provider.Mappings.Add(".log", "text/plain"); // 手动设置对应的 MIME TYPE 。我们手动增加了 对后缀为.log的文件类型的处理,当成文本文件处理,即txt处理。

  • 运行效果
    • 未知的文件 (我们访问789.ggg文件,此文件类型我们未处理过)
      这里写图片描述
    • 已处理的文件类型
      这里写图片描述

这样,我们就可以访问任意类型的静态文件了,那么问题又来了, 我想访问一个目录下所有的文件,即访问某个目录怎么办?

在 NET Core 中访问目录的功能默认是禁止的,需要手动开启。 步骤:

  1. 在 ConfigureServices 函数中增加 目录访问服务,
 public void ConfigureServices(IServiceCollection services)
        {
            services.AddDirectoryBrowser(); // 使目录可以被浏览 (浏览所有的文件以及文件夹)
        }
  1. 在Configure 函数中增加 中间键 和 具体的目录,在这里我们让 c盘下的所有目录可以被访问
 // 设置 目录可浏览  start
            var dir = new DirectoryBrowserOptions();
            dir.FileProvider = new PhysicalFileProvider(@"C:\");
            app.UseDirectoryBrowser(dir);
            // 设置 目录可浏览  end
  • 这样我们就可以访问c盘中的任意目录了,效果如下:

    这里写图片描述

  • Startup.cs 文件最终代码如下:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.StaticFiles;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.FileProviders;

namespace StaticFileServer
{
    public class Startup
    {
        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddDirectoryBrowser(); // 使目录可以被浏览 (浏览所有的文件以及文件夹)
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            // 设置 目录可浏览  start
            var dir = new DirectoryBrowserOptions();
            dir.FileProvider = new PhysicalFileProvider(@"C:\");
            app.UseDirectoryBrowser(dir);
            // 设置 目录可浏览  end

            // 设置 指定目录的文件 可以被访问 start
            var staticfile = new StaticFileOptions();
            staticfile.FileProvider = new PhysicalFileProvider(@"C:\"); // 指定目录,这里指的是C盘,也可以指定其他目录

                // 设置 对应的文件类型(防止Mime type没事别出来,打不开或出现404错误)
                staticfile.ServeUnknownFileTypes = true;
                staticfile.DefaultContentType = "application/x-msdownload";// 设置默认 MIME TYPE
                var provider = new FileExtensionContentTypeProvider();
                provider.Mappings.Add(".log", "text/plain"); // 手动设置对应的 MIME TYPE
                staticfile.ContentTypeProvider = provider;

            app.UseStaticFiles(staticfile); // 使用默认文件夹 wwwroot 仅仅shi wwwroot对外可见
            // 设置 指定目录的文件 可以被访问 end

            app.Run(async (context) => 
            {
                await context.Response.WriteAsync("hello jesus");
            });
        }
    }
}