Pitasoft.Validation.AspNetCore 1.0.1

Pitasoft.Validation.AspNetCore

English | Castellano

English

Pitasoft.Validation.AspNetCore integrates Pitasoft.Validation with ASP.NET Core so invalid request payloads are automatically translated into Result.ValidationError(...) and returned as 400 Bad Request through Pitasoft.Result.AspNetCore.

Validators and checkers can be resolved from the ASP.NET Core dependency injection container, or provided explicitly in Minimal API.

Features

• Minimal API integration with WithValidator<T>(), WithChecker<T>(), WithValidator<T>(instance) and WithChecker<T>(instance)
• MVC / Web API integration with [ValidateRequest<T>] and [CheckRequest<T>]
• Automatic support for sync and async validators or checkers
• Response contracts compatible with Pitasoft.Result and Pitasoft.Client

Installation

dotnet add package Pitasoft.Validation.AspNetCore

Dependency injection

Register your validator or checker in DI before applying the filter:

builder.Services.AddScoped<IValidator<CreateProductRequest>, CreateProductRequestValidator>();
builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

If you want a dedicated package to help register validators and checkers, consider using Pitasoft.Validation.DependencyInjectionExtensions.

For Minimal API you can also pass a concrete instance directly:

app.MapPost("/products", (CreateProductRequest request) =>
    Result.Ok())
   .WithValidator(new CreateProductRequestValidator());

Minimal API example

using Pitasoft.Error;
using Pitasoft.Result;
using Pitasoft.Validation;
using Pitasoft.Validation.AspNetCore.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddScoped<IValidator<CreateProductRequest>, CreateProductRequestValidator>();

var app = builder.Build();

app.MapPost("/products", (CreateProductRequest request) =>
    Result.Ok())
   .WithValidator<CreateProductRequest>();

app.Run();

public sealed record CreateProductRequest(string? Name, decimal Price);

public sealed class CreateProductRequestValidator : IValidator<CreateProductRequest>
{
    public ErrorCollection? ValidateObject(CreateProductRequest? instance)
    {
        if (instance is null || string.IsNullOrWhiteSpace(instance.Name))
        {
            return new ErrorCollection(new Dictionary<string, List<string>>
            {
                ["Name"] = ["Name is required."]
            });
        }

        return null;
    }

    public ErrorCollection? ValidateProperties(CreateProductRequest? instance, IEnumerable<string> propertyNames) =>
        ValidateObject(instance);

    public ErrorCollection? ValidateProperties(CreateProductRequest? instance, params string[] propertyNames) =>
        ValidateObject(instance);

    public ErrorCollection? ValidateProperty(CreateProductRequest? instance, string propertyName) =>
        ValidateObject(instance);
}

MVC / Web API example

using Microsoft.AspNetCore.Mvc;
using Pitasoft.Result;
using Pitasoft.Validation.AspNetCore.Attributes;

[ApiController]
[Route("api/products")]
public sealed class ProductsController : ControllerBase
{
    [HttpPost]
    [ValidateRequest<CreateProductRequest>]
    public IResult Create([FromBody] CreateProductRequest request)
    {
        return Result.Ok();
    }
}

public sealed record CreateProductRequest(string? Name, decimal Price);

Checker example

builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

app.MapPost("/products/check", (CreateProductRequest request) =>
    Result.Ok())
   .WithChecker<CreateProductRequest>();

builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

[ApiController]
[Route("api/products")]
[HttpPost]
[CheckRequest<CreateProductRequest>]
public IResult Create([FromBody] CreateProductRequest request) => Result.Ok();

MVC / Web API attributes remain DI-based. Inline instances are supported only in Minimal API.

Validation behavior

• Invalid request input → Result.ValidationError(...)
• ValidationError → 400 Bad Request
• Structured validation errors are preserved
• ProblemDetails is not used as the default contract
• The first request argument compatible with T is validated, including compatible arguments bound as null

Requirements

• ASP.NET Core 8, 9 or 10
• Pitasoft.Validation
• Pitasoft.Result.AspNetCore

Notes

• This package does not replace validation failures with ProblemDetails
• It relies on Pitasoft.Result.AspNetCore to generate the HTTP response
• It keeps validation payloads aligned with Pitasoft.Client

Castellano

Pitasoft.Validation.AspNetCore integra Pitasoft.Validation con ASP.NET Core para que las peticiones inválidas se traduzcan automáticamente a Result.ValidationError(...) y se devuelvan como 400 Bad Request mediante Pitasoft.Result.AspNetCore.

Los validadores y checkers pueden resolverse desde el contenedor de inyección de dependencia de ASP.NET Core, o pasarse como instancia explícita en Minimal API.

Características

• Integración con Minimal API mediante WithValidator<T>(), WithChecker<T>(), WithValidator<T>(instancia) y WithChecker<T>(instancia)
• Integración con MVC / Web API mediante [ValidateRequest<T>] y [CheckRequest<T>]
• Soporte automático para validadores y checkers síncronos o asíncronos
• Contratos de respuesta compatibles con Pitasoft.Result y Pitasoft.Client

Instalación

dotnet add package Pitasoft.Validation.AspNetCore

Inyección de dependencia

Registra tu validador o checker en DI antes de aplicar el filtro:

builder.Services.AddScoped<IValidator<CreateProductRequest>, CreateProductRequestValidator>();
builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

Si quieres un paquete específico para ayudarte con el registro de validadores y checkers, puedes usar Pitasoft.Validation.DependencyInjectionExtensions.

En Minimal API también puedes pasar una instancia concreta directamente:

app.MapPost("/products", (CreateProductRequest request) =>
    Result.Ok())
   .WithValidator(new CreateProductRequestValidator());

Ejemplo con Minimal API

using Pitasoft.Error;
using Pitasoft.Result;
using Pitasoft.Validation;
using Pitasoft.Validation.AspNetCore.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddScoped<IValidator<CreateProductRequest>, CreateProductRequestValidator>();

var app = builder.Build();

app.MapPost("/products", (CreateProductRequest request) =>
    Result.Ok())
   .WithValidator<CreateProductRequest>();

app.Run();

public sealed record CreateProductRequest(string? Name, decimal Price);

public sealed class CreateProductRequestValidator : IValidator<CreateProductRequest>
{
    public ErrorCollection? ValidateObject(CreateProductRequest? instance)
    {
        if (instance is null || string.IsNullOrWhiteSpace(instance.Name))
        {
            return new ErrorCollection(new Dictionary<string, List<string>>
            {
                ["Name"] = ["El nombre es obligatorio."]
            });
        }

        return null;
    }

    public ErrorCollection? ValidateProperties(CreateProductRequest? instance, IEnumerable<string> propertyNames) =>
        ValidateObject(instance);

    public ErrorCollection? ValidateProperties(CreateProductRequest? instance, params string[] propertyNames) =>
        ValidateObject(instance);

    public ErrorCollection? ValidateProperty(CreateProductRequest? instance, string propertyName) =>
        ValidateObject(instance);
}

Ejemplo con MVC / Web API

using Microsoft.AspNetCore.Mvc;
using Pitasoft.Result;
using Pitasoft.Validation.AspNetCore.Attributes;

[ApiController]
[Route("api/products")]
public sealed class ProductsController : ControllerBase
{
    [HttpPost]
    [ValidateRequest<CreateProductRequest>]
    public IResult Create([FromBody] CreateProductRequest request)
    {
        return Result.Ok();
    }
}

public sealed record CreateProductRequest(string? Name, decimal Price);

Ejemplo con Checker

builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

app.MapPost("/products/check", (CreateProductRequest request) =>
    Result.Ok())
   .WithChecker<CreateProductRequest>();

builder.Services.AddScoped<IChecker<CreateProductRequest>, CreateProductRequestChecker>();

[ApiController]
[Route("api/products")]
[HttpPost]
[CheckRequest<CreateProductRequest>]
public IResult Create([FromBody] CreateProductRequest request) => Result.Ok();

Los atributos de MVC / Web API siguen siendo exclusivamente para DI. Las instancias inline solo están soportadas en Minimal API.

Comportamiento de validación

• Entrada inválida → Result.ValidationError(...)
• ValidationError → 400 Bad Request
• Los errores estructurados se conservan
• ProblemDetails no se usa como contrato por defecto
• Se valida el primer argumento de petición compatible con T, incluso si el valor enlazado llega como null

Requisitos

• ASP.NET Core 8, 9 o 10
• Pitasoft.Validation
• Pitasoft.Result.AspNetCore

Notas

• Este paquete no sustituye los errores de validación por ProblemDetails
• Usa Pitasoft.Result.AspNetCore para generar la respuesta HTTP
• Mantiene los payloads de validación alineados con Pitasoft.Client

Autor

Sebastián Martínez Pérez

Licencia

Copyright © 2026 Pitasoft, S.L.
Licenciado bajo los términos de la LICENSE.txt incluida en este repositorio.