Как реализовать валидацию данных в ASP.NET Core?

Валидация данных в ASP.NET Core: основные подходы и практики

В ASP.NET Core существует несколько эффективных способов реализации валидации данных, которые можно применять в зависимости от контекста и требований приложения.

Основные подходы к валидации

1. Атрибуты валидации (Attribute-based validation)

Это наиболее распространенный подход, использующий атрибуты из пространства имен System.ComponentModel.DataAnnotations. Эти атрибуты можно применять непосредственно к свойствам моделей.

public class UserRegistrationModel
{
    [Required(ErrorMessage = "Имя пользователя обязательное поле")]
    [StringLength(50, MinimumLength = 3, ErrorMessage = "Имя должно быть от 3 до 50 символов")]
    public string Username { get; set; }

    [Required]
    [EmailAddress(ErrorMessage = "Неверный формат email")]
    public string Email { get; set; }

    [Required]
    [Range(18, 100, ErrorMessage = "Возраст должен быть от 18 до 100 лет")]
    public int Age { get; set; }

    [Required]
    [RegularExpression(@"^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{8,}$", 
        ErrorMessage = "Пароль должен содержать минимум 8 символов, буквы и цифры")]
    public string Password { get; set; }
}

Для использования этой валидации в контроллере достаточно проверить ModelState.IsValid:

[HttpPost]
public IActionResult Register(UserRegistrationModel model)
{
    if (!ModelState.IsValid)
    {
        return View(model); // Возвращаем модель с ошибками
    }
    
    // Логика обработки данных
    return RedirectToAction("Success");
}

2. Пользовательские атрибуты валидации

Когда стандартные атрибуты недостаточны, можно создавать собственные:

public class FutureDateAttribute : ValidationAttribute
{
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        if (value is DateTime date)
        {
            if (date <= DateTime.Now)
            {
                return new ValidationResult("Дата должна быть в будущем");
            }
        }
        return ValidationResult.Success;
    }
}

// Использование
[FutureDate]
public DateTime AppointmentDate { get; set; }

3. IValidatableObject для комплексной валидации

Когда валидация зависит от нескольких свойств или требует сложной бизнес-логики, интерфейс IValidatableObject предоставляет более гибкий подход:

public class OrderModel : IValidatableObject
{
    public decimal Amount { get; set; }
    public string PaymentMethod { get; set; }
    
    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
    {
        var results = new List<ValidationResult>();
        
        if (PaymentMethod == "CreditCard" && Amount > 10000)
        {
            results.Add(new ValidationResult(
                "Для кредитной карты максимальная сумма 10000",
                new[] { nameof(Amount) }));
        }
        
        return results;
    }
}

Дополнительные методы валидации

4. Fluent Validation

Для более сложных и декларативных правил часто используется библиотека FluentValidation:

// Определение валидатора
public class UserValidator : AbstractValidator<UserRegistrationModel>
{
    public UserValidator()
    {
        RuleFor(x => x.Username)
            .NotEmpty().WithMessage("Имя пользователя обязательное")
            .Length(3, 50).WithMessage("Длина от 3 до 50 символов");
        
        RuleFor(x => x.Email)
            .NotEmpty().EmailAddress();
        
        RuleFor(x => x.Password)
            .NotEmpty()
            .Matches(@"^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{8,}$");
    }
}

// Регистрация в DI (в Startup.cs или Program.cs)
services.AddFluentValidationAutoValidation();
services.AddScoped<IValidator<UserRegistrationModel>, UserValidator>();

5. Валидация вручную в сервисах

Для бизнес-логики, которая не подходит для атрибутов или FluentValidation, можно реализовать валидацию в сервисах:

public class UserService
{
    private readonly IUserRepository _repository;
    
    public ValidationResult ValidateForRegistration(User user)
    {
        var result = new ValidationResult();
        
        // Проверка уникальности email
        if (_repository.EmailExists(user.Email))
        {
            result.AddError("Email", "Email уже используется");
        }
        
        // Другие бизнес-правила
        return result;
    }
}

Практические рекомендации

• Слои валидации: Разделяйте валидацию на уровни:

  • Валидация модели (атрибуты/FluentValidation) для базовых правил
  • Бизнес-валидация (сервисы) для сложной логики
  • Валидация домена (в Domain-Driven Design) для инвариантов домена

• Локализация сообщений: Для интернационализации используйте ресурсы:

[Required(ErrorMessageResourceType = typeof(Resources), 
          ErrorMessageResourceName = "UsernameRequired")]
public string Username { get; set; }

• Кастомные ответы API: В API контроллерах возвращайте структурированные ошибки:

if (!ModelState.IsValid)
{
    return BadRequest(new ApiErrorResponse
    {
        Errors = ModelState.Values
            .SelectMany(v => v.Errors)
            .Select(e => e.ErrorMessage)
    });
}

• Проверка на стороне клиента и сервера: Атрибуты валидации поддерживают генерацию HTML5 атрибутов (data-val-*) для клиентской валидации, но всегда дублируйте проверку на сервере для безопасности.

Интеграция с зависимостями

Для валидации, требующей внешних зависимостей (например, проверки уникальности в базе данных), используйте DI через ValidationContext или отдельные сервисы валидации, как показано в примере с UserService.

ASP.NET Core предоставляет гибкую систему валидации, которая сочетает простоту использования атрибутов с мощностью FluentValidation и возможностями кастомной бизнес-валидации. Выбор конкретного метода зависит от сложности правил, требований к производительности и архитектурных предпочтений проекта.