Reo.Core.FileStorage
10.0.20
dotnet add package Reo.Core.FileStorage --version 10.0.20
NuGet\Install-Package Reo.Core.FileStorage -Version 10.0.20
<PackageReference Include="Reo.Core.FileStorage" Version="10.0.20" />
<PackageVersion Include="Reo.Core.FileStorage" Version="10.0.20" />
<PackageReference Include="Reo.Core.FileStorage" />
paket add Reo.Core.FileStorage --version 10.0.20
#r "nuget: Reo.Core.FileStorage, 10.0.20"
#:package Reo.Core.FileStorage@10.0.20
#addin nuget:?package=Reo.Core.FileStorage&version=10.0.20
#tool nuget:?package=Reo.Core.FileStorage&version=10.0.20
Reo.Core.FileStorage
Описание пакета
Пакет Reo.Core.FileStorage предоставляет инструменты для управления конфигурацией файлового хранения (ФХ), включая проверку существования необходимых файловых групп и разрешений, их создание при необходимости, а также валидацию настроек. Он решает проблему обеспечения согласованности и корректности настроек ФХ в различных средах (например, разработка, тестирование, продакшн), автоматизируя процессы проверки и настройки.
Основные компоненты
- IFileStorageAdminClientV1: Интерфейс для взаимодействия с административным API ФХ. Предоставляет методы для получения и создания файловых групп, разрешений и других ресурсов.
- ShareNameCheckService: Фоновый сервис, который проверяет наличие необходимых файловых групп и разрешений в ФХ. Если они отсутствуют, сервис автоматически создаёт их.
- FileStorageOptionsValidator: Валидатор для проверки корректности настроек ФХ (например, URL, логины и пароли администратора).
- DTO-модели (FileGroupDto, FilePermissionDto и др.): Классы для передачи данных между клиентом и сервером ФХ.
- FileStorageShareNameException: Исключение, которое выбрасывается при попытке использовать недопустимое имя папки в
ФХ (например, содержащее символ
/).
Требования
- .NET: Совместим с .NET Core 3.1, .NET 5, .NET 6, .NET 7.
- Зависимости:
- FluentValidation (для валидации настроек).
- Reo.Core.Extensions (для расширений строк и коллекций).
Установка
Используйте следующие команды для установки пакета:
NuGet Package Manager:
Install-Package Reo.Core.FileStorage
.NET CLI:
dotnet add package Reo.Core.FileStorage
Настройка
Регистрация в DI-контейнере (ASP.NET Core)
Добавьте сервисы в Startup.cs или Program.cs:
services.AddFileStorage(options =>
{
options.Endpoint = "https://filestorage.example.com";
options.AdminUserName = "admin";
options.AdminUserPassword = "securepassword";
options.UserName = "user";
options.UserPassword = "userpassword";
});
Конфигурационные параметры
Настройки можно указать в appsettings.json:
"FileStorageOptions": {
"Endpoint": "https://filestorage.example.com",
"AdminUserName": "admin",
"AdminUserPassword": "securepassword",
"UserName": "user",
"UserPassword": "userpassword"
}
Использование
Пример 1: Проверка и создание файловых групп
// Регистрация сервиса в DI
services.AddSingleton<ShareNameCheckService>();
// В фоновом процессе (например, в ASP.NET Core)
var shareNameCheckService = serviceProvider.GetRequiredService<ShareNameCheckService>();
await shareNameCheckService.ExecuteAsync(CancellationToken.None);
Пример 2: Валидация настроек
var validator = new FileStorageOptionsValidator();
var options = new FileStorageOptions
{
Endpoint = "",
AdminUserName = "admin",
AdminUserPassword = "securepassword",
UserName = "user",
UserPassword = "userpassword"
};
var result = validator.Validate(options);
if (!result.IsValid)
{
foreach (var error in result.Errors)
{
Console.WriteLine($"Ошибка: {error.ErrorMessage}");
}
}
Пример 3: Использование IFileStorageAdminClientV1
var client = serviceProvider.GetRequiredService<IFileStorageAdminClientV1>();
var fileGroupRequest = new FileGroupDto
{
GroupName = "Reports",
FilePermissionIds = new List<Guid> { Guid.NewGuid() }
};
await client.CreateFileGroupAsync(fileGroupRequest, CancellationToken.None);
Лицензия
Данный пакет распространяется под лицензией MIT.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- FluentValidation (>= 12.1.1)
- FluentValidation.AspNetCore (>= 11.3.1)
- Flurl (>= 4.0.0)
- Flurl.Http (>= 4.0.2)
- Flurl.Http.Newtonsoft (>= 0.9.1)
- Humanizer.Core (>= 3.0.1)
- IdentityModel (>= 7.0.0)
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 10.0.2)
- Microsoft.AspNetCore.Authentication.OpenIdConnect (>= 10.0.2)
- Microsoft.Extensions.Configuration (>= 10.0.2)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.2)
- Microsoft.Extensions.DependencyInjection (>= 10.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Http.Polly (>= 10.0.2)
- Microsoft.Extensions.Logging (>= 10.0.2)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Options (>= 10.0.2)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.2)
- Newtonsoft.Json (>= 13.0.4)
- Polly (>= 8.5.0)
- Reo.Core.Auth (>= 10.0.20)
- Reo.Core.Extensions (>= 10.0.20)
- stbychkov.AutoLoggerMessage (>= 1.0.15)
- Swashbuckle.AspNetCore (>= 10.1.2)
- System.Linq.Async (>= 7.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Reo.Core.FileStorage:
| Package | Downloads |
|---|---|
|
Reo.Core.Providers
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 10.0.20 | 93 | 2/9/2026 |
| 10.0.15 | 90 | 2/6/2026 |
| 10.0.14 | 97 | 2/6/2026 |
| 10.0.13 | 89 | 2/4/2026 |
| 10.0.12 | 91 | 2/3/2026 |
| 10.0.11 | 102 | 2/2/2026 |
| 10.0.10 | 95 | 1/29/2026 |
| 10.0.9 | 98 | 1/29/2026 |
| 10.0.8 | 106 | 1/27/2026 |
| 10.0.6 | 99 | 1/26/2026 |
| 10.0.5 | 95 | 1/23/2026 |
| 10.0.3 | 99 | 1/23/2026 |
| 10.0.2 | 96 | 1/23/2026 |
| 10.0.1 | 84 | 1/22/2026 |
| 8.0.829 | 93 | 1/22/2026 |
| 8.0.828 | 96 | 1/22/2026 |
| 8.0.827 | 105 | 1/22/2026 |
| 8.0.826 | 106 | 1/22/2026 |
| 8.0.825 | 106 | 1/22/2026 |
| 8.0.824 | 100 | 1/21/2026 |