Artículo

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

ParteHaceNo hace
ModeloGuarda datos y aplica reglas (una tarea no puede estar vacía)Imprimir, leer peticiones
VistaMuestra lo que recibeDecidir reglas de negocio
ControladorTraduce la acción del usuario, llama al modelo, elige la vistaGuardar 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 un Model con 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.

mvc modelo vista controlador patrones de diseño java spring mvc

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.

Compartir artículo