Resolvendo Freemarker.core.InvalidReferenceException durante a validação de entrada do usuário em Java

Tratamento de InvalidReferenceException no Apache FreeMarker

Java com Spring Boot - Abordagem de validação de back-end

// Backend Controller for Registration Form Handling
@PostMapping("/registration")
public String registration(@ModelAttribute @Valid UserForm userForm,
                               BindingResult result, Model model) {
    // Validate user form using a custom validator
    userValidator.validate(userForm, result);
    // Attach validation errors to the model
    model.addAttribute("errors", result);
    // Check if there are errors in form input
    if (result.hasErrors()) {
        return "registration"; // Return to the registration page
    }
    return "redirect:/"; // Redirect to home page upon success
}

Modelo otimizado para tratamento de erros no FreeMarker

Abordagem do modelo Freemarker (.ftlh) para tratamento dinâmico de erros

<form action="/registration" method="POST">
<label for="name">Name:</label>
<input type="text" id="name" name="name" value="${userForm.name!}" required>
<#if errors?? && errors.hasFieldErrors("name")>
    <div style="color:red;">${errors.getFieldError('name')!['defaultMessage']}</div>
</#if>

<label for="email">Email:</label>
<input type="email" id="email" name="email" value="${userForm.email!}" required>
<#if errors?? && errors.hasFieldErrors("email")>
    <div style="color:red;">${errors.getFieldError('email')!['defaultMessage']}</div>
</#if>

<button type="submit">Register</button>
</form>

Teste de Unidade do Controlador e Processo de Validação

JUnit 5 e MockMVC para testes de back-end

@WebMvcTest(RegistrationController.class)
public class RegistrationControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    public void shouldReturnErrorMessagesForInvalidInput() throws Exception {
        mockMvc.perform(post("/registration")
                .param("name", "")
                .param("email", "invalid-email"))
                .andExpect(status().isOk())
                .andExpect(model().attributeHasFieldErrors("userForm", "name", "email"))
                .andExpect(view().name("registration"));
    }
}

Perguntas comuns e soluções para FreeMarker InvalidReferenceException

1. O que é InvalidReferenceException no FreeMarker?
2. InvalidReferenceException ocorre quando o FreeMarker tenta acessar uma variável ausente ou nula. Usando !myDefault em expressões ajuda a lidar com valores nulos.
3. Como posso evitar erros nulos nos modelos do FreeMarker?
4. Incorpore o ?? operador para verificar se existe um valor e aplicar um substituto padrão usando o !myDefault operador.
5. Por que meu código de tratamento de erros falha no FreeMarker?
6. Se você usar o getFieldError() método no FreeMarker, certifique-se de que o BindingResult O objeto é passado para o modelo no back-end para tratamento de validação adequado.
7. Como o objeto BindingResult funciona no Spring Boot?
8. BindingResult contém o resultado da validação do formulário. Ele captura erros, que podem ser exibidos no modelo FreeMarker para cada campo.
9. Como posso implementar um validador customizado no Spring Boot?
10. Para criar um validador personalizado, defina uma classe que implemente o ConstraintValidator interface e aplique-a a campos que exigem lógica de validação personalizada.

Resumindo os principais insights

Tratamento de erros como InvalidReferenceException no FreeMarker requer atenção tanto à validação de back-end quanto ao manuseio de modelos de front-end. Garantindo o BindingResult O objeto é preenchido corretamente e passado para a visualização é fundamental para evitar referências nulas durante a validação do formulário.

Ao implementar verificações seguras para valores nulos e fornecer padrões substitutos, você pode evitar falhas e proporcionar uma melhor experiência ao usuário. Compreender como sincronizar a validação de dados de formulário com a renderização de modelos é essencial para construir aplicativos Web Java robustos usando o FreeMarker.