Patrón MVC (Modelo Vista Controlador) en Java y Spring
Qué es el patrón MVC: responsabilidades de modelo, vista y controlador, un ejemplo en Java puro y cómo se aplica en Spring MVC con Thymeleaf o una API REST.
En resumen: MVC divide una aplicación en tres partes: el Modelo (datos y reglas de negocio), la Vista (cómo se presenta la información) y el Controlador (recibe la acción del usuario, actualiza el modelo y elige qué vista mostrar). Cada parte puede cambiar sin tocar las otras: puedes pasar de una consola a una web sin reescribir las reglas. Spring MVC aplica este patrón en cada
@Controller. Ejemplo probado con Java 25, compatible desde Java 17.
Vídeo explicativo
Responsabilidades
| Parte | Hace | No hace |
|---|---|---|
| Modelo | Guarda datos y aplica reglas (una tarea no puede estar vacía) | Imprimir, leer peticiones |
| Vista | Muestra lo que recibe | Decidir reglas de negocio |
| Controlador | Traduce la acción del usuario, llama al modelo, elige la vista | Guardar estado de negocio |
MVC en Java puro
import java.util.ArrayList;
import java.util.List;
// Modelo: datos y reglas, sin saber nada de cómo se muestran
class ListaTareas {
private final List<String> tareas = new ArrayList<>();
void anadir(String tarea) {
if (tarea == null || tarea.isBlank()) {
throw new IllegalArgumentException("La tarea no puede estar vacía");
}
tareas.add(tarea.strip());
}
void completar(int indice) {
tareas.remove(indice);
}
List<String> todas() {
return List.copyOf(tareas);
}
}
// Vista: solo presenta lo que recibe
class VistaConsola {
void mostrar(List<String> tareas) {
System.out.println("Tareas (" + tareas.size() + "):");
for (int i = 0; i < tareas.size(); i++) {
System.out.println(" " + i + ". " + tareas.get(i));
}
}
void error(String mensaje) {
System.out.println("Error: " + mensaje);
}
}
// Controlador: recibe la acción del usuario, actualiza el modelo y elige qué mostrar
class ControladorTareas {
private final ListaTareas modelo;
private final VistaConsola vista;
ControladorTareas(ListaTareas modelo, VistaConsola vista) {
this.modelo = modelo;
this.vista = vista;
}
void nuevaTarea(String texto) {
try {
modelo.anadir(texto);
vista.mostrar(modelo.todas());
} catch (IllegalArgumentException e) {
vista.error(e.getMessage());
}
}
void completar(int indice) {
modelo.completar(indice);
vista.mostrar(modelo.todas());
}
}
public class Main {
public static void main(String[] args) {
ControladorTareas controlador = new ControladorTareas(new ListaTareas(), new VistaConsola());
controlador.nuevaTarea("Estudiar Spring Boot");
controlador.nuevaTarea("Hacer el lab de JPA");
controlador.nuevaTarea(" ");
controlador.completar(0);
}
}
Salida:
Tareas (1):
0. Estudiar Spring Boot
Tareas (2):
0. Estudiar Spring Boot
1. Hacer el lab de JPA
Error: La tarea no puede estar vacía
Tareas (1):
0. Hacer el lab de JPA
La regla «una tarea no puede estar vacía» vive en el modelo. Si mañana la vista es una página web, la regla sigue funcionando sin cambios.
MVC en Spring
En Spring MVC el reparto es el mismo, con el framework haciendo parte del trabajo:
- El DispatcherServlet recibe todas las peticiones y las envía al controlador adecuado.
- El controlador (
@Controller) llama a los servicios y rellena unModelcon los datos. - La vista es una plantilla (por ejemplo, Thymeleaf) que pinta esos datos.
@Controller
class TareaController {
private final TareaService servicio;
TareaController(TareaService servicio) {
this.servicio = servicio;
}
@GetMapping("/tareas")
String listar(Model model) {
model.addAttribute("tareas", servicio.todas());
return "tareas"; // nombre de la plantilla templates/tareas.html
}
}
En una API REST (@RestController) no hay plantilla: la «vista» es el JSON que Spring genera a partir del objeto devuelto, normalmente un DTO. Lo vemos en crear una API REST con Spring Boot.
Errores frecuentes
- Controladores gordos: si el controlador contiene las reglas de negocio, no puedes reutilizarlas desde otra entrada (un job, una cola). Llévalas al modelo o a un servicio.
- Lógica en la plantilla: cálculos de precios o permisos dentro de Thymeleaf. La vista solo debería mostrar.
- Entidades JPA como modelo de la vista: acoplan la base de datos a la presentación y provocan cargas perezosas en la plantilla. Usa objetos pensados para mostrar.
Preguntas frecuentes
¿MVC y arquitectura en capas son lo mismo?
No. MVC organiza la capa de presentación. Una aplicación Spring típica combina MVC en la entrada con servicios y repositorios detrás, o con una arquitectura hexagonal.
¿Y MVVM o MVP?
Son variantes para interfaces con mucho estado en el cliente (aplicaciones móviles, escritorio, frontends con frameworks reactivos). En backend con Spring, MVC es el estándar.
¿Dónde va la validación?
Las validaciones de formato de la entrada (campo obligatorio, longitud) suelen ir en el DTO con Bean Validation; las reglas de negocio, en el modelo o el servicio.
Sigue aprendiendo
Controladores, vistas con Thymeleaf y APIs REST se construyen paso a paso en el curso de Spring Boot Web. Tienes más patrones en Observer y Composite.
Newsletter Semanal de Java
Cada viernes recibe lo más nuevo del ecosistema Java: frameworks, herramientas y mejores prácticas.
Sin spam. Cancela cuando quieras.