Estructura de paquetes en Spring Boot por capas

Contenido del curso

Introducción a Spring Boot

Persistencia con Spring Data y modelado de datos

Buenas prácticas en diseño de APIs

Calidad documentación y producción

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:004:35

Estructura de paquetes en Spring Boot por capas

Curso de Java Spring Boot

Clase 5 de 23

Clase 5 / 23

Recursos

Organizar un proyecto Spring Boot por capas orientadas al dominio te ayuda a separar responsabilidades, mantener el código legible y escalar tu API sin dolores de cabeza. Esta guía muestra cómo estructurar paquetes de dominio, web y persistence para que tu aplicación crezca con orden desde el primer día.

Por qué usar una arquitectura por capas orientada al dominio

La idea central es que el core de tu aplicación viva en el dominio, y el resto de capas giren alrededor de él. Así, cuando un módulo cambie, no arrastras toda la aplicación contigo.

Esta separación te da tres beneficios concretos:

Responsabilidades claras entre lo que es lógica de negocio, lo que expone endpoints y lo que habla con la base de datos.
Código más legible porque cada paquete tiene un propósito único.
Escalabilidad real cuando la aplicación crece y necesitas agregar nuevas funcionalidades sin romper lo existente.

¿Qué es una arquitectura orientada al dominio? Es un enfoque donde el dominio (la lógica de negocio) ocupa el centro de la aplicación, y las capas externas como web o persistencia dependen de él, no al revés.

Cómo crear los paquetes base de dominio, web y persistence

Dentro de com.platzi.play necesitas tres paquetes hermanos que reflejan las capas de tu aplicación. Cada uno cumple una misión distinta y debe mantenerse aislado del resto.

Qué va en el paquete domain

El paquete domain aloja el core de la aplicación. Aquí viven las reglas de negocio y los servicios que orquestan esa lógica.

Dentro de domain se crea un subpaquete domain.service donde se mueve la interfaz PlatziPlayAIService. Al arrastrar la clase, IntelliJ actualiza automáticamente los nombres de paquetes y los imports, así que la aplicación sigue funcionando sin tocar código a mano [1:30].

Qué va en el paquete web

El paquete web agrupa todo lo que expone la aplicación al exterior. Como puede contener varias responsabilidades, se crea un subpaquete web.controller para los controladores.

La clase HelloController se mueve a com.platzi.play.web.controller. En el mismo paso, se ajusta el mapping para que el saludo responda en /hello en lugar de la raíz / [1:50].

Qué va en el paquete persistence

El paquete persistence se reserva para toda la comunicación con la base de datos. Por ahora queda vacío, pero es el lugar donde se conectará Postgres en la siguiente clase.

¿Para qué sirve separar persistence del dominio? Para que el dominio no dependa de cómo se guardan los datos. Puedes cambiar de base de datos sin tocar la lógica de negocio.

Dónde dejar la clase principal de Spring Boot

La clase PlatziPlay, encargada de arrancar la aplicación, se queda en la raíz del paquete com.platzi.play. No pertenece a ninguna capa específica porque su rol es ejecutar el proyecto completo.

Al relanzar la aplicación después de reorganizar, la URL raíz deja de responder y el saludo aparece en /hello. Esa pequeña validación confirma que la nueva estructura funciona y que los controladores siguen activos [2:40].

Existe una arquitectura perfecta para todos los proyectos

No. Ninguna arquitectura es la bala de plata que resuelve todos los casos. El contexto del producto, las necesidades del equipo y la infraestructura definen qué patrón conviene en cada momento.

Algunos factores que cambian la decisión:

El tamaño del equipo y su experiencia.
La complejidad del dominio de negocio.
Los requisitos de escalabilidad y despliegue.

Por eso conviene profundizar en fundamentos de arquitectura antes de casarte con un único enfoque. La estructura por capas orientada al dominio es un excelente punto de partida para APIs con Spring Boot, pero no es la única opción válida.

Qué sigue después de estructurar el proyecto

Con la base lista, el siguiente paso es conectar la aplicación a una base de datos real. Vas a usar Docker para levantar una instancia de Postgres y enlazarla con el paquete persistence que dejaste preparado.

¿Tu proyecto actual sigue una arquitectura por capas o usas otro enfoque? Cuéntame en los comentarios cómo organizas tus paquetes en Spring Boot.

Introducción a Spring Boot

¿Qué es Spring y por qué es tan popular?

Configuración inicial de proyecto Spring Boot con Java 21

Crear un endpoint REST con Spring Boot e integrarlo con IA usando LangChain4j

Configuración de application.properties y perfiles en Spring Boot

Estructura de paquetes en Spring Boot por capas

Persistencia con Spring Data y modelado de datos

Conectar Spring Boot a PostgreSQL con Docker

Crear entidad con anotaciones JPA para tabla de base de datos

Repositorios CRUD con Spring Data sin escribir SQL

Primer endpoint GET con Spring Boot

Buenas prácticas en diseño de APIs

Inyección de dependencias con Spring IoC

Separación de dominio y persistencia con DTOs en Java

Configuración de MapStruct con Spring para convertir entidades a DTO

Creación de conversores personalizados en MapStruct para enums y strings

Captura de parámetros con @PathVariable en Spring Boot

Códigos HTTP y Response Entity en APIs REST

Calidad documentación y producción

Crear endpoint POST en Spring Boot

Endpoint PUT con MapStruct en Spring Boot

Sistema de recomendaciones con LangChain4j y Spring

Manejo de errores con @RestControllerAdvice

Validación automática de datos en APIs con Spring Boot

Documenta tu API REST con OpenAPI

Compilación de aplicación Java para producción con PostgreSQL

Desplegar tu API Spring Boot en Render

Estructura de paquetes en Spring Boot por capas

Progreso del curso

Introducción a Spring Boot

Persistencia con Spring Data y modelado de datos

Buenas prácticas en diseño de APIs

Calidad documentación y producción

Recursos

Recursos