2a:["$","section","3",{"className":"mb-16","children":["$undefined",[["$","h3","0",{"className":"text-xl font-semibold text-white mb-4","children":"Como criar um Handler Global na prática?"}],["$","p","1",{"className":"text-gray-300 leading-relaxed mb-6","children":"Anote sua classe com @RestControllerAdvice e implemente métodos para capturar\n exceções. Por exemplo, ao interceptar MethodArgumentNotValidException , você pode\n criar um Map e preencher apenas os dados que interessam — status code, data/hora,\n mensagem genérica e uma lista estruturada de erros separados por campo."}],["$","div","2",{"className":"border rounded-xl p-6 mb-8 bg-blue-500/10 border-blue-500/20 text-blue-400","children":[["$","h3",null,{"className":"font-semibold mb-3 flex items-center gap-2 text-blue-400","children":[["$","span",null,{"children":"ℹ️"}],"Dica Técnica"]}],["$","div",null,{"className":"text-gray-300 leading-relaxed","children":[["$","p","0",{"className":"text-gray-300 leading-relaxed mb-6","children":"Prefira o retorno de um objeto ResponseEntity para personalizar tanto o corpo quanto o\n status HTTP da resposta."}]]}]]}]]]}] 2b:["$","section","4",{"className":"mb-16","children":[["$","h2",null,{"className":"text-2xl md:text-3xl font-bold text-white mb-6","children":"Exemplo real: Código do Handler para validação automática"}],[["$","p","0",{"className":"text-gray-300 leading-relaxed mb-6","children":"Imagine que você criou um DTO validado com @Valid e precisa garantir que os erros\n cheguem ao front de modo limpo. Use getFieldErrors() para mapear quais campos\n falharam e quais mensagens devem ser exibidas. O ResponseEntity encapsula o status e\n todo o JSON de retorno, do jeito que o front espera."}]]]}] 2c:["$","section","5",{"className":"mb-16","children":["$undefined",[["$","h3","0",{"className":"text-xl font-semibold text-white mb-4","children":"Abordagem segura para diferentes cenários de exceção"}],["$","p","1",{"className":"text-gray-300 leading-relaxed mb-6","children":"Sua API deve lidar com mais de um tipo de falha. Além da validação automática dos campos\n do DTO, é essencial capturar exceções como ConstraintViolationException ,\n resultantes de violações em @QueryParam ou métodos do tipo PATCH. Dessa forma, endpoints\n POST, PUT, PATCH, todos são tratados, evitando respostas quebradas."}],["$","div","2",{"className":"border rounded-xl p-6 mb-8 bg-yellow-500/10 border-yellow-500/20 text-yellow-400","children":[["$","h3",null,{"className":"font-semibold mb-3 flex items-center gap-2 text-yellow-400","children":[["$","span",null,{"children":"⚠️"}],"Atenção"]}],["$","div",null,{"className":"text-gray-300 leading-relaxed","children":[["$","p","0",{"className":"text-gray-300 leading-relaxed mb-6","children":"Lembre de registrar um Handler específico para cada tipo de exceção. Copiar/colar\n métodos pode ajudar, mas ajuste o conteúdo de acordo com o padrão dos erros de cada\n caso."}]]}]]}]]]}] 2d:["$","section","6",{"className":"mb-16","children":[["$","h2",null,{"className":"text-2xl md:text-3xl font-bold text-white mb-6","children":"Benefício prático: APIs mais claras, testes mais fáceis"}],[["$","p","0",{"className":"text-gray-300 leading-relaxed mb-6","children":"Com mensagens de erro bem formatadas, o debug fica simples e a automação de testes\n evolui: o front-end sabe exatamente o que validar, o mobile consome os dados certinhos e\n equipes ganham produtividade. Menos tempo perdido em suporte, mais tempo para novas\n features."}],["$","div","1",{"className":"border rounded-xl p-6 mb-8 bg-blue-500/10 border-blue-500/20 text-blue-400","children":[["$","h3",null,{"className":"font-semibold mb-3 flex items-center gap-2 text-blue-400","children":[["$","span",null,{"children":"ℹ️"}],"Fique atento"]}],["$","div