Skip to content

1. Introducción

El PDF del documento está |AQUÍ|.

Los códigos del documento están |AQUÍ|.

Este documento es un producto de la IA Claude de Anthropic. Sigue al documento “Introducción paso a paso al framework web [ASP.NET Core MVC]” (2026), que a su vez siguió al documento “Introducción paso a paso al framework web [NestJS]” (2026). Este documento adapta el curso de [ASP.NET Core MVC] al entorno [Java]:

  • el framework [ASP.NET Core MVC] y el lenguaje [C#] se reemplazan por el framework [Spring MVC], junto con [Spring Boot] 4, y el lenguaje [Java] 21;
  • las vistas [Razor] se reemplazan por vistas [Thymeleaf];
  • el ORM y [Entity Framework Core] se reemplazan por [Spring Data JPA] y el ORM [Hibernate], siempre sobre [MySQL].

El documento sigue de cerca la progresión del curso de [ASP.NET Core MVC]: primero, numerosos proyectos pequeños, cada uno centrado en un solo concepto, seguidos de un caso de estudio completo (una aplicación web para agendar citas en un consultorio médico) con todos los archivos comentados en detalle. Los ejemplos tienen los mismos números y tratan los mismos temas que en el curso de [ASP.NET Core MVC]: un lector que conozca ese curso puede comparar los dos frameworks ejemplo por ejemplo. Sin embargo, esto no es necesario: este documento se basta a sí mismo y no supone ningún conocimiento previo de [ASP.NET] ni, por lo demás, de [Spring]. Los únicos requisitos previos son una comprensión básica de la programación web (el protocolo HTTP, el lenguaje HTML) y del lenguaje [Java].

1.1. El papel de Spring MVC en una aplicación web

Una aplicación web suele construirse en capas, y cada capa se comunica solo con las capas vecinas:

Image

  • la capa web recibe las solicitudes HTTP del navegador y le devuelve páginas HTML. [Spring MVC] nos ayuda a escribir esta capa;
  • la capa de negocio contiene las reglas de negocio de la aplicación (por ejemplo, “un paciente solo puede tener una cita próxima”). No sabe nada de la web: podría servir igualmente a una aplicación de línea de comandos;
  • la capa de acceso a datos (capa [DAO], por [Data Access Object]) lee y escribe en la base de datos. Usaremos [Spring Data JPA], que se apoya en el ORM [Hibernate] ([Object Relational Mapper]) para mapear las filas de las tablas y los objetos en [Java].

La propia capa web sigue el modelo [MVC] ([Model – View – Controller]):

  • el controlador (C) es una clase cuyos métodos, llamados acciones, atienden cada uno un tipo específico de solicitud (por ejemplo, [GET /schedule]). Una acción lee los parámetros de la solicitud, invoca la capa de negocio y luego selecciona la vista que se mostrará;
  • el modelo (M) es el conjunto de datos que la acción pasa a la vista;
  • la vista (V) es un archivo [Thymeleaf] (con la extensión [.html]): una página HTML en la que ciertas etiquetas tienen atributos [th:...] ([th:text], [th:each]...), que el motor [Thymeleaf] reemplaza con datos del modelo.

El procesamiento de una solicitud sigue los pasos numerados del diagrama:

  • 1: El navegador envía una solicitud HTTP, por ejemplo, [GET /schedule?doctorId=1&day=2026-09-24];
  • 2: El servidor web [Tomcat], integrado en la aplicación por [Spring Boot], recibe la solicitud. Esta pasa por una serie de filtros (lectura de cookies, autenticación, etc.) y luego llega a [DispatcherServlet], el único punto de entrada de [Spring MVC], que selecciona la acción responsable de atender esta solicitud: es el enrutamiento. Antes de llegar a la acción, la solicitud todavía puede pasar por interceptores, que exploraremos en capítulos posteriores;
  • 3: La acción solicita a la capa de negocio los datos que necesita; si es necesario, la capa de negocio recurre a la capa [DAO], que consulta la base de datos [MySQL] en SQL;
  • 4: La acción construye el modelo de vista M y designa la vista que debe mostrarlo;
  • 5: El motor de vistas [Thymeleaf] genera el HTML de la página, que [Spring MVC] devuelve al navegador.

[Spring] es el framework más utilizado del mundo ([Java]) para desarrollar aplicaciones empresariales. Gratuito y de código abierto, funciona en cualquier lugar donde funcione [Java] ([Windows], [Linux], [macOS]). [Spring MVC] es el componente web; [Spring Boot] es una capa superior que configura automáticamente todo el conjunto (servidor web, conversión JSON, motor de vistas, acceso a datos, etc.) según las bibliotecas presentes en el proyecto, y convierte la aplicación en un programa [Java] estándar, lanzado por un método [main]. [Spring MVC] puede crear servidores que devuelven JSON a un cliente [JavaScript] ([Angular], [React], [Flutter]...) así como aplicaciones web tradicionales, en las que el servidor genera las páginas HTML y el navegador simplemente las muestra. Este documento se centra en este último caso de uso. Al igual que [ASP.NET Core], [Spring] se basa en dos ideas: las anotaciones ([@GetMapping], [@RequestMapping], [@PreAuthorize]...) describen los roles de las clases y los métodos, y la inyección de dependencias proporciona a cada objeto las dependencias que necesita. [Spring] es, de hecho, uno de los frameworks que popularizaron esta segunda idea.

1.2. Herramientas utilizadas

Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):

  • [JDK] 21 ([Java Development Kit]), que contiene el compilador [javac] y la máquina virtual [java]. [Java] 21 es una versión LTS (soporte a largo plazo);
  • la herramienta de compilación [Maven] 3.9.11, que no necesita instalarse: cada proyecto contiene un Maven Wrapper (los scripts [mvnw] y [mvnw.cmd]), que descarga automáticamente la versión correcta de [Maven] en el primer uso;
  • el editor [Visual Studio Code], junto con las extensiones [Extension Pack for Java] y [Spring Boot Extension Pack] ;
  • un navegador reciente ([Chrome], [Firefox], [Edge]);
  • la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar (viene incluida en [Windows] 10 y 11);
  • el SGBD [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows], a partir del capítulo sobre acceso a datos y para el caso de estudio.

A diferencia del SDK y de [.NET], que contienen [ASP.NET Core], [JDK] no contiene [Spring]: el framework es un conjunto de bibliotecas que [Maven] descarga del repositorio central [Maven Central] durante la primera compilación (por lo que debe estar conectado a Internet ese día) y luego almacena en una carpeta local ([.m2] en el directorio personal del usuario). Estas bibliotecas se agrupan en starters: un starter es una única dependencia que aporta todo lo necesario para una funcionalidad específica. Todos los ejemplos usan [spring-boot-starter-webmvc] ([Spring MVC] y el servidor [Tomcat]); además, están [spring-boot-starter-validation] (validación de datos, a partir del capítulo 3), [spring-boot-starter-thymeleaf] (vistas, a partir del capítulo 4), [spring-boot-starter-security-oauth2-resource-server] ([Spring Security] y los tokens JWT, en el capítulo 8), [spring-boot-starter-data-jpa] y el controlador [mysql-connector-j] (acceso a la base de datos, en el capítulo 9). Las versiones utilizadas son las de [Spring Boot] 4.1.1: [Spring Framework] 7.0.9, [Spring Security] 7.1.1, [Hibernate] 7.4.5, [Thymeleaf] 3.1.5, [Jackson] 3 (conversión desde JSON) y [Tomcat] 11.

1.3. Ejecutar el caso de estudio

Nota del revisor: aconsejo al lector que complete de inmediato el caso de estudio como se describe a continuación. Una vez que comprenda bien el papel de esta aplicación de agenda de citas, pida a su IA favorita que modifique la aplicación de la siguiente manera: a partir de ahora, cada médico podrá:

  • definir sus propios horarios de cita entre dos fechas. Esto le permitirá ajustar su agenda según sea necesario;
  • quitar ciertos horarios del calendario para un día determinado, por ejemplo, si no está disponible por motivos personales;

La modificación no es trivial porque implica un cambio en la estructura de la base de datos. Pida a la IA que le proporcione el nuevo código de la aplicación y el script SQL para crear la nueva base de datos. Para ello, deberá proporcionarle el archivo ZIP con el proyecto completo, así como el script SQL de la base de datos anterior.

Además, no he revisado el curso creado por Claude. Él ya había producido dos cursos perfectos: [NestJS] y [ASP.NET Core MVC]. Supuse que lo mismo ocurriría con este. Si tiene problemas para entender algo, la solución es siempre la misma: pida a su IA favorita que le explique lo que no entiende. Claude, por ejemplo, es muy bueno para esto. Puede que necesite “subirle” el ejemplo que no entiende.

Fin de la nota.

El caso de estudio al final de este documento es una aplicación completa. Es probable que los lectores quieran verla en funcionamiento antes de profundizar en los detalles del framework: así se ejecuta. Se encuentra en la carpeta [rdvmedecins2-spring-mvc], junto a la carpeta [examples]:

1
2
3
springmvc-sept-2026/
├── examples/
└── rdvmedecins2-spring-mvc/

Debe tener instalados [JDK] 21, [Visual Studio Code], y [MySQL] (consulte los apéndices). [Maven] no necesita instalarse. Luego:

  • Cree la base de datos [dbrdvmedecins2] ejecutando el script [rdvmedecins2-spring-mvc/database/dbrdvmedecins2.sql]. Con [Laragon], abra la herramienta [HeidiSQL] (botón Base de datos) y luego ejecute el script desde el menú Archivo / Ejecutar SQL. En la línea de comandos, desde la carpeta [rdvmedecins2-spring-mvc]:
mysql -u root < database/dbrdvmedecins2.sql
  • Compruebe la conexión a la base de datos. La aplicación se conecta a [MySQL] en [localhost], puerto 3306, con el usuario [root] sin contraseña (la configuración predeterminada de [Laragon]). Si su cuenta [root] tiene contraseña, ingrésela en el archivo [src/main/resources/application.properties] de la aplicación, en la línea [spring.datasource.password=] (por ejemplo, [spring.datasource.password=myPassword]). Para evitar escribir una contraseña en un archivo del proyecto, también puede indicarla en la variable de entorno [SPRING_DATASOURCE_PASSWORD], que tiene prioridad sobre el archivo: [set SPRING_DATASOURCE_PASSWORD=myPassword] en [Windows] (símbolo del sistema), [export SPRING_DATASOURCE_PASSWORD=myPassword] en [Linux] y [macOS];
  • abra la carpeta [rdvmedecins2-spring-mvc] en [Visual Studio Code] (menú Archivo / Abrir carpeta) y luego abra una terminal (menú Terminal / Nueva terminal);
  • Inicie la aplicación en [Linux] y [macOS]:
./mvnw spring-boot:run

y en [Windows]:

mvnw spring-boot:run
  • En la primera ejecución, el Maven Wrapper descarga [Maven] y luego [Maven] descarga las bibliotecas de la aplicación, lo que toma unos minutos. Después la aplicación se compila y se inicia. La consola muestra el banner de [Spring Boot] seguido de los mensajes de inicio (aquí solo incluimos los principales):
  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/

 :: Spring Boot ::                (v4.1.1)

... INFO ... rdvmedecins.RdvMedecinsApplication : Starting RdvMedecinsApplication using Java 21.0.10 ...
... INFO ... rdvmedecins.RdvMedecinsApplication : The following 1 profile is active: "dev"
... INFO ... o.s.boot.tomcat.TomcatWebServer    : Tomcat initialized with port 8081 (http)
... INFO ... org.hibernate.orm.core              : HHH000001: Hibernate ORM core version 7.4.5.Final
... INFO ... com.zaxxer.hikari.HikariDataSource : HikariPool-1 - Start completed.
Hibernate: select d1_0.id,d1_0.first_name,d1_0.last_name,d1_0.title,u1_0.id,... from doctors d1_0 ...
Hibernate: select c1_0.id,c1_0.first_name,c1_0.last_name,c1_0.title,u1_0.id,... from clients c1_0 ...
... INFO ... o.s.boot.tomcat.TomcatWebServer    : Tomcat started on port 8081 (http) with context path '/'
... INFO ... rdvmedecins.RdvMedecinsApplication : Started RdvMedecinsApplication in 5.307 seconds (process running for 5.807)

Cada línea comienza con la fecha y la hora (reemplazadas aquí por [...]), seguidas del nivel del mensaje ([INFO], [WARN], [ERROR]), el número de proceso y el nombre del hilo (también reemplazados por [...]) y, por último, el nombre abreviado de la clase que escribe el mensaje. Muestra que la aplicación se ejecuta en el perfil [dev] (un conjunto de configuraciones específicas de desarrollo que, entre otras cosas, muestra las solicitudes SQL), que el servidor [Tomcat] escucha en el puerto 8081, que la conexión a la base de datos se estableció correctamente (el “pool” de conexiones [HikariCP] está listo) y que la aplicación ya leyó la lista de médicos y de clientes (las dos solicitudes SQL). Con [MariaDB], [Hibernate] también muestra una advertencia [HHH000511], que no tiene consecuencias;

  • Abra la URL [http://localhost:8081] en un navegador:

Image

  • Inicie sesión con una de las cuentas de demostración, cuya contraseña es igual al nombre de usuario: [admin] (administrador), [pelissier], [tatou], [dupont] (médicos), [martin], [durand], [bistrou], [german] (pacientes). También debe ingresar los caracteres de la imagen, en mayúsculas o minúsculas.

Cuando la aplicación se inicia, lee la base de datos: si [MySQL] es inaccesible, se detiene de inmediato y la consola muestra el motivo. Si el mensaje es [Communications link failure] (o [Connection refused]), significa que [MySQL] no se ha iniciado; con [Access denied for user 'root'@'localhost'], significa que la contraseña es incorrecta; con [Unknown database 'dbrdvmedecins2'], significa que no se ejecutó el script SQL; con [Port 8081 was already in use], que el puerto 8081 ya está en uso (por la versión [ASP.NET Core] de la aplicación, por ejemplo); con [release version 21 not supported] (o [invalid target release: 21]), que el [JDK] instalado es anterior a la versión 21. El archivo [README.md] de la aplicación describe otros casos. Detenga la aplicación con [Ctrl-C] en la terminal.

El último capítulo del documento explica cómo usar la aplicación y luego analiza cada uno de sus archivos.

1.4. Ejemplos

Los ejemplos se almacenan en la carpeta [examples], con una subcarpeta por ejemplo:

examples/
├── .mvn/
│   └── wrapper/
│       └── maven-wrapper.properties
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   └── bootstrap/
├── mvnw
├── mvnw.cmd
└── pom.xml

Cada ejemplo es un proyecto [Maven] que puede compilarse y ejecutarse por sí solo. Un proyecto [Maven] se describe mediante un archivo [pom.xml] ([Project Object Model]): su identidad, las bibliotecas de las que depende (sus dependencias) y cómo construirlo. Los 28 proyectos son módulos de un proyecto padre, descrito por el archivo [examples/pom.xml]. Los scripts [mvnw] ([Linux], [macOS]) y [mvnw.cmd] ([Windows]) son el Maven Wrapper; el archivo [.mvn/wrapper/maven-wrapper.properties] especifica la versión de [Maven] que debe descargar (3.9.11).

La carpeta [common/bootstrap] contiene el CSS y el framework [Bootstrap], compartidos por los ejemplos que dan formato a sus páginas (a partir del ejemplo 15).

Cada ejemplo tiene la estructura estándar de un proyecto [Maven]:

13-first-view/
├── src/
│   └── main/
│       ├── java/
│       │   └── example13/
│       │       ├── controllers/
│       │       │   └── ViewsController.java
│       │       ├── models/
│       │       │   └── PageModel.java
│       │       └── Example13Application.java
│       └── resources/
│           ├── templates/
│           │   └── views/
│           │       ├── index.html
│           │       └── unknown.html
│           └── application.properties
└── pom.xml
  • [src/main/java]: el código [Java], organizado en paquetes (las carpetas [example13], [example13/controllers]...). Un paquete [Java] actúa como un espacio de nombres de [C#]; el nombre de un paquete refleja la ruta de su carpeta ([example13.controllers]);
  • [Example13Application.java]: la clase de inicio de la aplicación, que contiene el método [main] (véase el ejemplo 01);
  • [controllers]: los controladores;
  • [models]: las clases que describen los modelos (de las acciones y de las vistas);
  • [src/main/resources]: archivos que no forman parte del código [Java];
  • [templates]: las vistas [Thymeleaf] (a partir del capítulo 4);
  • [application.properties]: la configuración de la aplicación (puerto de escucha y, más adelante, conexión a la base de datos, etc.);
  • [pom.xml]: el archivo del proyecto, que describe cómo construir la aplicación.

Durante la compilación, [Maven] crea una carpeta llamada [target] en cada ejemplo, donde almacena las clases compiladas; esta carpeta puede eliminarse sin problema.

Para ejecutar un ejemplo, abra una terminal en la carpeta del ejemplo (en [Visual Studio Code]: haga clic con el botón derecho en la carpeta del ejemplo y seleccione "Abrir en terminal integrada") y escriba lo siguiente en [Linux] y [macOS]:

../mvnw spring-boot:run

y en [Windows]:

..\mvnw spring-boot:run

El Maven Wrapper se encuentra en la carpeta [examples], que es la carpeta padre de la carpeta del ejemplo: de ahí [../] (o [..\]). El comando [spring-boot:run] compila el ejemplo (en su carpeta [target]) y luego inicia la aplicación. Todos los ejemplos escuchan en el puerto 5000: solo uno puede estar en ejecución a la vez. Detenga el servidor ejecutando [Ctrl-C] en la terminal. También puede compilar todos los ejemplos a la vez desde la carpeta [examples] para verificar que la instalación esté completa:

./mvnw compile

([mvnw compile] en [Windows]).

Cuando abre la carpeta [examples] en [Visual Studio Code], la extensión [Extension Pack for Java] encuentra el archivo padre [pom.xml] e importa todos los módulos (aparecen en el panel “Java Projects”): así obtiene resaltado de sintaxis, autocompletado de código e informe de errores en cada archivo. Con su configuración predeterminada, también compila cada archivo [.java] en cuanto lo guarda. La extensión [Spring Boot Extension Pack] añade un panel “Spring Boot Dashboard”, que enumera las aplicaciones encontradas y permite iniciarlas o detenerlas sin usar la terminal (el aspecto exacto de estos paneles depende de la versión de las extensiones). Por último, todos los ejemplos dependen de [Spring Boot DevTools] (véase más adelante): una aplicación en ejecución se reinicia automáticamente, en uno o dos segundos, en cuanto se recompila una de sus clases. Con [Visual Studio Code], por lo tanto, en principio basta con guardar un archivo modificado para que la aplicación lo tome en cuenta.

El archivo [pom.xml] del proyecto padre [examples/pom.xml]:

<?xml version="1.0" encoding="UTF-8"?>
<!--
  pom.xml de la carpeta [examples]: el proyecto PADRE de todos los ejemplos.
  Cada ejemplo es un módulo Maven: su propio pom.xml designa este archivo
  como su padre y, por lo tanto, hereda todo lo que se escribe aquí. Los ajustes
  compartidos por los ejemplos se escriben así una sola vez.
-->
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <!-- el padre Spring Boot: versiones de todas las bibliotecas, configuración de compilación -->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.1.1</version>
    <relativePath/>
  </parent>

  <!-- la identidad de este proyecto -->
  <groupId>course.springmvc</groupId>
  <artifactId>examples</artifactId>
  <version>1.0</version>
  <!-- pom: este proyecto no produce nada por sí mismo, agrupa módulos -->
  <packaging>pom</packaging>

  <properties>
    <!-- Java 21, versión LTS (soporte a largo plazo) -->
    <java.version>21</java.version>
  </properties>

  <!-- los módulos: uno por ejemplo -->
  <modules>
    <module>01-structure</module>
    <module>02-routing</module>
    <module>03-responses</module>
    <module>04-redirects</module>
    <module>05-request-response</module>
    <module>06-services</module>
    <module>07-parameters</module>
    <module>08-model-class</module>
    <module>09-action-validation</module>
    <module>10-arrays</module>
    <module>11-post</module>
    <module>12-custom-binding</module>
    <module>13-first-view</module>
    <module>14-thymeleaf</module>
    <module>15-layout</module>
    <module>16-helpers</module>
    <module>17-get-form</module>
    <module>18-fields</module>
    <module>19-form-validation</module>
    <module>20-prg</module>
    <module>21-links-buttons</module>
    <module>22-i18n</module>
    <module>23-scopes</module>
    <module>24-lifecycle</module>
    <module>25-jwt</module>
    <module>26-roles</module>
    <module>27-captcha</module>
    <module>28-layers</module>
  </modules>

  <!-- las dependencias compartidas por TODOS los ejemplos -->
  <dependencies>
    <!-- Spring MVC y el servidor web Tomcat, integrado en la aplicación -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-webmvc</artifactId>
    </dependency>
    <!-- las herramientas de desarrollo: reinicio automático tras una modificación -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-devtools</artifactId>
      <optional>true</optional>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <!-- el plugin de Spring Boot: mvnw spring-boot:run inicia la aplicación -->
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

Comentemos este archivo:

  • Líneas 14–19: el proyecto padre hereda a su vez de un padre, [spring-boot-starter-parent], versión 4.1.1. Este proyecto fija las versiones de todas las bibliotecas de [Spring] y de las bibliotecas que estas usan, elegidas para funcionar juntas: por eso ninguna dependencia especifica una versión más adelante. También controla la compilación (codificación UTF-8 del código fuente, versión de [Java]...). El elemento vacío [<relativePath/>] indica que este padre no está en una carpeta vecina, sino que debe buscarse en los repositorios de [Maven];
  • líneas 22–24: la identidad del proyecto: un grupo ([groupId]), un nombre ([artifactId]) y una versión. Los módulos usan esta identidad para referirse a su padre;
  • línea 26: un proyecto de tipo [pom] no produce clases ni archivos empaquetados; agrupa módulos y les transmite su configuración;
  • líneas 28–31: la versión de destino de [Java]: [Java] 21;
  • líneas 34–63: los módulos, uno por uno; por ejemplo, el nombre de su carpeta. Un comando de [Maven] ejecutado en la carpeta [examples] se aplica a todos los módulos;
  • líneas 66–78: dependencias comunes a todos los ejemplos, heredadas por cada módulo;
  • líneas 68–71: el starter [spring-boot-starter-webmvc] aporta [Spring MVC], el servidor web [Tomcat] integrado en la aplicación (no es necesario instalar ningún servidor) y la biblioteca [Jackson], que convierte objetos [Java] a JSON;
  • Líneas 73–77: [Spring Boot DevTools], herramientas de desarrollo: reinicio automático de la aplicación cuando se recompila una clase, desactivación de cachés (como la caché de vistas) y mensajes de error más detallados. Son solo para desarrollo: el plugin de [Spring Boot] (líneas 80–88) no las incluye en el archivo ejecutable ([.jar]) destinado a producción, y se desactivan automáticamente si la aplicación se inicia con [java -jar];
  • líneas 80–88: el plugin de [Maven] para [Spring Boot]. Este plugin proporciona el comando [spring-boot:run], así como la creación de un archivo ejecutable ([mvnw package]).

El archivo [pom.xml] de un ejemplo es muy corto. Por ejemplo, [01-structure/pom.xml]:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>course.springmvc</groupId>
    <artifactId>examples</artifactId>
    <version>1.0</version>
  </parent>
  <artifactId>example01</artifactId>
</project>
  • líneas 6–10: el padre, el proyecto [examples], identificado por su ID. El módulo hereda sus dependencias y su configuración y, a través de él, las de [spring-boot-starter-parent];
  • línea 11: el nombre del módulo. Su grupo y su versión son los del padre.

Un ejemplo que requiere una biblioteca adicional la declara en su propio [pom.xml]. Por ejemplo, [13-first-view/pom.xml], que usa el motor de vistas [Thymeleaf]:

1
2
3
4
5
6
7
  <dependencies>
    <!-- las vistas Thymeleaf -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
  </dependencies>
  • Líneas 3–6: una dependencia se identifica por su grupo y su nombre; su versión la fija [spring-boot-starter-parent].

El archivo [src/main/resources/application.properties] comienza igual en todos los ejemplos:

1
2
3
4
# el puerto de escucha del servidor (8080 por defecto)
server.port=5000
# las respuestas de error de Spring Boot no contienen la pila de llamadas
spring.web.error.include-stacktrace=never
  • Línea 2: el puerto de escucha del servidor. Sin esta línea, [Spring Boot] escucharía en el puerto 8080; elegimos el puerto 5000, el usado en el curso de [ASP.NET Core MVC];
  • Línea 4: cuando una solicitud falla, [Spring Boot] devuelve una respuesta de error (lo veremos en el próximo capítulo). Este ajuste garantiza que la respuesta nunca contenga la pila de llamadas (la lista de métodos en ejecución en el momento del error), que revelaría a un atacante información sobre el código de la aplicación.

Cada línea tiene la forma [key=value]; las líneas que comienzan con [#] son comentarios. Algunos ejemplos agregan sus propias claves después de estas dos líneas.

Por último, los ejemplos que usan [Bootstrap] lo encuentran en la carpeta [common/bootstrap], no en su propia carpeta: así, solo existe una copia del archivo. Cada uno de estos ejemplos tiene una clase de configuración que sirve esta carpeta bajo la URL [/bootstrap/...]. Por ejemplo, [15-layout/src/main/java/example15/config/WebConfig.java]:

package example15.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

// la configuración de Spring MVC, complementada
@Configuration
public class WebConfig implements WebMvcConfigurer {

    // Bootstrap, compartido por los ejemplos: la carpeta examples/common/bootstrap
    // se sirve bajo la URL /bootstrap/...
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/bootstrap/**")
                // "file:": una carpeta del disco, relativa a la carpeta actual. Dos
                // intentos: iniciado desde la carpeta del ejemplo, o desde [examples]
                .addResourceLocations("file:../common/bootstrap/", "file:common/bootstrap/");
    }
}
  • líneas 8–9: una clase de configuración para [Spring MVC] (los ejemplos 06 y 12 explicarán este mecanismo);
  • líneas 14–18: los archivos cuya URL comienza con [/bootstrap/] se sirven desde la carpeta [../common/bootstrap/], relativa a la carpeta actual, es decir, la carpeta del ejemplo cuando se inicia como se describió antes. Así, una página puede usar la hoja de estilos [/bootstrap/css/bootstrap.min.css]. La segunda carpeta, [common/bootstrap/], se usa cuando la aplicación se inicia desde la carpeta [examples] y no desde la carpeta del ejemplo.

1.5. Contenido del documento

El documento se desarrolla de la siguiente manera:

Capítulo
Contenido
Ejemplos
Controladores, acciones y
Del navegador a la acción: rutas, respuestas, redirecciones, servicios e inyección de dependencias
01–06
El modelo de la acción
Parámetros de la solicitud: enlace (binding), conversión, validación, formularios POST
07 a 12
La vista y su plantilla
Thymeleaf, plantilla, fragmentos, formularios, validación, PRG
13 a 21
Internacionalización
Una aplicación en francés e inglés
22
Ámbitos de los datos
aplicación, solicitud, sesión, cliente
23
El ciclo de vida de una solicitud
filtros de servlet, interceptores, [@ControllerAdvice], enlace de plantillas, página de error
24
Autenticación y autorización
Spring Security, JWT en una cookie, roles, CAPTCHA, límite de intentos
25–27
Arquitectura en capas
Web / negocio / DAO con Spring Data JPA y MySQL
28
Caso de estudio
La aplicación RdvMedecins, explicada archivo por archivo
-

Cada ejemplo introduce solo unos pocos conceptos nuevos y los capítulos se apoyan unos en otros: lo mejor es leerlos en orden. El caso de estudio, por su parte, recurre a todos los conceptos de los capítulos anteriores: siempre que corresponde, su comentario remite al ejemplo donde se introdujo el concepto. Los apéndices describen cómo instalar las herramientas: [JDK] 21, [Visual Studio Code] y sus extensiones, el Maven Wrapper, [MySQL] con [Laragon] y [curl].