Reo.Core.Validation 10.0.210

Reo.Core.Validations

Описание пакета

Reo.Core.Validations — это набор утилит для валидации данных в .NET-приложениях. Пакет предоставляет готовые валидаторы для часто используемых сценариев (например, проверка email, IP-адресов, гос. номеров транспортных средств) и интеграцию с контейнером зависимостей (DI) для централизованной валидации всех зарегистрированных опций. Он решает проблему повторного кодирования валидационной логики и обеспечивает высокую степень повторного использования.

Основные компоненты

1. IOptionsValidationExecutor Интерфейс для запуска валидации всех зарегистрированных в DI-контейнере опций. Пример:

   var executor = serviceProvider.GetRequiredService<IOptionsValidationExecutor>();
   executor.Execute(); // Выполняет валидацию всех опций
   

2. GenericValidator<T> Базовый класс для создания кастомных валидаторов с поддержкой FluentValidation. Пример:

   public class MyValidator : GenericValidator<MyModel>
   {
    public MyValidator()
    {
    RuleFor(x => x.Property).NotEmpty();
    }
   }
   

3. Кастомные валидаторы

   • EmailAddressPropertyValidator<T> — проверка корректности email-адреса.
   • NetworkAddressPropertyValidator<T> — проверка IP-адресов или доменных имен.
   • VehicleRegistrationNumberValidator — валидация гос. номера ТС по стандартам РФ.

4. Расширения FluentValidation

   • ValidEmailAddress<T>() — добавляет валидацию email в FluentValidation.
   • ValidNetworkAddress<T>() — добавляет валидацию сетевых адресов.

Требования

• .NET версии: 8.0, 9.0
• Зависимости:
  • FluentValidation
  • Microsoft.Extensions.DependencyInjection

Установка

NuGet Package Manager

Install-Package Reo.Core.Validations

.NET CLI

dotnet add package Reo.Core.Validations

Настройка

Регистрация сервисов в ASP.NET Core

Добавьте в Program.cs или Startup.cs:

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddValidation(); // Регистрация валидаторов и IOptionsValidationExecutor

Конфигурационные параметры

N/A. Настройка валидации выполняется через DI и FluentValidation.

Использование

Пример 1: Валидация email с FluentValidation

public class UserValidator : AbstractValidator<User>
{
 public UserValidator()
 {
 RuleFor(x => x.Email).ValidEmailAddress(); // Использование кастомного валидатора
 }
}

Пример 2: Валидация гос. номера транспортного средства

var validator = new VehicleRegistrationNumberValidator();
var result = validator.Validate("А123ВС45"); // Валидация номера
if (!result.IsValid)
{
 foreach (var error in result.Errors)
 {
 Console.WriteLine(error.ErrorMessage);
 }
}

Пример 3: Централизованная валидация опций

var executor = serviceProvider.GetRequiredService<IOptionsValidationExecutor>();
executor.Execute(); // Триггерит проверку всех зарегистрированных опций

Лицензия

Данный пакет распространяется под лицензией MIT.