Talrace.Core.Storage 8.0.0

About

This package provides an API for working with file storages: Azure File Storage, Amazon S3, Google Cloud Storage, local storage.

Available api

IFileStorage - interface provides a set of methods for working with file storage.
UriExtensions - static class provides a set of Uri class extension methods for working with IFileStorage. Extension methods provide a wrapper around the IFileStorage functionality.
IAppPaths - interface provides functionality to get application paths for working with different file folders: "thumbs", "temp", "content".
IDateAdapter<T> - interface provides functionality to get current time with different types.
IFileHandler - interface provides a set of methods for file processing: saving and deleting files, getting relative, original and temporary file paths.
IUploadService<T, U, V> - interface provides functionality for uploading files. T is a class that inherits from IPostFile; U is a class that inherits from IFileInfo<V>. V is a type of Create Time.

Storage configuration (appsettings.json, environment variables, etc.)

Azure storage

{
  "StorageConfiguration": {
    "FilesPath": "<FilesPath>",
    "AzureConnectionString": "<AzureConnectionString>"
  }
}

Google storage

{
  "StorageConfiguration": {
    "FilesPath": "<FilesPath>",
    "FileEndpoint": "<FileEndpoint>",
    "GoogleKey": {
      "type": "<Type>",
      "project_id": "<ProjectId>",
      "private_key_id": "<PrivateKeyId>",
      "private_key": "<PrivateKey>",
      "client_email": "<ClientEmail>",
      "client_id": "<ClientId>",
      "auth_uri": "<AuthUri>",
      "token_uri": "<TokenUri>",
      "auth_provider_x509_cert_url": "<AuthProvider>",
      "client_x509_cert_url": "<ClientUrl>"
    }
  }
}

Amazon S3

{
  "StorageConfiguration": {
    "FilesPath": "<FilesPath>",
    "AssessKeyId": "<AssessKeyId>",
    "AssessKeySecret": "<AssessKeySecret>",
    "Bucket": "<Bucket>",
    "Region": "<AWS Region>"
  }
}

Storage injection

Azure storage

public void ConfigureServices(IServiceCollection services) {
    var storageConfiguration = Configuration.GetSection("StorageConfiguration");
    services.AddAzureStorage(storageConfiguration);
}

Google storage

public void ConfigureServices(IServiceCollection services) {
    var storageConfiguration = Configuration.GetSection("StorageConfiguration");
    services.AddGoogleStorage(storageConfiguration);
}

Amazon S3

public void ConfigureServices(IServiceCollection services) {
    var storageConfiguration = Configuration.GetSection("StorageConfiguration");
    services.AddAwsS3Storage(storageConfiguration);
}

Local storage

public void ConfigureServices(IServiceCollection services) {
    services.AddLocalStorage();
}

Core services

To use IAppPaths, IFileHandler and IUploadService<T, U, V>, you need to add these services to the dependency container by calling the AddCoreStorage method. Also you need to provide singleton implementation of IDateAdapter<V> or use long or DateTime implementation. Also you need to add IFileStorage to dependency container. Also you can provide override of upload service

{
  "StorageConfiguration": {
    "FilesPath": "<FilesPath>"
  }
}

Use unix create time

public void ConfigureServices(IServiceCollection services) {
    var storageConfiguration = Configuration.GetSection("StorageConfiguration");
    services.AddCoreStorage<long>(storageConfiguration);
    // TODO: provide storage.
    // For example: services.AddLocalStorage();
}