ASP.NET Core应用针对静态文件请求的处理[4]: DirectoryBrowserMiddleware中间件如何呈现目录结构

和StaticFileMiddleware中间件一样，DirectoryBrowserMiddleware中间本质上还是定义了一个请求地址与某个物理目录之间的映射关系，而目标目录体现为一个FileProvider对象。当这个中间件接收到匹配的请求后，会根据请求地址解析出对应目录的相对路径，并利用这个FileProvider获取目录的内容。目录的内容最终会以一个HTML文档的形式被定义，而此HTML最终会被这个中间件作为响应的内容，“目录浏览器”的实现原理就这么简单。 [本文已经同步到《ASP.NET Core框架揭秘》之中]

目录
一、DirectoryBrowserMiddleware
二、DirectoryFormatter
三、具体请求处理逻辑
四、自定义DirectoryFormatter

接下来我们来看看DirectoryBrowserMiddleware的定义。如下面的代码片段所示，DirectoryBrowserMiddleware的第二个构造函数具有四个参数，其中第二个参数是代表当前执行环境的HostingEnvironment。作为第三个参数的是一个HtmlEncoder对象，当目标目录被呈现为一个HTML文档的时候，它被用于实现针对HTML的编码，如果没有显式指定（调用第一个构造函数），默认的HtmlEncoder（HtmlEncoder.Default）会被使用。至于第四个类型为IOptions<DirectoryBrowserOptions>的参数，则承载了针对DirectoryBrowserMiddleware的配置选项，DirectoryBrowserOptions与前面介绍的StaticFileOptions一样，它们都是SharedOptionsBase的子类。

class DirectoryBrowserMiddleware

   2: {

public DirectoryBrowserMiddleware(RequestDelegate next, IHostingEnvironment env, IOptions<DirectoryBrowserOptions> options)

public DirectoryBrowserMiddleware(RequestDelegate next, IHostingEnvironment hostingEnv, HtmlEncoder encoder, IOptions<DirectoryBrowserOptions> options);

public Task Invoke(HttpContext context);

   6: }

   7:  

class DirectoryBrowserOptions : SharedOptionsBase

   9: {

public IDirectoryFormatter Formatter { get; set; }

  11:  

public DirectoryBrowserOptions();

public DirectoryBrowserOptions(SharedOptions sharedOptions);

  14: }