[ASP.NET Core 3框架揭秘] 文件系统[3]:物理文件系统
SP.NET Core应用中使用得最多的还是具体的物理文件,比如配置文件、View文件以及作为Web资源的静态文件。物理文件系统由定义在NuGet包“Microsoft.Extensions.FileProviders.Physical”中的PhysicalFileProvider来构建。我们知道System.IO命名空间下定义了一整套针操作物理目录和文件的API,实际上PhysicalFileProvider最终也是通过调用这些API来完成相关的IO操作。
public class PhysicalFileProvider : IFileProvider, IDisposable { public PhysicalFileProvider(string root); public IFileInfo GetFileInfo(string subpath); public IDirectoryContents GetDirectoryContents(string subpath); public IChangeToken Watch(string filter); public void Dispose(); }
一、PhysicalFileInfo
一个PhysicalFileProvider对象总是映射到某个具体的物理目录上,被映射的目录所在的路径通过构造函数的参数root来提供,该目录将作为PhysicalFileProvider的根目录。GetFileInfo方法返回的IFileInfo对象代表指定路径对应的文件,这是一个类型为PhysicalFileInfo的对象。一个物理文件可以通过一个System.IO.FileInfo对象来表示,一个PhysicalFileInfo对象实际上就是对该对象的封装,定义在PhysicalFileInfo的所有属性都来源于这个FileInfo对象。对于创建读取文件输出流的CreateReadStream方法来说,它返回的是一个根据物理文件绝对路径创建的FileStream对象。
public class PhysicalFileInfo : IFileInfo { ... public PhysicalFileInfo(FileInfo info); }
对于PhysicalFileProvider的GetFileInfo方法来说,即使我们指定的路径指向一个具体的物理文件,它并不总是会返回一个PhysicalFileInfo对象。PhysicalFileProvider会将一些场景视为“目标文件不存在”,并让GetFileInfo方法返回一个NotFoundFileInfo对象。具体来说,PhysicalFileProvider的GetFileInfo方法在如下的场景中会返回一个NotFoundFileInfo对象:
- 确实没有一个物理文件与指定的路径相匹配。
- 如果指定的是一个绝对路径(比如“c:\foobar”),即Path.IsPathRooted方法返回True。
- 如果指定的路径指向一个隐藏文件。
顾名思义,具有如下定义的NotFoundFileInfo类型表示一个“不存在”的文件。NotFoundFileInfo对象的Exists属性总是返回False,而其他的属性则变得没有任何意义。当我们调用它的CreateReadStream试图读取一个根本不存在的文件内容时,会抛出一个FileNotFoundException类型的异常。
public class NotFoundFileInfo : IFileInfo { public bool Exists => false; public long Length => throw new NotImplementedException(); public string PhysicalPath => null; public string Name { get; } public DateTimeOffset LastModified => DateTimeOffset.MinValue; public bool IsDirectory => false; public NotFoundFileInfo(string name) => this.Name = name; public Stream CreateReadStream() =>