BLOB Storing File System Provider
File System Storage Provider is used to store BLOBs in the local file system as standard files inside a folder.
Read the BLOB Storing document to understand how to use the BLOB storing system. This document only covers how to configure containers to use the file system.
Installation
Use the ABP CLI to add Volo.Abp.BlobStoring.FileSystem NuGet package to your project:
- Install the ABP CLI if you haven't installed before.
- Open a command line (terminal) in the directory of the
.csproj
file you want to add theVolo.Abp.BlobStoring.FileSystem
package. - Run
abp add-package Volo.Abp.BlobStoring.FileSystem
command.
If you want to do it manually, install the Volo.Abp.BlobStoring.FileSystem NuGet package to your project and add [DependsOn(typeof(AbpBlobStoringFileSystemModule))]
to the ABP module class inside your project.
Configuration
Configuration is done in the ConfigureServices
method of your module class, as explained in the BLOB Storing document.
Example: Configure to use the File System storage provider by default
Configure<AbpBlobStoringOptions>(options =>
{
options.Containers.ConfigureDefault(container =>
{
container.UseFileSystem(fileSystem =>
{
fileSystem.BasePath = "C:\\my-files";
});
});
});
UseFileSystem
extension method is used to set the File System Provider for a container and configure the file system options.
See the BLOB Storing document to learn how to configure this provider for a specific container.
Options
- BasePath (string): The base folder path to store BLOBs. It is required to set this option.
- AppendContainerNameToBasePath (bool; default:
true
): Indicates whether to create a folder with the container name inside the base folder. If you store multiple containers in the sameBaseFolder
, leave this astrue
. Otherwise, you can set it tofalse
if you don't like an unnecessarily deeper folder hierarchy.
File Path Calculation
File System Provider organizes BLOB files inside folders and implements some conventions. The full path of a BLOB file is determined by the following rules by default:
- It starts with the
BasePath
configured as shown above. - Appends
host
folder if current tenant isnull
(or multi-tenancy is disabled for the container - see the BLOB Storing document to learn how to disable multi-tenancy for a container). - Appends
tenants/<tenant-id>
folder if current tenant is notnull
. - Appends the container's name if
AppendContainerNameToBasePath
istrue
. If container name contains/
, this will result with nested folders. - Appends the BLOB name. If the BLOB name contains
/
it creates folders. If the BLOB name contains.
it will have a file extension.
Extending the File System BLOB Provider
FileSystemBlobProvider
is the main service that implements the File System storage. You can inherit from this class and override methods to customize it.The
IBlobFilePathCalculator
service is used to calculate the file paths. Default implementation is theDefaultBlobFilePathCalculator
. You can replace/override it if you want to customize the file path calculation.