A Importância da Validação com FluentValidation em Aplicações ASP.NET MVC

Felipe Faria — Tue, 22 Apr 2025 03:32:34 +0000

Quando estamos desenvolvendo aplicações web, especialmente aquelas que lidam com o cadastro e manipulação de dados sensíveis como em um sistema de consultas médicas, garantir a integridade e a consistência desses dados é essencial. Uma das formas mais elegantes e eficazes de realizar essa tarefa no ASP.NET é por meio da biblioteca FluentValidation.

Neste artigo, vou mostrar como utilizei o FluentValidation na minha aplicação ASP.NET MVC para validar o cadastro de médicos e quais benefícios essa abordagem trouxe para o projeto.

Por que usar FluentValidation?

O FluentValidation é uma biblioteca popular no ecossistema .NET que permite definir regras de validação de forma fluente, limpa e separada da lógica do controlador ou modelo. Ele promove um código mais organizado, reutilizável e fácil de manter.

Ao invés de usar DataAnnotations diretamente no ViewModel, podemos centralizar as regras de negócio em uma classe separada, mantendo o princípio da responsabilidade única (SRP) e favorecendo a injeção de dependência, facilitando testes unitários e manutenções futuras.

Como foi aplicado na minha aplicação

Na minha aplicação de gerenciamento de médicos, implementei uma classe AdicionarMedicoValidator para validar os dados enviados ao tentar adicionar um novo médico ao sistema. Essa classe herda de AbstractValidator<T> e define regras claras para os campos do ViewModel.

Exemplo de Validador

public class AdicionarMedicoValidator : AbstractValidator<AdicionarMedicoViewModel>
{
    public AdicionarMedicoValidator(SisMedContext context)
    {
        RuleFor(x => x.CRM).NotEmpty().WithMessage("CRM é obrigatório")
            .MaximumLength(20).WithMessage("O CRM deve ter no máximo {MaxLength} caracteres.")
            .Must(crm => !context.Medicos.Any(m => m.CRM == crm)).WithMessage("Este CRM já está em uso.");

        RuleFor(x => x.Name).NotEmpty().WithMessage("Nome é obrigatório")
            .MaximumLength(200).WithMessage("O Nome deve ter no máximo {MaxLength} caracteres.");
    }
}

Registro do Validador no `Program.cs`

Para que o FluentValidation reconheça automaticamente os validadores, basta registrá-los no container de injeção de dependência:

builder.Services.AddScoped<IValidator<AdicionarMedicoViewModel>, AdicionarMedicoValidator>();

Utilização no Controller

Dentro do MedicosController, a validação é chamada explicitamente antes de salvar os dados:

[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult Adicionar(AdicionarMedicoViewModel dados)
{
    var validacao = _adicionarMedicoValidator.Validate(dados);

    if (!validacao.IsValid)
    {
        validacao.AddToModelState(ModelState, string.Empty);
        return View(dados);
    }

    var medico = new Medico
    {
        CRM = dados.CRM,
        Name = dados.Name
    };

    _context.Medicos.Add(medico);
    _context.SaveChanges();

    return RedirectToAction(nameof(Index));
}

Essa abordagem separa claramente as responsabilidades:

O ViewModel representa apenas os dados.
O Validator define as regras.
O Controller coordena a operação.

Benefícios dessa abordagem

Manutenção facilitada: As regras de validação estão centralizadas em um único lugar.
Reutilização: O mesmo validador pode ser utilizado em diferentes partes da aplicação.
Legibilidade: A sintaxe fluente torna o código mais expressivo e fácil de entender.
Testabilidade: As regras podem ser testadas isoladamente com testes unitários.

Conclusão

O FluentValidation é uma poderosa ferramenta para garantir que os dados que entram na sua aplicação sejam válidos, consistentes e seguros. Em sistemas mais complexos, como o de gestão de profissionais de saúde, essa validação se torna ainda mais essencial para evitar duplicações, inconsistências ou falhas críticas.

Utilizá-lo com ASP.NET MVC proporciona uma estrutura robusta, modular e pronta para escalar com segurança e qualidade.

Content-Type e as diferenças entre x-www-form-urlencoded e JSON

Felipe Faria — Fri, 14 Mar 2025 14:38:37 +0000

Ao trabalhar com APIs e comunicação entre cliente e servidor, existe um header muito importante para comunicação entre as duas partes, este é o Content-Type. O Content-Type é usado para informar ao receptor o tipo de dados que estão sendo trafegados na rede. Os dois formatos mais comuns para o envio de dados simples em uma requisição HTTP são os: application/json e application/x-www-form-urlencoded.

Características

Content-Type: application/json

É um formato baseado em JSON (JavaScript Object Notation), muito utilizado para a comunicação e a troca de dados entre APIs. O JSON surgiu como uma alternativa ao tradicional XML. O JSON segue a sintaxe do JavaScript, tornando possível o envio de estruturas complexas como objetos e arrays, tornando mais fácil a legibilidade.

Exemplo de requisição HTTP usando Content-Type: application/json

POST /api/usuarios HTTP/1.1
Host: exemplo.com
Content-Type: application/json

{
  "id": 1253
  "nome": "João Silva",
  "email": "joao@example.com",
  "idade": 30,
  "endereço": {
    "rua": "Barão da Cidade",
    "Número": 782
    "bairro": "Mimoso Jacarandá",
    "cidade": "São Paulo",
    "Estado": "São Paulo"
  },
  "numeros_de_telefone": [
    { "id": 1432, "DDD": 41, "numero": 981843617 },
    { "id": 1433, "DDD": 27, "numero": 974272074 }
  ]
}

Content-Type: application/x-wwww-form-urlencoded

É o formato padrão para envio de dados através de formulários HTML. Os dados são codificados em estrutura de URL como chaves e valores, exemplo: "nome=Jonas&idade=28". Quando precisamos utilizar objetos complexos de dados, a legibilidade do conteúdo fica um pouco prejudicada.

Exemplo de requisição HTTP usando Content-Type: application/x-wwww-form-urlencoded

POST /api/usuarios HTTP/1.1
Host: exemplo.com
Content-Type: application/x-wwww-form-urlencoded

id=1253&nome=João Silva&email=joao@example.com&idade=30&endereço.rua=Barão da Cidade&endereço.Número=782&endereço.bairro=Mimoso Jacarandá&endereço.cidade=São Paulo&endereço.Estado=São Paulo&numeros_de_telefone[0].id=1432&numeros_de_telefone[0].DDD=41&numeros_de_telefone[0].numero=981843617&numeros_de_telefone[1].id=1433&numeros_de_telefone[1].DDD=27&numeros_de_telefone[1].numero=974272074

Vantagens de um relacionado ao outro

aplication/json

Melhor suporte a estruturas complexas.
Facilita a manipulação e a serialização de objetos em diversas linguagens de programação.
Padrão amplamente utilizado em APIs RESTful.

application/x-www-form-urlencoded

Simples e leve para pequenos conjuntos de dados.
Nativo para formulários HTML sem necessidade de JavaScript.
Bem suportado em servidores web e frameworks.

Resumo

O header Content-Type é essencial na comunicação entre cliente e servidor, pois informa o tipo de dados trafegados. Os formatos mais comuns são application/json e application/x-www-form-urlencoded. O application/json é ideal para APIs RESTful, oferecendo suporte a estruturas complexas e facilitando a leitura e manipulação dos dados. Já o application/x-www-form-urlencoded é amplamente utilizado em formulários HTML, sendo mais leve e simples para pequenos conjuntos de dados. A escolha entre os dois depende do contexto e da necessidade da aplicação.

✍️Co-autor: @guigovaski
🔗Link: https://dev.to/guigovaski/content-type-e-as-diferencas-entre-x-www-form-urlencoded-e-json-53ja

DEV Community: Felipe Faria