FileSystemAbstraction provides a filesystem abstraction layer in .net.
Inspired by Gaufrette (PHP) :
The filesystem abstraction layer permits you to develop your application without the need to know were all those medias will be stored and how.
Another advantage of this is the possibility to update the files location without any impact on the code apart from the definition of your filesystem. In example, if your project grows up very fast and if your server reaches its limits, you can easily move your medias in an Azure server or any other solution.
| Adapters | Status |
|---|---|
| Local |  |
| Azure Blob Storage |  |
You can install it through NuGet:
Install-Package FileSystemAbstractionFollowing an example with the local filesystem adapter. To setup adapters, look up their respective documentation.
Install-Package FileSystemAbstraction.Adapters.LocalIn AspNetCore project : Startup.cs
public void ConfigureServices(IServiceCollection services)
{
//...
services
.AddFileSystem(LocalFileSystemDefaults.DefaultScheme)
.AddLocal(@"c:\name\of\base\directory");
//...
}Through FileSystem API:
// Get your fileSystem by DependencyInjection
IFileSystem fs = services.GetService<IFileSystem>();
// Check the file existence :
var exists = await fs.ExistsAsync("foo/bar.txt"); // false
if (!exists)
{
// Write "Hello world" to 'bar.txt'
byte[] bytes = Encoding.UTF8.GetBytes("Hello world");
await fs.WriteAsync("foo/bar.txt", bytes);
}
// Read 'bar.txt' content :
bytes = await fs.ReadAllBytesAsync("foo/bar.txt");
var result = Encoding.UTF8.GetString(bytes); // Hello worldThrough File API
// Get your fileSystem by DependencyInjection
IFileSystem fs = services.GetService<IFileSystem>();
// Get a file reference: (linked to c:\name\of\base\directory\foo\bar.txt)
// No file realy created at this point
IFile file = await fileSystem.GetAsync("foo/bar.txt");
// Check the file existence :
var exists = await file.ExistsAsync(); // false
if (!exists)
{
// Write "Hello world" to 'bar.txt'
byte[] bytes = Encoding.UTF8.GetBytes("Hello world");
await file.WriteAsync(bytes);
}
// Read 'bar.txt' content :
bytes = await file.ReadAllBytesAsync();
var result = Encoding.UTF8.GetString(bytes); // Hello world