Entorno de desarrollo

El objetivo de este apartado es que tengas un entorno completo y reproducible. «Reproducible» significa que otra persona —o tú mismo dentro de seis meses, o el profesorado al corregir— pueda clonar tu repositorio y hacerlo funcionar sin adivinar nada.

La pila del módulo​

Todo el software es libre o dispone de licencia educativa gratuita.

JDK 25​

Por qué exactamente la 25​

Java 25 es una versión LTS (Long Term Support): recibe soporte durante años, que es lo que una empresa exige de la plataforma sobre la que despliega. Spring Boot 3.x requiere como mínimo Java 17; usamos la 25 porque es la LTS vigente y porque incorpora características que aprovecharemos —records, sealed, pattern matching en switch, bloques de texto.

Instalación​

Windows (recomendado con winget):

winget install EclipseAdoptium.Temurin.25.JDK

Linux (Debian/Ubuntu):

sudo apt update
sudo apt install temurin-25-jdk

macOS (con Homebrew):

brew install --cask temurin@25

Alternativa multiplataforma y muy cómoda si necesitas varias versiones a la vez: SDKMAN! en Linux/macOS.

sdk install java 25-tem
sdk default java 25-tem

Verificación​

java -version
javac -version
echo $JAVA_HOME     # Windows PowerShell: echo $env:JAVA_HOME

Debe responder algo como:

openjdk version "25" 2025-09-16 LTS

export JAVA_HOME=/usr/lib/jvm/temurin-25-jdk-amd64
export PATH="$JAVA_HOME/bin:$PATH"

Maven​

Maven es la herramienta de construcción y de gestión de dependencias. Se encarga de descargar las librerías, compilar, ejecutar las pruebas y empaquetar.

Instalación​

# Windows
choco install Apache.Maven

# Debian/Ubuntu
sudo apt install maven

# macOS
brew install maven

Verificación​

mvn -version

Debe mostrar Maven 3.9 o superior y confirmar que usa el JDK 25:

Apache Maven 3.9.9
Java version: 25, vendor: Eclipse Adoptium

El repositorio local​

Maven guarda las dependencias descargadas en ~/.m2/repository. La primera construcción del proyecto descargará bastante (Spring Boot arrastra muchos artefactos) y tardará varios minutos. Las siguientes son casi instantáneas.

# Comandos que usarás constantemente
./mvnw clean            # borra target/
./mvnw compile          # compila
./mvnw test             # ejecuta las pruebas
./mvnw package          # genera el JAR en target/
./mvnw spring-boot:run  # arranca la aplicación
./mvnw dependency:tree  # muestra el árbol de dependencias

IDE​

Vale cualquiera de los dos. La diferencia práctica en este módulo es pequeña; IntelliJ tiene mejor soporte de Spring de fábrica, VS Code es más ligero.

IntelliJ IDEA​

La edición Community basta para todo el módulo. La Ultimate es gratuita para estudiantes con la licencia educativa y añade soporte específico de Spring, cliente de base de datos integrado y perfilado HTTP.

Complementos útiles: Spring Boot Assistant, SonarLint, Rainbow Brackets.

VS Code​

Instala el paquete de extensiones:

• Extension Pack for Java (Microsoft)
• Spring Boot Extension Pack (VMware)
• Docker (Microsoft)

Configuración común mínima​

Sea cual sea el IDE, configura desde el primer día:

1. Codificación UTF-8 en todo el proyecto. Vas a leer ficheros CSV y XML con tildes y con eñes; una codificación mal puesta genera errores que parecen de lógica y no lo son.
2. Finales de línea LF. Si trabajas en Windows y el corrector en Linux, los CRLF ensucian los diffs de Git. Ver el apartado de Git.
3. Formateo automático al guardar, con el estilo por defecto del IDE. El objetivo no es el estilo concreto, es que no aparezcan cambios de formato mezclados con cambios de lógica en los commits.
4. Nivel de lenguaje 25 en la configuración del proyecto.

Git​

# Windows
winget install Git.Git

# Debian/Ubuntu
sudo apt install git

# macOS
brew install git

Configuración inicial obligatoria — con tu nombre real y el correo de la cuenta que uses en GitHub/GitLab, porque es lo que aparecerá en el historial que se evalúa:

git config --global user.name "Nombre Apellidos"
git config --global user.email "correo@ejemplo.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input   # en Windows: true

El flujo de trabajo completo se trata en el apartado h.

Clientes de base de datos​

No son imprescindibles para que el código funcione, pero sí para entender qué está pasando. Los necesitarás a partir de la UD3.

• DBeaver Community — cliente universal: sirve para H2, MariaDB y PostgreSQL. Un único programa para las tres bases relacionales del curso.
• MongoDB Compass — cliente gráfico oficial de MongoDB, necesario a partir de la UD6.

Checklist de arranque​

Esta es la comprobación de la actividad A0.1. Ejecuta todo y guarda la salida.

java -version          # ⇒ 25.x
javac -version         # ⇒ 25.x
mvn -version           # ⇒ 3.9+, con Java 25
git --version          # ⇒ 2.40+
docker --version       # ⇒ instalado
docker compose version # ⇒ v2.x
docker run --rm hello-world   # ⇒ el demonio responde

Problemas frecuentes​

sudo usermod -aG docker $USER