4. La vista y su modelo
Hasta este punto, las acciones han generado sus propias respuestas: texto, JSON y algunas etiquetas HTML escritas como una cadena. En una aplicación MVC, este es el papel de una vista: un archivo que describe la página HTML, con marcadores de posición para los datos que le pasa la acción: el modelo de la vista. [Spring MVC] no proporciona por sí mismo un lenguaje de vistas: puede trabajar con varios motores de vistas ([Thymeleaf], [FreeMarker], [Mustache], [JSP]...). Este curso utiliza [Thymeleaf], el motor de vistas más utilizado junto con [Spring MVC], que [Spring Boot] puede configurar por sí solo.
Una vista [Thymeleaf] es un archivo [.html] estándar: un archivo HTML válido que puede abrirse tal cual en un navegador. Los datos se insertan en él mediante atributos adicionales con el prefijo [th:] ([th:text], [th:if], [th:each]...), que [Thymeleaf] ejecuta en el servidor y luego elimina de la página. A esto es a lo que [Thymeleaf] llama plantillas naturales ([natural templates]): un diseñador gráfico puede trabajar en la vista sin iniciar la aplicación, y el desarrollador le agrega los atributos [th:]. Esto difiere de [Razor], el motor de vistas de [ASP.NET Core MVC], que combina HTML y código [C#] precedido por el carácter [@].
4.1. Ejemplo 13: una primera vista
Para utilizar [Thymeleaf], basta con agregar una dependencia al archivo [pom.xml] del ejemplo:
- Líneas 3-6: el [spring-boot-starter-thymeleaf] starter. Un starter es una dependencia "todo en uno": proporciona [Thymeleaf], su integración con [Spring] (la biblioteca [thymeleaf-spring6]) y la configuración automática de [Spring Boot], que los vincula con [Spring MVC]. No hay nada más que escribir: ni versión (la fija el proyecto padre [spring-boot-starter-parent]), ni clase de configuración.
El modelo de la vista es una clase simple. El archivo [models/PageModel.java]:
- Línea 4: un record [Java] (véase el ejemplo 03) es una clase cuyos campos se establecen de una vez por todas mediante el constructor: en este caso, tres cadenas [title], [message] y [time]. El compilador genera automáticamente el constructor y los accesores que leen los campos por nosotros. Nota: estos accesores se nombran igual que el campo ([title()]), y no [getTitle()] como en una clase [JavaBean] (véase el ejemplo 08). Es una forma concisa de escribir una clase que simplemente transporta datos.
El archivo [controllers/ViewsController.java]:
Comentemos este código:
- Línea 17: la anotación [@Controller] reemplaza a la anotación [@RestController] de los ejemplos anteriores. Con [@RestController], lo que devuelve una acción es la respuesta (texto, JSON). Con [@Controller], una acción que devuelve una cadena devuelve el nombre de una vista: es la vista la que generará la respuesta;
- línea 25: la acción recibe un parámetro de tipo [Model], proporcionado por [Spring MVC]. Este es el modelo de la vista: un diccionario, donde cada entrada (un atributo) asocia un nombre con un objeto;
- Líneas 26-30: la acción crea un objeto [PageModel] (un título, un mensaje, la hora actual) y lo almacena en el modelo con el nombre [model]. La vista lo recuperará con este nombre;
- línea 31: la acción devuelve el nombre de la vista, [views/index]. Ya no crea la respuesta; en su lugar, hace referencia a una vista y ha preparado sus datos;
- línea 36: la acción [hello] devuelve un objeto [ModelAndView], que combina el nombre de la vista y su modelo en un solo objeto. Esta es otra forma de escribir una acción que utiliza una vista;
- Línea 38: cuando la vista depende de la solicitud, la acción selecciona la vista. Aquí, el nombre [unknown] muestra la vista [views/unknown], con código de estado 404: el tercer argumento del constructor de [ModelAndView] es el código de respuesta. El modelo de esta vista contiene una cadena simple: el nombre solicitado. [Map.of(...)] crea un diccionario de solo lectura;
- línea 44: las dos acciones comparten la misma vista, [views/index], con modelos distintos.
¿Dónde busca [Spring MVC] la vista [views/index]? Pasa el nombre de la vista a un resolutor de vistas ([ViewResolver]), que lo convierte en una vista concreta. El que configura [Spring Boot] para [Thymeleaf] ([ThymeleafViewResolver]) agrega un prefijo, [classpath:/templates/], y un sufijo, [.html]: la vista [views/index] es el archivo [templates/views/index.html] del classpath, es decir, las carpetas y los archivos comprimidos donde la máquina virtual [Java] busca las clases y los recursos de la aplicación. La carpeta [src/main/resources] del proyecto forma parte de él: [Maven] copia su contenido en [target/classes], junto a las clases compiladas. Estos dos valores pueden modificarse en [application.properties] (propiedades [spring.thymeleaf.prefix] y [spring.thymeleaf.suffix]). A diferencia de [ASP.NET Core MVC], no existe una convención que derive el nombre de la vista a partir de los nombres del controlador y de la acción: la acción siempre especifica la ruta de la vista, relativa a la carpeta [templates]. Los archivos del proyecto:
El archivo [templates/views/index.html]:
Comentemos este código:
- Línea 2: un comentario de [Thymeleaf] se escribe como [<!--/* ... */-->]. Es un comentario HTML cuyo contenido está delimitado por [/*] y [*/]: [Thymeleaf] lo elimina de la página generada, mientras que un comentario HTML normal ([<!-- -->]) se enviaría al navegador;
- Línea 3: el atributo [xmlns:th] declara el espacio de nombres de los atributos [th:]. Está destinado únicamente a los editores de código (autocompletado, validación): [Thymeleaf] procesa los atributos [th:] incluso sin él, y lo elimina de la página generada;
- Línea 6: el atributo [th:text] reemplaza el contenido de la etiqueta por el valor de la expresión. [${model.title}] es una expresión de variable: [model] es el atributo del modelo establecido por la acción, y [.title] llama a su accesor, [title()]. El texto "Page Title" escrito dentro de la etiqueta es solo un ejemplo, que se muestra cuando el archivo se abre directamente en un navegador; desaparece de la página generada;
- líneas 9-11: el mismo principio se aplica al título, al mensaje y a la hora. Para insertar un valor en medio de un texto, envuélvalo en una etiqueta [<span>], que lleva el atributo [th:text].
[${...}] las expresiones se escriben en el lenguaje de expresiones de [Spring], [SpEL] ([Spring Expression Language]). [model.title] llama al método [getTitle()] de un [JavaBean], o al método [title()] de un record: en ambos casos se escribe el mismo código.
Una vista [Thymeleaf] no se compila con la aplicación: se lee y se interpreta cuando se solicita la página. Por lo tanto, un error en una vista no se informa en tiempo de compilación, sino cuando se muestra la página. Si se escribe [${model.titl}] en la vista, la solicitud falla (código de estado 500) y la consola del servidor muestra: [Property or field 'titl' cannot be found on object of type 'example13.models.PageModel']. De manera similar, un nombre de vista que no corresponde a ningún archivo provoca el error [Error resolving template [views/missing], template might not exist or might not be accessible by any of the configured Template Resolvers]. El resultado, en http://localhost:5000/:

El código fuente de la página recibida por el navegador ya no contiene ningún rastro de [Thymeleaf]:
Observe que:
- los atributos [th:text] han desaparecido, reemplazados por los valores del modelo, al igual que el atributo [xmlns:th];
- el comentario [Thymeleaf] ha desaparecido, pero deja una línea en blanco;
- los caracteres acentuados, si los hay (esta página en inglés no tiene ninguno), se escriben tal cual ([é], [è]...): [Thymeleaf] solo escapa los caracteres que tienen significado en HTML ([<], [>], [&], ["], [']). [Razor], en cambio, codifica de manera predeterminada los caracteres acentuados ([è] para [è]), lo que obliga al curso de [ASP.NET Core MVC] a modificar un ajuste; aquí no existe tal requisito.
La URL http://localhost:5000/hello/martin muestra la misma vista con un modelo diferente:

Si el texto hubiera contenido un apóstrofo, el código HTML de esta página lo mostraría como [']: este es uno de los caracteres que escapa [th:text]. La URL http://localhost:5000/hello/unknown muestra una vista diferente:
La respuesta tiene, efectivamente, el código de estado 404 establecido por el objeto [ModelAndView] ([Tomcat] envía solo el código, sin su etiqueta [Not Found]). El archivo [templates/views/unknown.html]:
- línea 9: un texto delimitado por dos barras verticales, [|...|], es una sustitución literal: las expresiones [${...}] que contiene se reemplazan por sus valores. Esto es más legible que una secuencia de [<span>]. [${name}] es el atributo [name] del modelo, una cadena simple.
4.2. Ejemplo 14: el lenguaje Thymeleaf
Una vista [Thymeleaf] no contiene ningún código [Java]: todo se maneja mediante los atributos [th:] y las expresiones que contienen. Sin embargo, incluye condiciones, bucles, variables locales y llamadas a métodos. Este poder exige disciplina: la vista debe seguir siendo un elemento de presentación; los cálculos y las decisiones pertenecen a la acción y a los servicios. El ejemplo 14 ofrece un panorama de la sintaxis. El modelo, archivo [models/BasicsModel.java]:
- líneas 6-15: el modelo es un record: algunas cadenas, un booleano, dos listas de productos y una dirección;
- Líneas 17-21: dos records anidados dentro del primero: [BasicsModel.Product] y [BasicsModel.Address]. Un precio es un [BigDecimal]; este tipo de [Java] representa números decimales exactos (un [double] no puede representar exactamente [0.1]).
El archivo [controllers/BasicsController.java]:
- Líneas 19-31: la acción puebla el modelo: algunas cadenas, un booleano, una lista de tres productos, un carrito de compras vacío y una dirección. El apodo (línea 22) se establece intencionalmente en [null]. [List.of(...)] crea una lista de solo lectura; [List.of()] crea una lista vacía.
La vista, archivo [templates/basics/index.html]:
Comentemos este código:
- Línea 8: el atributo [th:with] declara variables locales que pueden utilizarse dentro de la etiqueta que lo contiene y en todas sus etiquetas hijas (en este caso, [total] y [count]) en todo el cuerpo de la página. [model.products.![price]] es una proyección de [SpEL]: la lista de precios de los productos. [#aggregates] y [#lists] son objetos de utilidad de [Thymeleaf] (comienzan con [#]): [#aggregates.sum] calcula la suma de una lista de números; [#lists.size] cuenta los elementos de una lista;
- líneas 10-11: un comentario [Thymeleaf], que está ausente de la página generada;
- línea 12: un valor [null] ([${model.nickname}]) no muestra nada, sin error;
- líneas 14-15: [th:text] escapa los caracteres especiales de HTML ([<] se convierte en [<]...): el texto se muestra tal cual. [th:utext] ([unescaped text]) lo inserta sin escapar: se interpreta como HTML. [th:utext] solo se utiliza para HTML generado por la aplicación, nunca para datos ingresados por un usuario: el usuario podría inyectar HTML, o incluso [JavaScript], en la página (un ataque conocido como [XSS], [cross-site scripting]);
- Líneas 17-18: una condición. [th:if] conserva la etiqueta (y su contenido) si la expresión es verdadera, y la elimina en caso contrario; [th:unless] hace lo contrario. No existe [th:else]: se escribe la condición opuesta;
- Línea 22: un bucle. El atributo [th:each] repite la etiqueta que lo contiene (en este caso, [<li>]) una vez por cada elemento de la lista. [product] es el elemento actual; [stat], que es opcional, es el estado de la iteración: [stat.index] (comienza en 0), [stat.count] (comienza en 1), [stat.size], [stat.first], [stat.last], [stat.even], [stat.odd]. En el texto de la etiqueta, [[[${product.name}]]] es una expresión en línea: inserta el valor, escapado como en [th:text], sin la etiqueta [<span>] (la forma [[(...)]] inserta sin escapar, como [th:utext]);
- línea 23: el operador condicional [condition ? value1 : value2]. Las cadenas literales se escriben entre comillas simples;
- líneas 24-25: [th:block] es una etiqueta específica de [Thymeleaf]: sirve únicamente para portar los atributos [th:] y desaparece de la página generada, dejando solo su contenido. [stat.first] y [stat.last] verifican la posición dentro del bucle;
- líneas 30-31: el caso de una lista vacía. [#lists.isEmpty] verifica si la lista está vacía; un bucle [th:each] sobre una lista vacía no produce nada;
- línea 34: una sustitución literal [|...|] que utiliza las variables de [th:with], y dos llamadas a métodos: [total.doubleValue()] convierte [BigDecimal] en [double], y [#numbers.formatDecimal(value, 1, 2)] da formato a un número con al menos un dígito antes del punto decimal y exactamente dos después;
- línea 35: una referencia a [model.address.street], y el objeto de utilidad [#strings], que agrupa operaciones sobre cadenas ([toUpperCase], [isEmpty], [contains], [startsWith]...);
- línea 36: [Thymeleaf] procesa únicamente los atributos [th:] y las expresiones en línea [[[...]]]; el resto del texto se copia tal cual. El carácter [@] no tiene aquí ningún significado específico.
El resultado, en http://localhost:5000/:

El código HTML que produce:
Observe que:
- las etiquetas [th:block], los comentarios [Thymeleaf] y las etiquetas eliminadas por [th:if] / [th:unless] dejan líneas en blanco que no tienen efecto en la visualización;
- El precio promedio es [62.17] en [curl] y [62,17] en el navegador. [#numbers.formatDecimal] utiliza el idioma de la solicitud. De manera predeterminada, [Spring MVC] lo lee del encabezado HTTP [Accept-Language] que envía el navegador: un navegador configurado en francés envía [Accept-Language: fr-FR] y recibe una coma; [curl] no envía este encabezado, y el idioma es entonces el del sistema en el que se ejecuta el servidor (en este caso, inglés; en una computadora configurada en francés, [curl] también recibiría una coma). El ejemplo 16 y el capítulo "Internacionalización" tratan este mecanismo;
- los precios en sí ([12.5]) los genera el método [toString] de [BigDecimal], que es independiente del idioma. El ejemplo 16 les da formato.
Para concluir este ejemplo, estos son los cinco tipos de expresiones de [Thymeleaf], que se utilizarán en los ejemplos de este capítulo y del siguiente:
Expresión | Función | Ejemplo |
[${...}] | expresión de variable ([SpEL]): un atributo del modelo, una propiedad, una llamada a un método, un bean ([${@name...}]), un objeto de utilidad ([${#strings...}]) | 13, 14, 16 |
[*{...}] | expresión de selección: una propiedad del objeto designado por el atributo [th:object] | 18, 19, 21 |
[#{...}] | mensaje: texto del archivo [messages.properties], en el idioma de la solicitud | Capítulo siguiente |
[@{...}] | enlace: una URL, con sus variables y parámetros | 16, 21 |
[~{...}] | fragmento: una sección de página que se inserta | 15 a 21 |
Existen numerosos objetos de utilidad: [#strings], [#numbers], [#lists], [#aggregates], [#dates] (fechas [java.util.Date]), [#temporals] (fechas [java.time]: [LocalDate], [LocalDateTime]...), [#locale] (el idioma de la solicitud), [#ids], y [#fields] (formularios, ejemplos 18 y 19)... La documentación de [Thymeleaf] (https://www.thymeleaf.org) los describe todos.
4.3. Ejemplo 15: plantilla, fragmentos y archivos estáticos
Las páginas de un sitio web comparten una plantilla común (encabezado, barra de navegación, pie de página). Para [Thymeleaf], los componentes reutilizables de una página son los fragmentos; y la propia plantilla es un fragmento, en el que cada página inserta su contenido. Por último, las páginas necesitan archivos estáticos (hojas de estilo, imágenes, scripts), que se sirven tal cual, sin pasar por un controlador. Los archivos del ejemplo:
4.3.1. Los archivos estáticos
[Spring Boot] sirve automáticamente, sin un controlador, los archivos de la carpeta de recursos [static] : el archivo [src/main/resources/static/css/styles.css] se sirve en la URL [/css/styles.css]. Si ningún archivo coincide con la URL y ninguna acción la maneja, la respuesta es un 404. Verifiquémoslo:
El encabezado [Last-Modified] proporciona la fecha de modificación del archivo: el navegador devolverá esta fecha para solicitar el archivo solo si ha cambiado.
El framework CSS [Bootstrap] es común a todos los ejemplos: se almacena una sola vez, en la carpeta [examples/common/bootstrap], fuera de los recursos del ejemplo. Por lo tanto, hay que indicar a [Spring MVC] dónde encontrarlo. El archivo [config/WebConfig.java]:
Comentemos este código:
- línea 8: una clase de configuración (véase el ejemplo 06);
- línea 9: la interfaz [WebMvcConfigurer] nos permite complementar la configuración de [Spring MVC] creada por [Spring Boot], sin reemplazarla: solo redefinimos los métodos que nos interesan (todos los demás tienen una implementación predeterminada vacía);
- líneas 14-19: el método [addResourceHandlers] declara directorios de archivos estáticos. Los archivos de la URL que comienzan con [/bootstrap/] (línea 15; [**] designa cualquier secuencia de directorios y archivos) se sirven desde el directorio [common/bootstrap];
- línea 18: el prefijo [file:] designa una carpeta del disco (no del classpath). La ruta es relativa al directorio actual, aquel desde el cual se inició la aplicación: [../common/bootstrap/] si se inicia desde el directorio del ejemplo, [common/bootstrap/] si se inicia desde el directorio [examples]. Ambas ubicaciones se verifican en orden. Así, [examples/common/bootstrap/css/bootstrap.min.css] se sirve en la URL [/bootstrap/css/bootstrap.min.css]. El caso de estudio, en cambio, coloca [Bootstrap] en su propia carpeta, [static].
Todos los ejemplos siguientes utilizan este archivo: [WebConfig.java].
4.3.2. La plantilla
El archivo [templates/layout.html]:
Analicemos este código:
- Línea 4: el atributo [th:fragment] convierte la etiqueta [<html>], y por lo tanto toda la página, en un fragmento llamado [page], que espera dos parámetros: [title] y [content]. Las páginas de la aplicación llamarán a este fragmento, pasándole su título y su contenido;
- línea 8: el parámetro [title] se utiliza como un atributo del modelo;
- líneas 9-10: las hojas de estilo, servidas como archivos estáticos;
- línea 15: el atributo [th:replace] reemplaza la etiqueta que lo contiene (aquí, [<nav>]) por un fragmento. [~{fragments/navbar :: navbar}] es una expresión de fragmento: el fragmento [navbar] del archivo [templates/fragments/navbar.html] (a la izquierda de [::], el nombre de la vista; a la derecha, el nombre del fragmento);
- línea 17: el lugar donde se inserta el contenido de la página, recibido en el parámetro [content]; este parámetro es en sí mismo un fragmento, que [th:replace] inserta en lugar de la etiqueta [<main>];
- línea 19: [path] es la ruta de la página solicitada. No es un parámetro del fragmento: es un atributo agregado al modelo de todas las vistas por una clase que veremos más adelante. [#dates.createNow()] es la fecha actual, y [#dates.year] extrae el año de ella.
Existe un segundo atributo de inserción, [th:insert], que inserta el fragmento dentro de la etiqueta anfitriona en lugar de reemplazarla. Con un fragmento [<span th:fragment="f">...</span>], escribir [<div th:replace="~{:: f}"></div>] produce [<span>...</span>], y [<div th:insert="~{:: f}"></div>] produce [<div><span>...</span></div>] ([~{:: f}], sin nombre de vista, designa un fragmento de la vista actual). Los ejemplos de este curso utilizan [th:replace].
El archivo [templates/fragments/navbar.html]:
- Línea 2: un archivo de fragmentos no es una página completa; contiene una o más etiquetas con el atributo [th:fragment]. Este fragmento no tiene parámetros. Observe que el archivo no declara el espacio de nombres [xmlns:th]; no es necesario.
El archivo [templates/fragments/card.html]:
- Línea 2: el fragmento [card] tiene dos parámetros, un nombre y una función;
- líneas 4-5: los parámetros se utilizan como atributos del modelo.
4.3.3. Las páginas
El archivo [controllers/PagesController.java]:
- Líneas 13-14: el tipo de los miembros del equipo, un record declarado en el controlador ([PagesController.Member]);
- líneas 17-19: la acción [home] no tiene modelo; no necesita el parámetro [Model];
- líneas 22-28: la acción [team] pasa una lista de miembros.
El archivo [templates/pages/home.html]:
Analicemos este código:
- línea 4: el atributo [th:replace] de la etiqueta [<html>] reemplaza toda la página por el fragmento [page] de la plantilla [layout.html]. Le pasa dos parámetros: el título, una cadena literal entre comillas simples, y el contenido, [~{::main}]. Esta expresión de fragmento, que carece de nombre de vista, designa una etiqueta de la vista actual: en este caso, la etiqueta [<main>] (líneas 6-12). Así se genera la página a partir de la plantilla, con la etiqueta de la página reemplazando a la propia de la plantilla, [<main>];
- línea 11: la llamada al fragmento [card], con dos parámetros establecidos directamente.
Todo lo que en la página no esté dentro de la etiqueta [<main>] (la etiqueta [<body>], por ejemplo) desaparece: solo importa el fragmento pasado a la plantilla. Las etiquetas [<html>] y [<body>] se incluyen únicamente para garantizar que el archivo siga siendo una página HTML válida que pueda abrirse en un navegador.
El archivo [templates/pages/team.html]:
- línea 7: la etiqueta [<div class="col-md-4">] se repite para cada miembro;
- línea 9: al fragmento se le asignan el nombre y el rol del miembro actual: la etiqueta con [th:replace] está anidada dentro de la que tiene [th:each], donde se define la variable [member] .
El archivo [templates/pages/raw.html]:
- Líneas 3-11: esta vista no llama a la plantilla; es una página completa sin atributos [th:]. [Thymeleaf] la copia tal cual (excepto el comentario de la línea 2). Una vista no está obligada a utilizar la plantilla.
El código HTML de la página http://localhost:5000/team muestra el resultado del ensamblaje:
El título, la barra de navegación, tres tarjetas y el pie de página se ensamblaron a partir de cuatro archivos: [layout.html], [navbar.html], [team.html] y [card.html].
4.3.4. Un atributo común a todas las vistas
El pie de página de la plantilla muestra la ruta de la página solicitada, [path]. Con [Razor], una vista tiene acceso directo a la solicitud actual. Una vista [Thymeleaf] también podía hacerlo, hasta la versión 3.0, mediante el objeto [#request]: se habría escrito [${#request.requestURI}]. Esto ya no es así a partir de la versión 3.1. Una vista que utiliza [#request] provoca un error 500, y la consola muestra:
Los objetos [#request], [#session], [#servletContext], y [#response] se han eliminado: permitían que una vista leyera cualquier parámetro de la solicitud, lo que abría la puerta a inyecciones, y vinculaban [Thymeleaf] a la API de los servlets. La entrada [${#ctx.request.requestURI}] tampoco funciona: [#ctx.request] equivale a [null]. El mensaje de error ofrece la solución: agregar lo que la vista necesita al modelo. Para que esto se aplique a todas las vistas sin que cada acción tenga que hacerlo, creamos el archivo [config/CommonModel.java]:
Comentemos este código:
- línea 9: la anotación [@ControllerAdvice] designa una clase que extiende todos los controladores de la aplicación. Lo que declara se aplica a cada uno de ellos, como si estuviera escrito en cada uno;
- línea 14: un método anotado con [@ModelAttribute("path")] se ejecuta antes de cada acción; su valor de retorno se agrega al modelo con el nombre [path]. Cuando se escribe en un controlador, se aplica a las acciones de ese controlador (véase el ejemplo 18); cuando se escribe en una clase [@ControllerAdvice], se aplica a todas las acciones de la aplicación;
- Líneas 15-16: el método puede aceptar los mismos parámetros que una acción: en este caso, la solicitud actual, [HttpServletRequest] (véase el ejemplo 05). [getRequestURI()] devuelve la ruta solicitada, sin los parámetros.
El caso de estudio utiliza el mismo procedimiento (su archivo [web/CommonModel.java]) para proporcionar a todas sus vistas la ruta, el idioma y el usuario conectado.
Las páginas resultantes, en la URL http://localhost:5000/, http://localhost:5000/team y http://localhost:5000/raw:



La plantilla, los fragmentos y el atributo común [path] son exactamente lo que usa el caso de estudio: una plantilla [layout.html], fragmentos para la barra de navegación, los mensajes y las ventanas de confirmación.
4.4. Ejemplo 16: Helpers
Una vista suele requerir pequeñas funciones de formato: dar formato a una fecha o a un precio, poner un texto en mayúsculas, crear el HTML de una insignia... Estas se llaman helpers. Con [Thymeleaf], son métodos de beans de [Spring], a los que se llama dentro de una expresión o de un fragmento. [Thymeleaf] también permite crear sus propios atributos, agrupados en un dialecto.
4.4.1. Un bean llamado por las vistas
El archivo [helpers/Formats.java]:
Comentemos este código:
- Línea 16: la anotación [@Component] convierte la clase en un bean: [Spring] la encuentra al iniciar (igual que encuentra los controladores), crea una instancia y la conserva. ["formats"] es el nombre del bean: es el nombre que usarán las vistas para llamarlo;
- líneas 20–22: capitalización. [Locale.ROOT] hace que el resultado sea independiente del idioma del usuario;
- líneas 25–31: un monto en una moneda, con formato según el idioma de la solicitud. [LocaleContextHolder.getLocale()] (línea 27) obtiene este idioma, un objeto [Locale] definido por [Spring MVC] al comienzo de cada solicitud. [NumberFormat.getCurrencyInstance] proporciona el formato de moneda para este idioma: separador decimal, separador de miles y posición del símbolo de la moneda; [setCurrency] selecciona la moneda, identificada por su código internacional ([EUR], [USD]);
- líneas 34–36: un método sobrecargado: mismo nombre, parámetros distintos. Si no se especifica una moneda, la predeterminada es el euro;
- líneas 39–41: una fecha escrita completa ([FormatStyle.FULL]), en el idioma de la solicitud.
La página [templates/pages/products.html] llama a estos métodos:
- líneas 10–12: en una expresión [${...}], la notación [@formats] hace referencia al bean llamado [formats]: [${@formats.money(product.price)}] llama a su método [money]. El valor devuelto por el método lo inserta [th:text], y por lo tanto se escapa;
- Línea 14: la insignia se crea mediante un fragmento, que se describe a continuación.
El archivo [templates/fragments/badge.html]:
- línea 3: un helper que genera HTML es, junto con [Thymeleaf], un fragmento: en este caso, una etiqueta [<span>] que recibe como parámetro el inventario del producto;
- línea 4: el atributo [th:classappend] agrega una clase CSS a las clases existentes de la etiqueta ([badge]): verde ([text-bg-success]) si el producto está en existencia, rojo en caso contrario;
- línea 5: el texto de la insignia, escapado por [th:text]. A diferencia de un helper que generaría HTML en una cadena, un fragmento no tiene que preocuparse por el escape: [th:text] se encarga de ello.
El controlador, archivo [controllers/PagesController.java]:
- línea 19: la página de inicio recibe la fecha de hoy, un [LocalDate] (una fecha sin hora);
- líneas 25–28: la lista de productos.
El archivo [templates/pages/home.html]:
- línea 7: la llamada al método [date] del bean [formats], en una sustitución literal;
- línea 9: el objeto utilitario [#locale] es el lenguaje de consulta.
4.4.2. El lenguaje de consulta
¿Qué determina el idioma de la solicitud? Un bean de [Spring MVC], el resolvedor de idioma ([LocaleResolver]). El que [Spring Boot] instala de forma predeterminada, [AcceptHeaderLocaleResolver], lee el encabezado [Accept-Language] enviado por el navegador: esto es lo que causó resultados distintos para el navegador y para [curl] en el Ejemplo 14. Para facilitar la prueba de ambos idiomas, el Ejemplo 16 lo reemplaza por un resolvedor que lee el parámetro [lang] de la URL. El archivo [config/WebConfig.java]:
Comentemos este código:
- líneas 21–27: los archivos de [Bootstrap], como en el Ejemplo 15;
- líneas 30–33: nuestro dialecto de [Thymeleaf], descrito más adelante, declarado como un bean. [Spring Boot] agrega automáticamente todos los beans que son dialectos al motor [Thymeleaf];
- líneas 38–41: nuestro resolvedor de idioma. El bean debe llamarse [localeResolver]: este es el nombre con el que [Spring MVC] lo busca. Un método llamado [@Bean] proporciona el nombre del bean: [localeResolver()]. Al declarar este bean, reemplazamos el llamado [Spring Boot];
- líneas 45–56: el resolvedor es una clase anidada que implementa la interfaz [LocaleResolver];
- líneas 48–50: el método [resolveLocale] se llama al comienzo de cada solicitud: devuelve francés ([Locale.FRANCE]) si la URL contiene [lang=fr]; en caso contrario, devuelve inglés de Estados Unidos ([Locale.US]). [Spring MVC] almacena este idioma en [LocaleContextHolder], de donde lo recuperan el bean [formats] y los objetos utilitarios de [Thymeleaf];
- líneas 53–55: el método [setLocale] permitiría cambiar el idioma (almacenándolo, por ejemplo, en una cookie). Aquí, el idioma proviene de la URL: el método se niega a funcionar lanzando una excepción.
Esta es una forma sencilla de probarlo; el próximo capítulo lo tratará con más detalle.
4.4.3. Un dialecto de Thymeleaf
La barra de navegación resalta el enlace de la página actual (clase CSS [active] de [Bootstrap]). El archivo [templates/fragments/navbar.html] muestra tres formas de escribir enlaces:
Analicemos este código:
- línea 3: el espacio de nombres [xmlns:ex], como [xmlns:th], está destinado únicamente a los editores;
- línea 7: la primera forma de resaltar el enlace de la página actual: una condición escrita en la vista, que usa el atributo [path] proporcionado por la clase [CommonModel] (idéntica a la del Ejemplo 15). Sin una cláusula “else”, el operador condicional no produce nada cuando la condición es falsa, y [th:classappend] por lo tanto no agrega ninguna clase. Este es el método que se usa en el caso de estudio;
- línea 9: segunda forma, más concisa: un atributo “home”, [ex:active], proporcionado por nuestro dialecto;
- línea 11: una expresión de enlace [@{...}]. [Spring] genera la URL: los paréntesis contienen parámetros, que se agregan a la URL ([?lang=fr]). Veremos en el Ejemplo 21 que también sirven para completar variables de ruta. Una expresión de enlace también agrega, si es necesario, la ruta base de la aplicación cuando esta no está instalada en la raíz del servidor.
Un dialecto es un conjunto de atributos (o etiquetas) que comparten un prefijo: los atributos [th:] son los del dialecto estándar de [Thymeleaf]. Cada atributo es procesado por un procesador. El archivo [helpers/ActiveDialect.java]:
- línea 12: un dialecto que solo proporciona procesadores se deriva de la clase [AbstractProcessorDialect];
- línea 16: el nombre del dialecto, el prefijo de sus atributos ([ex]) y su prioridad: la misma que la de los atributos [th:];
- líneas 21–23: los procesadores del dialecto: solo uno, el del atributo [ex:active]. [Set.of(...)] crea un conjunto inmutable.
El archivo [helpers/ActiveProcessor.java]:
Comentemos este código:
- línea 13: un procesador de atributos derivado de la clase [AbstractAttributeTagProcessor];
- línea 18: su constructor describe lo que procesa: el modo HTML, el prefijo del dialecto, solo las etiquetas [<a>], el atributo [active] (con prefijo: [ex:active]), una prioridad y [true]: el atributo [ex:active] se eliminará de la página generada;
- Líneas 23–24: el método [doProcess] se llama para cada etiqueta [<a>] que tiene el atributo [ex:active]. Recibe el contexto de la vista, la etiqueta y el valor del atributo; el objeto [structure] permite modificar la etiqueta;
- línea 26: el procesador es código [Java], no una expresión de vista: tiene autorización para leer la solicitud actual. Cuando la vista se renderiza para una solicitud web, el contexto es un [IWebContext], que da acceso a el intercambio (la solicitud y su respuesta); [getRequestPath()] devuelve la ruta solicitada. La expresión [context instanceof IWebContext web] comprueba el tipo del contexto y, si corresponde, lo almacena en la variable [web];
- líneas 27–32: si la ruta de la página comienza con el valor del atributo, se agrega la clase [active] al atributo [class] de la etiqueta.
El código HTML de la barra de navegación, en la URL [/products]:
Al enlace “Products” se le asignó la clase [active], y se eliminó el atributo [ex:active] . La expresión de enlace produjo [/products?lang=fr]. Observe que [Thymeleaf] eliminó el atributo [xmlns:th], pero no el atributo [xmlns:ex]: no reconoce este último. Podría haberse omitido, ya que solo lo usan los editores.
La plantilla [layout.html] es la del Ejemplo 15, sin el pie de página (y los títulos de las páginas terminan con [- Helpers] en lugar de [- My site]). Las páginas resultantes, en inglés (http://localhost:5000/, http://localhost:5000/products) y luego en francés (http://localhost:5000/products?lang=fr):



Los precios cambian de formato según el idioma: [1 149,90 €] en francés, [€1,149.90] en inglés. En francés, los dólares se denotan como [$US] para distinguirlos de otras monedas (canadiense, australiana, etc.). El código HTML de la tabla, en francés ([/products?lang=fr]):
y en inglés ([/products]), donde el dólar se escribe simplemente como [$]:
Solo han cambiado los montos: el texto de las insignias está escrito de forma fija en el fragmento (el próximo capítulo traducirá los textos).
4.5. Ejemplo 17: Un formulario GET
Un formulario HTML enviado mediante el método GET coloca sus campos en la URL. Este es el método apropiado para una búsqueda: no modifica nada, y la URL resultante se puede guardar como marcador o compartir. El caso de estudio lo usa para seleccionar un médico y una fecha.
Los archivos [models/Book.java] and [models/SearchModel.java] :
- Línea 6: la plantilla de la vista contiene los valores ingresados ([keyword], [genre]) para que el formulario pueda mostrarlos de nuevo, junto con la lista de géneros y los resultados.
El archivo [controllers/BooksController.java]:
Analicemos este código:
- líneas 17–24: los libros y los géneros, en memoria;
- línea 27: una sola acción puede corresponder a varias rutas; maneja tanto [GET /] como [GET /search];
- líneas 28–29: los parámetros [keyword] y [genre] se enlazan con los parámetros del mismo nombre en la URL (vea el ejemplo 07). [required = false] los hace opcionales: en la primera visita, el formulario aún no se ha enviado y sus valores son [null];
- líneas 31–35: filtrado, mediante un flujo ([stream]) [Java] (vea el Ejemplo 06): [stream()] recorre la lista; cada [filter] conserva solo los libros que cumplen una condición; y [toList()] reúne los libros seleccionados en una nueva lista. Las condiciones son expresiones lambda: [b -> ...] es una función anónima que recibe un libro [b] y devuelve un booleano. Una palabra clave vacía o un género vacío no filtra nada;
- líneas 36–37: la plantilla de la vista. Aquí, los [null] se reemplazan por cadenas vacías.
La plantilla [templates/layout.html] se simplifica: un único parámetro (el contenido de la página) y un título fijo:
- línea 2: el fragmento [page] ahora solo tiene un parámetro, [content];
- Línea 5: el título es el mismo para todas las páginas.
El archivo [templates/books/search.html]:
Analicemos este código:
- Línea 2: la página pasa su único parámetro (la etiqueta [<main>]) a la plantilla;
- Línea 7: [method="get"] y [action="/search"]: enviar el formulario es una solicitud [GET /search?keyword=...&genre=...]. Los nombres de los parámetros son el atributo [name] de cada campo;
- Línea 11: el atributo [th:value] establece el atributo [value] del campo: restaura el valor ingresado. En general, [th:xxx] calcula el valor de los atributos HTML [xxx]: [th:value], [th:href], [th:action], [th:class]...
- Líneas 18–19: una opción por género. Dentro de la misma etiqueta, [th:each] se procesa primero, seguido de [th:value] y [th:text], que usan la variable del bucle. [th:selected] es un atributo booleano: si la expresión es verdadera, [Thymeleaf] escribe [selected="selected"]; si es falsa, no escribe el atributo en absoluto. Esto es exactamente lo que exige HTML; para este atributo, la mera presencia del atributo [selected] basta para seleccionar la opción. Lo mismo se aplica a [th:checked], [th:disabled], [th:required], [th:readonly]...;
- línea 26: el número de resultados;
- línea 28: la lista de resultados, con una etiqueta [<i>] y dos expresiones en línea.
El código HTML de la lista desplegable, tras una búsqueda como [poetry]:
En la visualización inicial (http://localhost:5000/), y luego después de una búsqueda:


La barra de direcciones muestra los parámetros que se enviaron. Aquí solo contienen letras simples; los caracteres especiales se codificarían allí (una [é] con acento se convierte en [%C3%A9], por ejemplo): esta es la codificación de URL, que [Spring MVC] decodifica antes de que se concatenen los parámetros.
4.6. Ejemplo 18: Campos de formulario
El Ejemplo 18 combina todos los tipos de campos HTML: texto, contraseña, fecha, botones de opción, casillas de verificación, lista desplegable, lista de selección múltiple, cuadro de texto y campo oculto. Muestra cómo los recibe el servidor y cómo los muestra la vista. También presenta el atributo [th:field], que vincula un campo de formulario con una propiedad de un objeto del modelo.
El archivo [services/ListsService.java]:
- Línea 11: la anotación [@Service] convierte la clase en un bean, igual que [@Component] (Ejemplo 16): [Spring] la encuentra al iniciar y crea una única instancia, un singleton (vea el Ejemplo 06), que se puede inyectar en los controladores. [@Service] se diferencia de [@Component] solo en la intención que expresa: la clase es un servicio. Las listas que ofrece el formulario son las mismas para todos los usuarios: un singleton es el lugar natural para almacenarlas;
- líneas 14–15: un país: un código y un nombre;
- líneas 17–32: las listas, devueltas por los métodos [getXxx()]. Para una vista, estas son las propiedades del bean [titles], [countries], [hobbies] y [languages] : [${lists.titles}] llamará a [getTitles()].
El archivo [models/Input.java]:
Comentemos este código:
- Líneas 13–23: la entrada es una clase [JavaBean] (campos privados, un constructor sin parámetros y los accesores [getXxx] y [setXxx]), no un record: el enlace del modelo la crea vacía y luego completa cada propiedad con el parámetro del mismo nombre, mediante su getter [setXxx];
- líneas 17 y 19: las casillas de verificación y la lista de selección múltiple son listas: reciben todos los valores enviados (vea el Ejemplo 10). Se inicializan con una lista vacía, nunca con [null];
- Líneas 21–22: un campo [<input type="date">] envía la fecha en el formato [ISO 8601] [yyyy-mm-dd]. La anotación [@DateTimeFormat(iso = DateTimeFormat.ISO.DATE)] especifica este formato a [Spring], que lo usa en ambos sentidos: para convertir el texto recibido a [LocalDate], y para reescribir la fecha en el campo.
El archivo [controllers/FormController.java]:
Analicemos este código:
- líneas 22–26: el servicio de listas se inyecta mediante el constructor (vea el Ejemplo 06);
- líneas 30–33: un método anotado con [@ModelAttribute("lists")], declarado en un controlador, se ejecuta antes de cada acción de ese controlador: ambas acciones encontrarán el atributo [lists] en su modelo, sin tener que agregarlo allí (vea [CommonModel], Ejemplo 15, para todas las acciones de la aplicación);
- líneas 36–45: [GET /form] muestra el formulario con valores iniciales. El objeto se almacena en el modelo con el nombre [input];
- línea 50: [POST /form] recibe los datos ingresados por el usuario. La anotación [@ModelAttribute], aplicada a un parámetro, indica al enlace del modelo que cree el objeto a partir de los parámetros de la solicitud (este es el comportamiento predeterminado para un parámetro de tipo clase; vea el Ejemplo 08) y que lo almacene en el modelo de la vista. Sin un nombre explícito, el nombre del atributo es el de la clase, con la primera letra en minúscula: [input]. El formulario se vuelve a mostrar con los valores recibidos;
- líneas 52–56: [getParameterMap()] también da acceso a los parámetros tal como se enviaron: un diccionario en el que cada valor es un arreglo de cadenas (un parámetro puede repetirse). Esto se convierte en texto, una línea por parámetro, almacenado en la plantilla con el nombre [received]. [Collectors.joining("\n")] concatena las líneas, separadas por un salto de línea.
La plantilla [templates/layout.html] es la del Ejemplo 17 (solo cambia el título). El archivo [templates/form/form.html]:
Analicemos este código:
- Línea 7: el atributo [th:object] especifica el objeto del formulario: el atributo [input] de la plantilla. Dentro de la etiqueta, una expresión de selección [*{name}] hace referencia a la propiedad [name] de este objeto: equivale a [${input.name}];
- Línea 9: el atributo [th:field="*{token}"] vincula el campo con la propiedad [token]: escribe los atributos [id] y [name] (el nombre de la propiedad) y el atributo [value] (su valor). Un campo oculto se envía con el formulario pero no se muestra. Sirve para pasar información de una página a la siguiente (en el caso de estudio, por ejemplo, contiene la versión de un registro). Nota: el usuario puede modificarlo;
- Líneas 14–18: los botones de opción comparten el mismo [name]; solo uno puede estar seleccionado y solo se envía un valor. En un botón de opción, [th:field] no escribe el valor de la propiedad en [value] ([th:value] es el que proporciona el valor del botón): selecciona el botón si su valor coincide con la propiedad. Como todos los botones tienen el mismo nombre, [th:field] les asigna valores de [id] numerados: [title1], [title2]... El objeto utilitario [#ids.prev('title')] (línea 17) establece el valor del último campo [title] en el [id] indicado, para el atributo [for] de su etiqueta;
- línea 25: un campo de texto: [th:field] escribe [id="name"], [name="name"] y el valor. Por lo tanto, la etiqueta de la línea 23 puede escribir directamente [for="name"];
- línea 30: una contraseña nunca se devuelve en una página: el campo no usa [th:field] y no tiene un atributo [value];
- línea 35: un campo de fecha. El navegador muestra la fecha en su propio formato, pero siempre envía y recibe [yyyy-mm-dd]; [th:field] escribe la fecha en este formato, gracias a la anotación [@DateTimeFormat];
- Líneas 42–45: casillas de verificación con el mismo [name]: cada casilla marcada envía su valor, por lo que el parámetro se repite. [th:field] marca la casilla si su valor está en la lista [hobbies];
- líneas 51–53: una lista desplegable. [th:field] en la etiqueta [<select>] selecciona la opción cuyo valor es igual a la propiedad [country];
- líneas 58–60: el atributo [multiple] permite seleccionar varias opciones: [th:field] selecciona todas las opciones que pertenecen a la lista [languages];
- línea 67: el valor de un cuadro de texto está contenido entre sus etiquetas, no en un atributo [value]: [th:field] lo sabe;
- líneas 73–76: lo que recibió el servidor, que se muestra solo después del envío, dentro de una etiqueta [<pre>], que conserva los saltos de línea.
Este es un extracto del código HTML generado por estos atributos [th:field] (el campo oculto, el segundo botón de opción, las dos primeras casillas de verificación, la lista desplegable):
Observe los campos ocultos que no escribimos: [_hobbies] después de cada casilla de verificación, [_languages] antes de la lista desplegable. Resuelven un problema de HTML: una casilla sin marcar no se envía en absoluto. Si el usuario desmarca todas las casillas, el parámetro [hobbies] falta en la solicitud, y el enlace del modelo no actualizaría la propiedad [hobbies], que conservaría su valor anterior. El [_hobbies] marcador, en cambio, siempre se envía: cuando [Spring] lo encuentra sin el parámetro [hobbies], vacía la lista (o establece [false] en un valor booleano). Aquí, la entrada es un objeto nuevo cuya lista ya está vacía, por lo que la diferencia no se aprecia; importa cuando el objeto del formulario se ha completado previamente (por ejemplo, almacenado en una sesión; vea el capítulo “Ámbitos de datos”).
El formulario inicial (http://localhost:5000/form), y luego después del envío:


Observe que:
- El cuadro de texto mostró "[Hello <b>whole</b> world]" exactamente como se ingresó: "[th:field]" escapa el valor, y las etiquetas ingresadas no se interpretan;
- La contraseña se recibió pero no se muestra;
- El navegador envió los marcadores [_hobbies] (uno por casilla de verificación) y [_languages].
Con [curl], podemos ver la diferencia cuando una casilla está marcada:
y con dos casillas marcadas:
(solo se reproduce la etiqueta [<pre>] de la página). La opción [-d] de [curl] envía una solicitud POST, con este cuerpo, y el encabezado [Content-Type: application/x-www-form-urlencoded] de un formulario HTML.
4.7. Ejemplo 19: Validación de formularios
Un formulario no válido debe volver a mostrarse, con los valores ingresados y un mensaje debajo de cada campo con error. El Ejemplo 19 aplica la técnica del Ejemplo 09 (validación realizada por la acción, usando el parámetro [BindingResult]) a un formulario de registro y muestra cómo [Thymeleaf] muestra los errores.
La validación requiere una dependencia adicional. El archivo [pom.xml]:
- líneas 7–11: el starter de validación: la API [Bean Validation] (las anotaciones [@NotBlank], [@Size]...) y su implementación, [Hibernate Validator] (vea el Ejemplo 08).
El archivo [models/RegistrationModel.java]:
Comentemos este código:
- líneas 16–18: el nombre es obligatorio ([@NotBlank] rechaza [null], una cadena vacía y una cadena formada solo por espacios) y se limita a 20 caracteres;
- líneas 20–22: [@Email] valida el formato de una dirección de correo electrónico;
- líneas 25–28: la edad se convierte a un entero y luego se valida. El tipo [Integer] (no [int]) admite el valor [null]: una edad ausente permanece como [null], y [@NotNull] lo señala;
- líneas 30–32: al menos 6 caracteres. [@Size] no valida un valor [null]: esa es la función de [@NotBlank];
- líneas 38–41: la regla “la confirmación coincide con la contraseña” se aplica a dos campos. [Bean Validation] no tiene una anotación predefinida para esto; la solución más sencilla es un método booleano que realiza la comparación, anotado con [@AssertTrue]: la restricción se viola si el método devuelve [false]. Para [Bean Validation], un método llamado [isXxx()] sirve como accesor de una propiedad booleana: por lo tanto, cualquier error se asociará a la propiedad [confirmationValid]. [Objects.equals] compara dos objetos, al igual que [null].
El archivo [controllers/RegistrationController.java]:
Analicemos este código:
- Líneas 25–28: un método anotado con [@InitBinder] configura el enlace del modelo para las acciones de este controlador. Recibe el objeto [WebDataBinder], que realiza el enlace. Allí se registra un editor de propiedades para el tipo [String]: [StringTrimmerEditor] elimina los espacios iniciales y finales de cada cadena recibida; con el argumento [true], una cadena vacía se convierte en [null]. Un nombre ingresado [" Martin "] se convierte en ["Martin"]. Nota: esto se aplica a todas las cadenas, incluidas las contraseñas;
- líneas 31–36: el formulario vacío. El parámetro [html5] se explicará más adelante. El objeto del formulario se almacena en la plantilla con el nombre [registration];
- línea 40: [@Valid] solicita la validación del objeto; [@ModelAttribute("registration")] lo almacena en el modelo con el nombre [registration], el mismo que en la línea 33, que es el que usa la vista. El parámetro [BindingResult] debe seguir inmediatamente al objeto validado: recibe los errores de enlace y de validación, y la acción se ejecuta siempre (vea el Ejemplo 09);
- línea 41: [@RequestParam] lee un parámetro de la URL o del cuerpo de la solicitud: aquí, [html5] proviene de la URL del formulario;
- líneas 42–50: si hay errores, el formulario se vuelve a mostrar con los valores ingresados (excepto las contraseñas) y un mensaje general almacenado en la plantilla. No hay nada más que hacer: el objeto [registration] y sus errores ([BindingResult]) ya están en el modelo, donde los encontrará la vista;
- línea 51: en caso contrario, la página de bienvenida, que también usa el objeto [registration] del modelo.
Un error de conversión (una edad [abc]) genera un mensaje predeterminado en inglés que es difícil de leer: [Failed to convert property value of type java.lang.String to required type java.lang.Integer for property age; For input string: "abc"]. El archivo [messages.properties] lo reemplaza:
- Línea 3: [Spring Boot] lee automáticamente el archivo de recursos [messages.properties]: es el archivo de mensajes de la aplicación (el próximo capítulo explicará cómo se localiza en varios idiomas). En caso de un error de conversión, [Spring] busca un mensaje bajo varias claves, de la más específica a la más general: [typeMismatch.registration.age] (el objeto y su propiedad), [typeMismatch.age] (la propiedad), [typeMismatch.java.lang.Integer] (el tipo esperado) y, por último, [typeMismatch]. El primero que se encuentra tiene prioridad; de lo contrario, se usa el mensaje en inglés. En un archivo de este tipo, un apóstrofo debe escribirse dos veces (en francés, por ejemplo: [n''est]): la clase [MessageFormat] de [Java] procesa los mensajes, y para ella el apóstrofo simple es un carácter especial. Por eso el caso de estudio reemplaza todos estos mensajes.
4.7.1. Un fragmento de campo
Todos los campos siguen el mismo patrón: una etiqueta, un campo y un mensaje de error. Un fragmento extrae estos componentes. El archivo [templates/fragments/field.html]:
Comentemos este código:
- Línea 5: el fragmento [field] se declara sin firma, es decir, sin lista de parámetros. Se llamará con parámetros con nombre ([field(name='age', label='Age', ...)]), que se convierten en variables del fragmento; un parámetro que no se proporciona simplemente se establece en [null]. Esto es útil para un fragmento con muchos parámetros opcionales. [th:with] declara la variable [key]: el nombre de la propiedad para la que se muestra el error. El operador [?:] (conocido como “Elvis”) devuelve su operando izquierdo si no es [null], y su operando derecho en caso contrario: [errorOf] si se proporciona, [name] en caso contrario;
- Línea 9: [th:type] escribe el atributo [type]. [th:field] debe recibir el nombre de la propiedad, que se almacena en la variable [name]. No se puede escribir [*{name}] (esa sería la propiedad [name]): se usa el paso de preprocesamiento [__...__]. La expresión entre los guiones bajos dobles se evalúa primero, y su resultado reemplaza el texto: si [name] es igual a [email], el atributo se convierte en [th:field="*{email}"], que luego se evalúa normalmente. [th:field] usa el objeto del formulario ([th:object]), declarado por la vista que inserta el fragmento;
- línea 10: [#fields.hasErrors(key)] indica si la propiedad tiene errores en el [BindingResult] del objeto del formulario. Las clases [Bootstrap] y [is-invalid] resaltan entonces el campo en rojo;
- línea 11: el atributo booleano [required] se escribe si [required] es verdadero; de lo contrario, se omite;
- línea 12: [th:attr] escribe varios atributos a la vez. Un atributo con valor [null] no se escribe: cada campo recibe solo las restricciones HTML5 que le corresponden;
- línea 14: el mensaje de error, debajo del campo (clase [Bootstrap] [invalid-feedback]). [#fields.errors(key)] devuelve la lista de mensajes de la propiedad; una propiedad puede violar varias restricciones, y solo se muestra la primera ([[0]]).
El archivo [templates/registration/registration.html]:
- líneas 6–7: el enlace que activa o desactiva la validación por parte del navegador;
- línea 10: el atributo [action] del formulario conserva el parámetro [html5];
- línea 11: el atributo booleano [novalidate] se establece cuando [html5] es falso. [th:object] hace referencia al objeto del formulario, [registration];
- Líneas 12–16: cada campo es una inserción del fragmento, con parámetros con nombre. Para la confirmación (línea 16), el error que se debe mostrar es el de la propiedad [confirmationValid] y el de la regla [@AssertTrue].
El archivo [templates/layout.html]:
- Línea 13: el mensaje global se muestra en la parte inferior de la página sobre un fondo rosa claro (clase [error-area] derivada de [static/css/styles.css]), como se ve en el caso de estudio.
El archivo [templates/registration/welcome.html]:
- Línea 4: [th:object] no está reservado para formularios: en la etiqueta [<main>], permite escribir [*{name}] en lugar de [${registration.name}];
- Líneas 5–6: los valores convertidos y limpiados: la edad es un número, y el nombre ya no contiene espacios.
El formulario vacío (http://localhost:5000/register), y luego enviado con varios errores (un nombre formado por espacios, una dirección incompleta, una edad demasiado baja, y contraseñas demasiado cortas y diferentes):


y luego completado correctamente (con espacios alrededor del nombre):

Y con una edad no numérica, enviada con [curl] (el navegador la habría rechazado en un campo [type="number"]):
Observe que:
- el error de conversión de la edad usa el mensaje de [messages.properties];
- el campo [age] no vuelve a mostrar el valor rechazado [abc]: en un campo [type="number"], [th:field] no escribe un valor que no sea un número (con [type="text"], habría escrito [value="abc"]);
- la contraseña ausente tiene un solo error, “required”: [@Size] no valida un valor [null]. En cambio, la confirmación no tiene errores: dos contraseñas ausentes son iguales;
- los campos sin errores no tienen la clase [is-invalid], y su fragmento no genera ningún mensaje.
4.7.2. Validación del navegador
Los atributos [required], [maxlength], [min], [max], [type="email"]... indican al navegador que valide el formulario antes de enviarlo: se notifica de inmediato al usuario mediante un tooltip, sin ninguna comunicación de ida y vuelta con el servidor. Este es el comportamiento que se obtiene al hacer clic en el enlace “enable it” (http://localhost:5000/register?html5=true), que elimina el atributo [novalidate] del formulario.
Esta validación es una comodidad, no una medida de seguridad: se puede eludir simplemente eliminando el atributo [required] con las herramientas para desarrolladores del navegador, o enviando la solicitud con [curl]. La validación en el servidor sigue siendo esencial. Por eso el ejemplo desactiva la validación del navegador de forma predeterminada: para demostrar cómo funciona el servidor. El caso de estudio, en cambio, conserva ambas: los atributos HTML5 por comodidad y la validación en el servidor por seguridad.
4.8. Ejemplo 20: El patrón Post/Redirect/Get
Cuando un formulario POST se envía con éxito, la acción puede mostrar una página directamente. El problema surge si el usuario actualiza esa página (tecla F5): el navegador reenvía el formulario y la operación se realiza por segunda vez (un pedido realizado dos veces, una cita programada dos veces...). El patrón Post / Redirect / Get (PRG) evita este problema: una acción POST exitosa no genera una página; en su lugar, redirige a una página GET. Volver a cargar esta página simplemente activa otro GET, sin ningún efecto.
Queda un detalle: la página GET debe mostrar un mensaje (“la tarea se ha agregado”), aunque este mensaje lo haya generado la acción POST en una solicitud distinta. [Spring MVC] proporciona los atributos flash para este fin: atributos definidos antes de la redirección, que persisten hasta la siguiente solicitud, donde se agregan a la plantilla y luego desaparecen. Esto se conoce como un mensaje flash. De forma predeterminada, [Spring MVC] almacena los atributos flash en la sesión HTTP del usuario: un espacio de memoria que el servidor asocia con cada navegador (el capítulo “Ámbitos de datos” está dedicado a este tema).
El archivo [services/TasksService.java]:
- línea 13: un singleton es compartido por todas las solicitudes, que pueden ejecutarse simultáneamente. Un [ArrayList] estándar no lo admite; [CopyOnWriteArrayList] es una lista diseñada para este fin;
- Líneas 15–17: [List.copyOf] devuelve una copia de solo lectura de la lista: quien la llama no puede modificar la lista del servicio.
El archivo [controllers/TasksController.java]:
Comentemos este código:
- líneas 24–28: la página de la lista;
- línea 33: un parámetro de tipo [RedirectAttributes], proporcionado por [Spring MVC]: los atributos de redirección;
- líneas 35–40: una entrada no válida: la página se vuelve a mostrar sin redirección (la entrada y el mensaje de error deben conservarse). La línea 39 simplemente llama al método [display], como cualquier método [Java]: agrega la lista de tareas a la plantilla y devuelve el nombre de la vista;
- Línea 43: una entrada válida: después de la operación, [addFlashAttribute] muestra el mensaje flash;
- línea 45: una cadena que comienza con [redirect:] no es un nombre de vista: [Spring MVC] responde con una redirección (código 302) a la dirección indicada (vea el ejemplo 04);
- líneas 49–54: el contraejemplo, a modo de comparación: una página como respuesta a POST.
El archivo [templates/tasks/tasks.html]:
- línea 10: la entrada, que se vuelve a mostrar tras un error (el atributo [label] no existe en los demás casos: el campo está vacío);
- línea 13: el atributo [formaction] de un botón envía el formulario a una dirección distinta de la del atributo [action] del formulario. Así, el formulario tiene dos botones, que activan dos acciones diferentes. El caso de estudio usa este enfoque en su página de inicio de sesión;
- línea 15: un atributo ausente de la plantilla se establece en [null], y [th:if] trata [null] como falso.
El archivo [templates/layout.html]:
El mensaje flash se muestra en la parte superior de la página (línea 12) y el error en la parte inferior (línea 14). Desde el punto de vista de la vista, un atributo flash es simplemente otro atributo del modelo.
Esto es lo que ve [curl] cuando el formulario se envía con éxito. La opción [-c file] guarda las cookies recibidas, [-b file] las envía de vuelta; [--data-urlencode] codifica los espacios y los acentos en el campo:
La respuesta es una redirección a [/tasks]. Para almacenar el mensaje flash, [Spring MVC] creó una sesión HTTP: el servidor ([Tomcat]) le asignó un identificador, que se envió al navegador en la cookie [JSESSIONID]. La siguiente solicitud devuelve esta cookie, lo que permite al servidor recuperar la sesión y el mensaje:
El mensaje flash se muestra; si se vuelve a cargar la página, desaparece. Sin embargo, la sesión permanece abierta: su identificador no cambia y el servidor no vuelve a enviar la cookie.
El archivo [application.properties] contiene un ajuste relacionado con la sesión:
- Línea 7: la sesión se rastrea únicamente mediante una cookie. Sin este ajuste, [Tomcat] no sabe, durante la primera respuesta, si el navegador acepta cookies: envía la cookie, pero además agrega el identificador de sesión a la URL de redirección. El resultado es:
La URL y [/tasks;jsessionid=...] funcionan, pero aparecen en la barra de direcciones del navegador, y un identificador de sesión que circula en la URL (historial de navegación, marcadores, enlaces copiados) representa un riesgo de seguridad. Todos los ejemplos que usan atributos flash tienen este ajuste.
En el navegador (http://localhost:5000/tasks), después de agregar una tarea:

La barra de direcciones muestra [/tasks]: esta es la página GET. Se puede volver a cargar sin riesgo; el mensaje desaparece. Una entrada con espacios:

Y el contraejemplo:

Aquí, la barra de direcciones muestra [/tasks/without-prg], la dirección del POST. Volver a cargar la página activa una advertencia del navegador (“Confirm form submission”) y luego agrega la tarea por segunda vez. Todos los formularios POST del caso de estudio siguen el esquema PRG. Sin embargo, el caso de estudio almacena sus atributos flash en una cookie en lugar de en la sesión, porque su servidor no conserva ningún dato entre solicitudes.
4.9. Ejemplo 21: Enlaces, botones y confirmación
Una regla simple guía la elección entre un enlace y un botón:
- un enlace ([<a href>]) genera una solicitud (GET). Una solicitud (GET) no debe modificar nada: los navegadores, los motores de búsqueda y los antivirus pueden seguir los enlaces por su cuenta para preparar una página o analizarla;
- una operación que modifica datos (agregar, editar, eliminar, cerrar sesión) es un botón en un formulario POST.
El Ejemplo 21 gestiona una lista de contactos: se consulta un contacto mediante un enlace y se elimina con un botón, que abre una ventana de confirmación. Los archivos de este ejemplo:
El archivo [services/ContactsService.java]:
Comentemos este código:
- líneas 14–15: un contacto;
- líneas 17–20: la lista de contactos: un [ArrayList] (modificable), inicializado con tres contactos;
- línea 24: la palabra clave [synchronized] garantiza que solo una solicitud a la vez ejecute un método [synchronized] del objeto: las solicitudes simultáneas no pueden modificar la lista al mismo tiempo. Esta es una solución distinta de la lista [CopyOnWriteArrayList] del Ejemplo 20;
- líneas 29–31: [read] devuelve un [Optional<Contact>] (vea el Ejemplo 06): un objeto que contiene un contacto, o nada si ningún contacto tiene ese identificador. [findFirst()] devuelve el primer elemento del flujo como un [Optional];
- líneas 36–38: un record es inmutable: sus campos no se modifican; en su lugar, se reemplaza por uno nuevo;
- línea 46: [++lastId] incrementa el contador antes de usarlo: los identificadores siguientes son 4, 5...;
- línea 53: [ifPresent] ejecuta una acción si [Optional] contiene un contacto. [contacts::remove] es una referencia a método: una forma abreviada de escribir la lambda [c -> contacts.remove(c)].
El archivo [controllers/ContactsController.java]:
Comentemos este código:
- líneas 28–38: las dos páginas: la lista y el perfil del contacto. La restricción [{id:\\d+}] (vea el Ejemplo 02) solo acepta un identificador formado por dígitos;
- línea 36: [orElseThrow] devuelve el contacto contenido en [Optional] o, si está vacío, lanza la excepción generada por la función que se le pasa: aquí, la referencia a método [ContactsController::notFound];
- líneas 41–47: guardado de un registro con PRG. Los parámetros [name] and [phone] son obligatorios: [@RequestParam] no se puede usar sin [required = false];
- líneas 50–56: duplicación, activada por un segundo botón del mismo formulario (atributo [formaction]);
- líneas 58–63: eliminación, mediante un POST;
- líneas 66–68: una excepción [ResponseStatusException] lleva un código HTTP y un motivo. Cuando la lanza una acción, genera una respuesta de error con ese código: en este caso, 404. Un contacto inexistente provoca así un 404 en las acciones [details], [save] y [delete]; en cambio, la duplicación no vuelve a leer el contacto: crea una copia a partir de los campos recibidos.
El archivo [templates/contacts/list.html]:
- Línea 13: Ver: un enlace, que [Bootstrap] muestra como un botón. La expresión de enlace [@{/contacts/{id}(id=${contact.id})}] contiene una variable de ruta [{id}], que se completa con el parámetro del mismo nombre entre paréntesis: [/contacts/1]. Un parámetro que no corresponde a ninguna variable de ruta se agrega después de [?] (vea el Ejemplo 16);
- líneas 15–16: eliminar: un pequeño formulario POST, reducido a su botón. El atributo [data-confirmation] contiene la pregunta que se debe hacer antes del envío. Los atributos [data-*] no están especificados: HTML los ignora, mientras que el [JavaScript] de la página puede leerlos. [Thymeleaf] puede escribir cualquier atributo: [th:data-confirmation] calcula el atributo [data-confirmation], cuyo valor se escapa.
El archivo [templates/contacts/details.html]:
- línea 4: [th:object] en la etiqueta [<main>]: el contacto es el objeto seleccionado, y [*{id}] hace referencia a su identificador;
- línea 6: la dirección del formulario, con una variable de ruta completada mediante una expresión de selección;
- Líneas 9 y 13: este formulario no usa [th:field]: los campos no están vinculados a un objeto de formulario, por lo que [th:value] es suficiente;
- líneas 16–17: dos botones de envío para el mismo formulario; el segundo tiene su propio atributo [formaction].
4.9.1. La ventana de confirmación
El cuadro de diálogo del navegador ([window.confirm]) no se puede formatear ni traducir: sus botones permanecen en el idioma del navegador. Se reemplaza por una ventana de [Bootstrap], que está incrustada en la página y oculta hasta que se necesita. El archivo [templates/fragments/confirmation.html]:
- línea 2: un fragmento sin parámetros. La clase [d-none] oculta la ventana;
- línea 3: el fondo gris;
- línea 11: la ubicación de la pregunta;
- líneas 14–15: los dos botones, identificados por el atributo [data-action].
El archivo [templates/layout.html]:
- línea 11: el mensaje flash;
- línea 15: la ventana aparece en todas las páginas;
- línea 17: el script se carga al final de la página; cuando se ejecuta, los elementos que busca ya existen. Se sirve como archivo estático desde [static/js/app.js].
Una pequeña porción de [JavaScript] vincula los formularios con la ventana. El archivo [static/js/app.js]:
- línea 3: el código está envuelto en una función que se ejecuta de inmediato, para evitar crear variables globales;
- líneas 9–16: se intercepta el envío de cada formulario que tiene el atributo [data-confirmation]. [preventDefault()] suspende el envío; se guarda el formulario, la pregunta se coloca en la ventana ([textContent], no [innerHTML]: la pregunta se muestra como texto, nunca se interpreta como HTML) y se muestra la ventana;
- Líneas 19–27: “Yes” envía el formulario guardado. El método [submit()] de un formulario lo envía sin activar el evento [submit]: no aparece una nueva solicitud de confirmación. “No” oculta la ventana.
Si [JavaScript] está desactivado, los formularios simplemente se envían sin confirmación: la aplicación sigue funcionando. Este es el principio de la mejora incremental: [JavaScript] aporta comodidad, pero no es esencial. El caso de estudio sigue este principio (su script [static/js/app.js] agrega el manejo del teclado: tecla Esc, foco). Las páginas resultantes, desde http://localhost:5000/contacts: la lista, la solicitud de confirmación, la lista tras la eliminación y el perfil de un contacto:




Por último, verificamos que la eliminación no se puede activar mediante una consulta GET:
La ruta existe, pero no para el método GET: [Spring MVC] devuelve [405 Method Not Allowed], y el encabezado [Allow] indica el método aceptado. El cuerpo de la respuesta es la respuesta de error de [Spring Boot], como se ve en JSON con [curl] (un navegador que solicita HTML recibe una página de error). Con POST:
La eliminación se realizó, seguida de una redirección a la lista; la cookie [JSESSIONID] es la cookie de sesión que transporta el mensaje flash. Y un contacto inexistente:
La respuesta 404 repite el motivo indicado para la excepción [ResponseStatusException] ([unknown contact]). Este campo, [message], solo está presente durante el desarrollo: las herramientas de desarrollo de [Spring Boot] ([devtools], una dependencia de todos los ejemplos) habilitan su visualización; sin ellas, la respuesta contiene solo el código, el error y la ruta.