.NET Core ファイルプロバイダー

夏 · 掲載地 2019/01/28 15:13:10

ファイルプロバイダー抽象化
ファイルプロバイダーはファイルシステムの上に積み重なる抽象化の層です。主なインターフェースはIFileProviderです。 IFileProviderは、ファイル情報(IFileInfo)、ディレクトリ情報(IDirectoryContents)、変更通知の設定(IChangeTokenを用いて)を取得する方法を公開します。

IFileInfoインターフェースは、個々のファイルやディレクトリを操作するためのメソッドとプロパティを提供します。 ExistsとIsDirectoryという2つのブールプロパティ、2つのプロファイル用のNameとLength(バイトごとの)プロパティがあり、さらにLastModifiedの日付プロパティも含まれています。また、CreateReadStreamメソッドを使ってファイルの内容を読むこともできます。

ファイルプロバイダーの実装
IFileProviderには物理型、組み込み型、複合型の3つの実装から選択できます。物理型は実際のシステム内のファイルにアクセスするために使われます。組み込みはアセンブリに埋め込まれたファイルにアクセスするために使われます。複合タイプは最初の2つの方法の組み合わせです。

PhysicalFileProvider
PhysicalFileProviderは物理ファイルシステムへのアクセスを提供します。 System.IO.File 型をカプセル化しており、ディレクトリおよびそのサブディレクトリのすべてのパスにスコープ化します。このタイプのスコープはディレクトリおよびそのサブディレクトリへのアクセスを制限し、スコープ外の操作がファイルシステムにアクセスするのを防ぎます。そのようなプロバイダーをインスタンス化する際は、サーバーがこのプロバイダーからのすべてのリクエストをベースパスとして使用できるディレクトリパスを提供しなければなりません(これによりパス外へのアクセスリクエストは制限されます)。 ASP.NET Coreアプリケーションでは、PhysicalFileProviderプロバイダーを直接インスタンス化することも、コントローラーとサービス内のコンストラクタ依存注入を使ってIFileProviderインターフェースを要求することも可能です。後者は、より柔軟でテストしやすい解をもたらします。

PhysicalFileProviderの作成は非常に簡単で、それを具現化して物理パスを渡すだけです。その後、そのディレクトリを経由してコンテンツを移動したり、特定のファイルに関する情報を得るためにサブパスを提供したりできます。

ログインが見えます。

StartupクラスのConfigureServices()メソッドを修正してローカルファイルにアクセスするために必要なサービスを登録し、ミドルウェア内のコンストラクタ注入でそれらをミドルウェアに追加することで、ファイルのアクセスパスを一か所(つまりアプリケーション起動時)で制御できるようにします。

ログインが見えます。

[通信] .NET Core ファイルプロバイダー

閲覧したセクション