دمج التحقق مع واجهات API

ربط FluentValidation بـ ASP.NET Core

using FluentValidation;

builder.Services
    .AddValidatorsFromAssemblyContaining<CustomerValidator>();

البرمجيات الوسيطة للتحقق التلقائي

dotnet add package FluentValidation.AspNetCore

builder.Services.AddFluentValidationAutoValidation();

حلّ المدققات من خلال DI

public class UserValidator : AbstractValidator<UserRequest>
{
    public UserValidator(IUserRepository repo)
    {
        RuleFor(u => u.Email)
            .MustAsync(async (e, ct) => !await repo.ExistsAsync(e));
    }
}

التحقق الصريح في نقطة نهاية

app.MapPost("/users", async (
    UserRequest request,
    IValidator<UserRequest> validator) =>
{
    var result = await validator.ValidateAsync(request);
    if (!result.IsValid)
        return Results.ValidationProblem(result.ToDictionary());
    return Results.Ok();
});

ما المقصود بـ ProblemDetails؟

{
  "type": "https://tools.ietf.org/html/rfc7231",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": { "Email": ["Email is required."] }
}

ValidationProblemDetails

return Results.ValidationProblem(result.ToDictionary());
// Produces a 400 ValidationProblemDetails response

تحويل نتائج FluentValidation

var result = await validator.ValidateAsync(request);
if (!result.IsValid)
{
    IDictionary<string, string[]> errors = result.ToDictionary();
    return Results.ValidationProblem(errors);
}

تخصيص مخرجات ProblemDetails

builder.Services.AddProblemDetails(options =>
{
    options.CustomizeProblemDetails = ctx =>
        ctx.ProblemDetails.Extensions["traceId"] =
            ctx.HttpContext.TraceIdentifier;
});

التحقق من الصحة في وحدات تحكم MVC

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpPost]
    public IActionResult Create(UserRequest request) => Ok();
}

مرشح للتحقق من الصحة في Minimal APIs

app.MapPost("/users", (UserRequest r) => Results.Ok())
   .AddEndpointFilter<ValidationFilter<UserRequest>>();

اختيار التحقق التلقائي أم الصريح

تحقق سريع

مراجعة