SharpGrip.FluentValidation.AutoValidation.Endpoints 1.4.0

Prefix Reserved
dotnet add package SharpGrip.FluentValidation.AutoValidation.Endpoints --version 1.4.0                
NuGet\Install-Package SharpGrip.FluentValidation.AutoValidation.Endpoints -Version 1.4.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SharpGrip.FluentValidation.AutoValidation.Endpoints" Version="1.4.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SharpGrip.FluentValidation.AutoValidation.Endpoints --version 1.4.0                
#r "nuget: SharpGrip.FluentValidation.AutoValidation.Endpoints, 1.4.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install SharpGrip.FluentValidation.AutoValidation.Endpoints as a Cake Addin
#addin nuget:?package=SharpGrip.FluentValidation.AutoValidation.Endpoints&version=1.4.0

// Install SharpGrip.FluentValidation.AutoValidation.Endpoints as a Cake Tool
#tool nuget:?package=SharpGrip.FluentValidation.AutoValidation.Endpoints&version=1.4.0                

SharpGrip FluentValidation AutoValidation

Builds

FluentValidation.AutoValidation [Build]

Quality Gate Status
Maintainability Rating
Reliability Rating
Security Rating
Coverage

Introduction

SharpGrip FluentValidation AutoValidation is an extension of the FluentValidation (v10+) library enabling automatic asynchronous validation in MVC controllers and minimal APIs (endpoints). The library FluentValidation.AspNetCore is no longer being maintained and is unsupported. As a result, support for automatic validation provided by this library is no longer available. This library re-introduces this functionality for MVC controllers and introduces automatic validation for minimal APIs (endpoints). It enables developers to easily implement automatic validation in their projects.

Installation

Register your validators with the Microsoft DI service container, for instructions on setting that up please see https://docs.fluentvalidation.net/en/latest/di.html.

MVC controllers NuGet

For MVC controllers reference NuGet package SharpGrip.FluentValidation.AutoValidation.Mvc (https://www.nuget.org/packages/SharpGrip.FluentValidation.AutoValidation.Mvc).

using SharpGrip.FluentValidation.AutoValidation.Mvc.Extensions;

builder.Services.AddFluentValidationAutoValidation();

Minimal APIs (endpoints) NuGet

For minimal APIs (endpoints) reference NuGet package SharpGrip.FluentValidation.AutoValidation.Endpoints (https://www.nuget.org/packages/SharpGrip.FluentValidation.AutoValidation.Endpoints).

Enabling minimal API (endpoint) automatic validation can be done on both route groups and routes.

using SharpGrip.FluentValidation.AutoValidation.Endpoints.Extensions;

builder.Services.AddFluentValidationAutoValidation();

var app = builder.Build();
var endpointGroup = app.MapGroup("/some-group").AddFluentValidationAutoValidation();
endpointGroup.MapPost("/", (SomeModel someModel) => $"Hello {someModel.Name}");

app.MapPost("/", (SomeOtherModel someOtherModel) => $"Hello again {someOtherModel.Name}").AddFluentValidationAutoValidation();

Configuration

MVC controllers

Property Default value Description
DisableBuiltInModelValidation false Disables the built-in .NET model (data annotations) validation.
ValidationStrategy ValidationStrategy.All Configures the validation strategy. Validation strategy ValidationStrategy.All enables asynchronous automatic validation on all controllers inheriting from ControllerBase. Validation strategy ValidationStrategy.Annotations enables asynchronous automatic validation on controllers inheriting from ControllerBase decorated (class or method) with a [FluentValidationAutoValidationAttribute] attribute.
EnableBodyBindingSourceAutomaticValidation true Enables asynchronous automatic validation for parameters bound from BindingSource.Body binding sources (typically parameters decorated with the [FromBody] attribute).
EnableFormBindingSourceAutomaticValidation false Enables asynchronous automatic validation for parameters bound from BindingSource.Form binding sources (typically parameters decorated with the [FromForm] attribute).
EnableQueryBindingSourceAutomaticValidation true Enables asynchronous automatic validation for parameters bound from BindingSource.Query binding sources (typically parameters decorated with the [FromQuery] attribute).
EnablePathBindingSourceAutomaticValidation false Enables asynchronous automatic validation for parameters bound from BindingSource.Path binding sources (typically parameters decorated with the [FromRoute] attribute).
EnableCustomBindingSourceAutomaticValidation false Enables asynchronous automatic validation for parameters bound from BindingSource.Custom binding sources.
using SharpGrip.FluentValidation.AutoValidation.Mvc.Extensions;

builder.Services.AddFluentValidationAutoValidation(configuration =>
{
    // Disable the built-in .NET model (data annotations) validation.
    configuration.DisableBuiltInModelValidation = true;

    // Only validate controllers decorated with the `FluentValidationAutoValidation` attribute.
    configuration.ValidationStrategy = ValidationStrategy.Annotation;

    // Enable validation for parameters bound from `BindingSource.Body` binding sources.
    configuration.EnableBodyBindingSourceAutomaticValidation = true;

    // Enable validation for parameters bound from `BindingSource.Form` binding sources.
    configuration.EnableFormBindingSourceAutomaticValidation = true;

    // Enable validation for parameters bound from `BindingSource.Query` binding sources.
    configuration.EnableQueryBindingSourceAutomaticValidation = true;

    // Enable validation for parameters bound from `BindingSource.Path` binding sources.
    configuration.EnablePathBindingSourceAutomaticValidation = true;

    // Enable validation for parameters bound from 'BindingSource.Custom' binding sources.
    configuration.EnableCustomBindingSourceAutomaticValidation = true;

    // Replace the default result factory with a custom implementation.
    configuration.OverrideDefaultResultFactoryWith<CustomResultFactory>();
});

public class CustomResultFactory : IFluentValidationAutoValidationResultFactory
{
    public IActionResult CreateActionResult(ActionExecutingContext context, ValidationProblemDetails? validationProblemDetails)
    {
        return new BadRequestObjectResult(new {Title = "Validation errors", ValidationErrors = validationProblemDetails?.Errors});
    }
}

Minimal APIs (endpoints)

using SharpGrip.FluentValidation.AutoValidation.Endpoints.Extensions;

builder.Services.AddFluentValidationAutoValidation(configuration =>
{
    // Replace the default result factory with a custom implementation.
    configuration.OverrideDefaultResultFactoryWith<CustomResultFactory>();
});

public class CustomResultFactory : IFluentValidationAutoValidationResultFactory
{
    public IResult CreateResult(EndpointFilterInvocationContext context, ValidationResult validationResult)
    {
        var validationProblemErrors = validationResult.ToValidationProblemErrors();

        return Results.ValidationProblem(validationProblemErrors, "Some details text.", "Some instance text.", (int) HttpStatusCode.BadRequest, "Some title.");
    }
}

Validation attributes

MVC controllers

Customizing automatic validation behavior is achievable through the use of attributes.

The [AutoValidateAlways] attribute can be applied to a controller parameter, compelling automatic validation to disregard the validation check for a valid binding source. This proves useful when the ApiBehaviorOptions.SuppressInferBindingSourcesForParameters option is enabled, and a custom model is used, with parameters bound from multiple binding sources.

The [AutoValidateNever] attribute can be placed on a controller class, controller method, or controller parameter, instructing automatic validation to be skipped.

Validation interceptors

Note: Using validation interceptors is considered to be an advanced feature and is not needed for most use cases.

Validation interceptors allow you to intercept and alter the validation process by either implementing the IGlobalValidationInterceptor interface in a custom class or by implementing the IValidatorInterceptor on a single validator. During the validation process both instances get resolved and called (if they are present) creating a mini pipeline of validation interceptors:

==> IValidatorInterceptor.BeforeValidation()
==> IGlobalValidationInterceptor.BeforeValidation()

Validation

==> IValidatorInterceptor.AfterValidation()
==> IGlobalValidationInterceptor.AfterValidation()

Both interfaces define a BeforeValidation and a AfterValidation method.

The BeforeValidation method gets called before validation and allows you to return a custom IValidationContext which gets passed to the validator. In case you return null the default IValidationContext will be passed to the validator.

The AfterValidation method gets called after validation and allows you to return a custom IValidationResult which gets passed to the IFluentValidationAutoValidationResultFactory. In case you return null the default IValidationResult will be passed to the IFluentValidationAutoValidationResultFactory.

MVC controllers

// Example of a global validation interceptor.
builder.Services.AddTransient<IGlobalValidationInterceptor, CustomGlobalValidationInterceptor>();

public class CustomGlobalValidationInterceptor : IGlobalValidationInterceptor
{
    public IValidationContext? BeforeValidation(ActionExecutingContext actionExecutingContext, IValidationContext validationContext)
    {
        // Return a custom `IValidationContext` or null.
        return null;
    }

    public ValidationResult? AfterValidation(ActionExecutingContext actionExecutingContext, IValidationContext validationContext)
    {
        // Return a custom `ValidationResult` or null.
        return null;
    }
}

// Example of a single validator interceptor.
private class TestValidator : AbstractValidator<TestModel>, IValidatorInterceptor
{
    public TestValidator()
    {
        RuleFor(x => x.Parameter1).Empty();
        RuleFor(x => x.Parameter2).Empty();
        RuleFor(x => x.Parameter3).Empty();
    }

    public IValidationContext? BeforeValidation(ActionExecutingContext actionExecutingContext, IValidationContext validationContext)
    {
        // Return a custom `IValidationContext` or null.
        return null;
    }

    public ValidationResult? AfterValidation(ActionExecutingContext actionExecutingContext, IValidationContext validationContext)
    {
        // Return a custom `ValidationResult` or null.
        return null;
    }
}

Minimal APIs (endpoints)

// Example of a global validation interceptor.
builder.Services.AddTransient<IGlobalValidationInterceptor, CustomGlobalValidationInterceptor>();

public class CustomGlobalValidationInterceptor : IValidationInterceptor
{
    public IValidationContext? BeforeValidation(EndpointFilterInvocationContext endpointFilterInvocationContext, IValidationContext validationContext)
    {
        // Return a custom `IValidationContext` or null.
        return null;
    }

    public ValidationResult? AfterValidation(EndpointFilterInvocationContext endpointFilterInvocationContext, IValidationContext validationContext)
    {
        // Return a custom `ValidationResult` or null.
        return null;
    }
}

// Example of a single validator interceptor.
private class TestValidator : AbstractValidator<TestModel>, IValidatorInterceptor
{
    public TestValidator()
    {
        RuleFor(x => x.Parameter1).Empty();
        RuleFor(x => x.Parameter2).Empty();
        RuleFor(x => x.Parameter3).Empty();
    }

    public IValidationContext? BeforeValidation(EndpointFilterInvocationContext endpointFilterInvocationContext, IValidationContext validationContext)
    {
        // Return a custom `IValidationContext` or null.
        return null;
    }

    public ValidationResult? AfterValidation(EndpointFilterInvocationContext endpointFilterInvocationContext, IValidationContext validationContext)
    {
        // Return a custom `ValidationResult` or null.
        return null;
    }
}
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on SharpGrip.FluentValidation.AutoValidation.Endpoints:

Package Downloads
Fluxera.Extensions.Hosting.Modules.AspNetCore.HttpApi

A module that enables HTTP APIs for ASP.NET Core.

GlavLib.App

Package Description

Senlin.Mo

Modular monolith

Pivotte

A tool to help you declare API endpoints for both clients and servers.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.4.0 128,451 12/17/2023
1.3.1 9,834 10/19/2023
1.3.0 3,815 10/9/2023
1.2.0 975 9/22/2023
1.1.0 626 9/6/2023
1.0.1 230 8/21/2023
1.0.0 452 8/19/2023
1.0.0-beta3 126 8/17/2023
1.0.0-beta2 141 8/16/2023
1.0.0-beta1 136 8/16/2023