Resolución de Freemarker.core.InvalidReferenceException durante la validación de entrada del usuario en Java

Manejo de InvalidReferenceException en Apache FreeMarker

Java con Spring Boot: enfoque de validación de backend

// 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
}

Plantilla optimizada para manejo de errores en FreeMarker

Enfoque de plantilla Freemarker (.ftlh) para el manejo dinámico de errores

<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>

Prueba unitaria del controlador y proceso de validación

JUnit 5 y MockMVC para pruebas de backend

@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"));
    }
}

Preguntas comunes y soluciones para FreeMarker InvalidReferenceException

1. ¿Qué es InvalidReferenceException en FreeMarker?
2. InvalidReferenceException se produce cuando FreeMarker intenta acceder a una variable nula o faltante. Usando !myDefault en expresiones ayuda a manejar valores nulos.
3. ¿Cómo puedo evitar los errores nulos en las plantillas de FreeMarker?
4. Incorporar el ?? operador para verificar si existe un valor y aplicar un respaldo predeterminado usando el !myDefault operador.
5. ¿Por qué falla mi código de manejo de errores en FreeMarker?
6. Si usas el getFieldError() método en FreeMarker, asegúrese de que el BindingResult El objeto se pasa al modelo en el backend para un manejo de validación adecuado.
7. ¿Cómo funciona el objeto BindingResult en Spring Boot?
8. BindingResult contiene el resultado de la validación del formulario. Captura errores, que se pueden mostrar en la plantilla de FreeMarker para cada campo.
9. ¿Cómo puedo implementar un validador personalizado en Spring Boot?
10. Para crear un validador personalizado, defina una clase que implemente el ConstraintValidator interfaz y aplicarla a los campos que requieren lógica de validación personalizada.

Resumiendo las ideas clave

Manejo de errores como Excepción de referencia no válida en FreeMarker requiere atención tanto a la validación del backend como al manejo de la plantilla del frontend. Asegurando el Resultado vinculante El objeto se completa correctamente y se pasa a la vista es clave para evitar referencias nulas durante la validación del formulario.

Al implementar comprobaciones seguras de valores nulos y proporcionar valores predeterminados alternativos, puede evitar fallos y ofrecer una mejor experiencia de usuario. Comprender cómo sincronizar la validación de datos de formularios con la representación de plantillas es esencial para crear aplicaciones web Java sólidas utilizando FreeMarker.