共计 8175 个字符,预计需要花费 21 分钟才能阅读完成。
虽然 ASP.NET Core 是一款“动态”的 Web 服务端框架,但是在很多情况下都需要处理针对静态文件的请求,最为常见的就是这对 JavaScript 脚本文件、CSS 样式文件和图片文件的请求。针对不同格式的静态文件请求的处理,ASP.NET Core 为我们提供了三个中间件,它们将是本系列文章论述的重点。不过在针对对它们展开介绍之前,我们照理通过一些简单的实例来体验一下如何在一个 ASP.NET Core 应用中发布静态文件。
目录
一、以 Web 的形式读取文件
二、浏览目录内容
三、显示默认页面
四、映射媒体类型
一、以 Web 的形式读取文件
我们创建的演示实例是一个简单的 ASP.NET Core 控制台应用,它具有如下图所示的项目结构。我们可以看到在默认作为 WebRoot 的目录(wwwroot)下,我们将 JavaScript 脚本文件、CSS 样式文件和图片文件存放到对应的子目录(js、css 和 img)下,我们将把这个目录的所有文件以 Web 的形式发布出来,客户端可以访问相应的 URL 来获取这些文件。
针对静态文件的请求是通过一个名为 StaticFileMiddleware 的中间件来实现的,这个中间件类型定义在 NuGet 包“Microsoft.AspNetCore.StaticFiles”中,所以我们需要预先按照这个 NuGet 包。整个应用只包含如下所示的这几行代码,StaticFileMiddleware 这个中间件的注册是通过调用 ApplicationBuilder 的扩展方法 UseStaticFiles 来完成的。
1: public class Program
2: {
3: public static void Main()
4: {
5: new WebHostBuilder()
6: .UseContentRoot(Directory.GetCurrentDirectory())
7: .UseKestrel()
8: .Configure(app => app.UseStaticFiles())
9: .Build()
10: .Run();
11: }
12: }
除了注册必需的 StaticFileMiddleware 中间件之外,我们还调用了 WebHostBuilder 的 UseContentRoot 方法将当前项目的根目录作为 ContentRoot 目录。我们知道 ASP.NET Core 应用具有两个重要的根目录,它们分别是 ContentRoot 和 WebRoot,后者也是对外发布的静态文件默认使用的根目录。由于 WebRoot 目录的默认路径就是“{contentroot}/wwwroot”,所示上面这段程序就是将项目中的这个 wwwroot 目录下的所有静态文件发布出来。
当这个程序运行之后,我们就可以通过向对应 URL 发送 HTTP 请求的方式来获取某个的文件,这个 URL 由文件相当于 wwwroot 目录的路径来决定。比如 JPG 文件“~/wwwroot/img/dophin1.jpg”对应的 URL 为“http://
localhost:5000/img/dophin1.jpg”。我们直接利用浏览器访问这个 URL,目标图片会直接显示出来。
上面我们通过一个简单的实例将 WebRoot 所在目录下的所有静态文件直接发布出来。如果我们需要发布的静态文件存储在其他目录下呢?依旧是演示的这个应用,现在我们将一些文档存储在如下图所示的“~/doc/”目录下并以 Web 的形式发布出来,我们的程序又该如何编写呢?
我们知道 ASP.NET Core 应用大部分情况下都是利用一个 FileProvider 对象来读取文件的,它在处理针对静态文件的请求是也不例外。对于我们调用 ApplicationBuilder 的扩展方法 UseStaticFiles 方法注册的这个类型为 StaticFileMiddleware 的中间件,其内部具有一个FileProvider 和请求路径的映射关系。如果调用 UseStaticFiles 方法没有指定任何的参数,那么这个映射关系的请求路径就是应用的基地址(PathBase),而 FileProvider 自然就是指向 WebRoot 目录的 PhysicalFileProvider。
上述的这个需求可以通过显式注册这个映射的方式来实现,为此我们在现有程序的基础上额外添加了一次针对 UseStaticFiles 方法的调用,并通过指定的参数(是一个 StaticFileOptions 对象)显式指定了采用的 FileProvider(针对“~/doc/”的 PhysicalFileProvider)和请求路径(“/documents”)。
1: public class Program
2: {
3: public static void Main()
4: {
5: string contentRoot = Directory.GetCurrentDirectory();
6: new WebHostBuilder()
7: .UseContentRoot(contentRoot)
8: .UseKestrel()
9: .Configure(app => app
10: .UseStaticFiles()
11: .UseStaticFiles(new StaticFileOptions {
12: FileProvider = new PhysicalFileProvider(Path.Combine(contentRoot, "doc")),
13: RequestPath = "/documents"
14: }))
15: .Build()
16: .Run();
17: }
18: }
按照上面这段程序指定的映射关系,对于存储在“~/doc/”目录下的这个 PDF 文件(“checklist.pdf”),发布在 Web 上的 URL 为“http://localhost:5000/documents/checklist.pdf”。当我们在浏览器上请求这个地址时,该 PDF 文件的内容将会按照如下图所示的形式显示在浏览器上。
二、浏览目录内容
注册的 StaticFileMiddleware 中间件只会处理针对某个具体静态文件的额请求,如果我们向针对某个目录的 URL 发送 HTTP 请求(比如“http://localhost:5000/img/”), 得到的将是一个状态为 404 的响应。不过我们可以通过注册另一个名为 DirectoryBrowserMiddleware 的中间件来显示请求目录的内容。具体来说,这个中间件会返回一个 HTML 页面,请求目录下的所有文件将以表格的形式包含在这个页面中。对于我们演示的这个应用来说,我们可以按照如下的方式调用 UseDirectoryBrowser 方法来注册这个 DirectoryBrowserMiddleware 中间件。
1: public class Program
2: {
3: public static void Main()
4: {
5: string contentRoot = Directory.GetCurrentDirectory();
6: IFileProvider fileProvider = new PhysicalFileProvider(
7: Path.Combine(contentRoot, "doc"));
8: new WebHostBuilder()
9: .UseContentRoot(contentRoot)
10: .UseKestrel()
11: .Configure(app => app
12: .UseStaticFiles()
13: .UseStaticFiles(new StaticFileOptions {
14: FileProvider = fileProvider,
15: RequestPath = "/documents"
16: })
17: .UseDirectoryBrowser()
18: .UseDirectoryBrowser(new DirectoryBrowserOptions {
19: FileProvider = fileProvider,
20: RequestPath = "/documents"
21: }))
22: .Build()
23: .Run();
24: }
25: }
当上面这个应用启动之后,如果我们利用浏览器向针对某个目录的 URL(比如“http://localhost:5000/”或者“http://localhost:5000/img/”),目标目录的内容(包括子目录和文件)将会以下图所示的形式显示在一个表格中。不仅仅如此,子目录和文件均会显示为链接,指向目标目录或者文件的 URL。
三、显示默认页面
从安全的角度来讲,利用注册的 UseDirectoryBrowser 中间件显示一个目录浏览页面会将整个目标目录的接口和所有文件全部暴露出来,所���这个中间件需要根据自身的安全策略谨慎使用。对于针对目录的请求,另一种更为常用的响应策略就是显示一个保存在这个目录下的默认页面。按照约定,作为默认页面的文件一般采用如下四种命名方式:default.htm、default.html、index.htm 或者 index.html。针对目标目录下默认页面的呈现实现在一个名为 DefaultFilesMiddleware 的中间件中,我们演示的这个应用可以按照如下的方式调用 UseDefaultFiles 方法来注册这个中间件。
1: public class Program
2: {
3: public static void Main()
4: {
5: string contentRoot = Directory.GetCurrentDirectory();
6: IFileProvider fileProvider = new PhysicalFileProvider(
Path.Combine(contentRoot, "doc"));
7:
8: new WebHostBuilder()
9: .UseContentRoot(contentRoot)
10: .UseKestrel()
11: .Configure(app => app
12: .UseDefaultFiles()
13: .UseDefaultFiles(new DefaultFilesOptions{
14: RequestPath = "/documents",
15: FileProvider = fileProvider,
16: })
17: .UseStaticFiles()
18: .UseStaticFiles(new StaticFileOptions
19: {
20: FileProvider = fileProvider,
21: RequestPath = "/documents"
22: })
23: .UseDirectoryBrowser()
24: .UseDirectoryBrowser(new DirectoryBrowserOptions
25: {
26: FileProvider = fileProvider,
27: RequestPath = "/documents"
28: }))
29: .Build()
30: .Run();
31: }
32: }
现在我们在“~/wwwroot/img/”目录下创建一个名为 index.htm 的默认页面,现在利用浏览器访问这个目录对应的 URL(“http://localhost:5000/img/”),显示就时这个页面的内容。
我们必须在 注册 StaticFileMiddleware 和 DirectoryBrowserMiddleware 之前注册 DefaultFilesMiddleware,否则它起不了任何作用。由于 DirectoryBrowserMiddleware 和 DefaultFilesMiddleware 这两个中间件处理的均是针对目录的请求,如果 DirectoryBrowserMiddleware 先被注册,那么显示的总是目录的内容。若 DefaultFilesMiddleware 先被注册,在默认页面不存在情况下回显示目录的内容。至于为什么要先于 StaticFileMiddleware 之前注册 DefaultFilesMiddleware,则是因为后者是通过采用 URL 重写的方式实现的,也就是说这个中间件会将针对目录的请求改写成针对默认页面的请求,而最终针对默认页面的请求还得依赖 StaticFileMiddleware 完成。
DefaultFilesMiddleware 中间件在默认情况下总是以约定的名称(default.htm、default.html、index.htm 或者 index.html)在当前请求的目录下定位默认页面。如果我们希望作为默认页面的文件不能按照这样的约定命名(比如 readme.htm),我们需要按照如下的方式显式指定默认页面的文件名。
1: public class Program
2: {
3: public static void Main()
4: {
5: string contentRoot = Directory.GetCurrentDirectory();
6: IFileProvider fileProvider = new PhysicalFileProvider(
Path.Combine(contentRoot, "doc"));
7:
8: DefaultFilesOptions options1 = new DefaultFilesOptions();
9: DefaultFilesOptions options2 = new DefaultFilesOptions{
10: RequestPath = "/documents",
11: FileProvider = fileProvider
12: };
13: options1.DefaultFileNames.Add("readme.htm");
14: options2.DefaultFileNames.Add("readme.htm");
15:
16: new WebHostBuilder()
17: .UseContentRoot(contentRoot)
18: .UseKestrel()
19: .Configure(app => app
20: .UseDefaultFiles(options1)
21: .UseDefaultFiles(options2)
22: .UseStaticFiles()
23: .UseStaticFiles(new StaticFileOptions{
24: FileProvider = fileProvider,
25: RequestPath = "/documents"
26: })
27: .UseDirectoryBrowser()
28: .UseDirectoryBrowser(new DirectoryBrowserOptions{
29: FileProvider = fileProvider,
30: RequestPath = "/documents"
31: }))
32: .Build()
33: .Run();
34: }
35: }
四、映射媒体类型
通过上面演示的实例可以看出,浏览器能够正确的将请求的目标文件的内容正常的呈现出来。对 HTTP 协议具有基本了解的人都应该知道,响应的文件能够在支持的浏览器上呈现具有一个基本的前提,那就是响应消息通过 Content-Type 报头携带的媒体类型必须与内容一致。我们的实例演示了针对两种类型文件的请求,一种是 JPG 文件,另一种是 PDF 文件,对应的媒体类型分别是“image/jpg”和“application/pdf”,那么 StaticFileMiddleware 是如何正确解析出正确的媒体类型的呢?
StaticFileMiddleware 针对媒体类型的解析是通过一个名为 ContentTypeProvider 的对象来实现的,而默认使用的则是一个 FileExtensionContentTypeProvider 对象。顾名思义,FileExtensionContentTypeProvider 是根据文件的扩展命名来解析媒体类型的。FileExtensionContentTypeProvider 内部预定了数百种常用文件扩展名与对应媒体类型之间的映射关系,所以如果我们发布的静态文件具有标准的扩展名,StaticFileMiddleware 就能为对应的响应赋予正确的媒体类型。
那么如果某个文件的扩展名没有在这个预定义的映射之中,或者我们需要某个预定义的扩展名匹配不同的媒体类型,我们应该如何解决呢?还是针对我们演示的这个实例,想在我将“~/wwwroot/img/ dophin1.jpg”这个文件的扩展名改成“.img”,毫无疑问 StaticFileMiddleware 将能为针对该文件的请求解析出正确媒体类型。这个问题具有若干不同的解决方案,第一种方案就是让 StaticFileMiddleware 支持不能识别的文件类型,并为它们设置一个默认的媒体类型,如下所示了具体采用的编程方式。
1: public class Program
2: {
3: public static void Main()
4: {
5: new WebHostBuilder()
6: .UseContentRoot(Directory.GetCurrentDirectory();)
7: .UseKestrel()
8: .Configure(app => app.UseStaticFiles(new StaticFileOptions {
9: ServeUnknownFileTypes = true,
10: DefaultContentType = "image/jpg"
11: }))
12: .Build()
13: .Run();
14: }
15: }
上述这种解决方案只能设置 一种 默认媒体类型,如果具有多种需要映射成不同媒体类型的非识别文件类型,采用这种方案就无能为力了,所以最根本的解决方案还是需要将不能识别的文件类型和对应的媒体类型进行映射。由于 StaticFileMiddleware 使用的 ContentTypeProvider 是可以定制的,我们可以按照如下的方式显式地为 StaticFileMiddleware 指定一个 FileExtensionContentTypeProvider 对象作为它的 ContentTypeProvider,然后将取缺失的映射添加到这个 FileExtensionContentTypeProvider 对象上。
1: public class Program
2: {
3: public static void Main()
4: {
5: FileExtensionContentTypeProvider contentTypeProvider = new FileExtensionContentTypeProvider();
6: contentTypeProvider.Mappings.Add(".img", "image/jpg");
7:
8: new WebHostBuilder()
9: .UseContentRoot(Directory.GetCurrentDirectory())
10: .UseKestrel()
11: .Configure(app => app
.UseStaticFiles(new StaticFileOptions{
12: ContentTypeProvider = contentTypeProvider
13: }))
14: .Build()
15: .Run();
16: }
17: }
将 ASP.NET Core 应用程序部署至生产环境中(CentOS7)http://www.linuxidc.com/Linux/2016-11/137010.htm
ASP.NET Core 负载均衡集群搭建(CentOS7+Nginx+Supervisor+Kestrel)http://www.linuxidc.com/Linux/2016-11/136997.htm
ASP.NET Core Linux 下为 dotnet 创建守护进程(必备知识)http://www.linuxidc.com/Linux/2016-08/133943.htm
本文永久更新链接地址:http://www.linuxidc.com/Linux/2016-12/137968.htm