Tutorial SpringBoot: Crear proyecto desde Visual Studio Code

Instalar Spring Boot Extension Pack en VSCode

Visual Studio Code se ha convertido en uno de los editores más populares para el desarrollo de aplicaciones Spring Boot gracias a su ligereza y extensibilidad. Para trabajar eficientemente con Spring Boot en VSCode, se necesita instalar el paquete de extensiones adecuado que proporcione las herramientas necesarias para el desarrollo.

El Spring Boot Extension Pack es un conjunto de extensiones que facilita enormemente el desarrollo de aplicaciones Spring Boot desde VSCode. Este paquete incluye varias extensiones esenciales que trabajan en conjunto para proporcionar una experiencia de desarrollo completa.

Contenido del Spring Boot Extension Pack

El paquete de extensiones incluye:

• Spring Boot Tools: Proporciona soporte para edición de archivos de propiedades y YAML específicos de Spring Boot.
• Spring Initializr: Permite crear proyectos Spring Boot directamente desde VSCode.
• Spring Boot Dashboard: Ofrece una interfaz visual para gestionar aplicaciones Spring Boot.
• Java Extension Pack: Incluye herramientas esenciales para desarrollo Java.

Proceso de instalación

Para instalar el Spring Boot Extension Pack en Visual Studio Code, se siguen estos pasos:

1. Abrir Visual Studio Code en el equipo.

2. Acceder a la vista de extensiones. Esto se puede hacer de tres formas:

• Haciendo clic en el icono de extensiones en la barra lateral izquierda.
• Usando el atajo de teclado Ctrl+Shift+X (Windows/Linux) o Cmd+Shift+X (macOS).
• Desde el menú Ver, seleccionando la opción "Extensiones".

3. En el cuadro de búsqueda de la vista de extensiones, escribir "Spring Boot Extension Pack".

Spring Boot Extension Pack

4. Localizar la extensión publicada por VMware (anteriormente Pivotal), que es la oficial.

5. Hacer clic en el botón "Instalar" para iniciar la instalación.

6. Esperar a que se complete la instalación. VSCode mostrará una notificación cuando la extensión se haya instalado correctamente.

7. Se recomienda reiniciar VSCode después de la instalación para asegurar que todas las funcionalidades estén disponibles.

Verificación de la instalación

Para verificar que la instalación se ha realizado correctamente:

1. Abrir la paleta de comandos con Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (macOS).

2. Escribir "Spring" y comprobar que aparecen varios comandos relacionados con Spring Boot:

Spring Boot: Add Starters
Spring Boot: Generate a Maven Project
Spring Boot: Generate a Gradle Project
Spring Boot: Dashboard

Si estos comandos están disponibles, la extensión se ha instalado correctamente.

Configuración adicional

Después de instalar el Spring Boot Extension Pack, se pueden realizar algunas configuraciones adicionales para optimizar la experiencia de desarrollo:

• Configurar la JDK: Asegurarse de que VSCode está utilizando la JDK correcta. Esto se puede verificar y configurar desde la configuración de VSCode:

"java.home": "C:\\Program Files\\Java\\jdk-17",

• Configurar Maven: Si se utiliza Maven, se puede especificar la ubicación del ejecutable de Maven:

"maven.executable.path": "C:\\apache-maven-3.9.5\\bin\\mvn.cmd",

• Habilitar la compilación automática: Para una experiencia de desarrollo más fluida:

"java.autobuild.enabled": true,

Solución de problemas comunes

Si se encuentran problemas después de la instalación, se pueden intentar las siguientes soluciones:

• Extensiones no visibles: Reiniciar VSCode completamente.
• Errores de Java: Verificar que la JDK está correctamente instalada y configurada.
• Problemas de rendimiento: Ajustar la memoria asignada al servidor de lenguaje Java:

"java.memory.heap": "2048m",

• Conflictos con otras extensiones: Desactivar temporalmente otras extensiones relacionadas con Java para identificar posibles conflictos.

Con el Spring Boot Extension Pack instalado correctamente, VSCode se convierte en un entorno completo para el desarrollo de aplicaciones Spring Boot, ofreciendo funcionalidades como autocompletado inteligente, navegación de código, depuración integrada y gestión de proyectos.

En la siguiente sección, se verá cómo utilizar estas extensiones para crear un nuevo proyecto Spring Boot directamente desde Visual Studio Code, aprovechando todas las herramientas que se acaban de instalar.

Crear proyecto Spring Boot desde VSCode usando la extensión

Una vez instalado el Spring Boot Extension Pack en Visual Studio Code, se puede proceder a crear un nuevo proyecto Spring Boot directamente desde el editor. Esta funcionalidad elimina la necesidad de visitar el sitio web de Spring Initializr, permitiendo iniciar nuevos proyectos de manera rápida y eficiente sin salir del entorno de desarrollo.

Creación del proyecto

Para crear un nuevo proyecto Spring Boot desde VSCode, se siguen estos pasos:

1. Abrir la paleta de comandos presionando Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (macOS).

2. Escribir "Spring Initializr" y seleccionar la opción "Spring Initializr: Create a Maven Project" o "Spring Initializr: Create a Gradle Project" según el sistema de construcción que se prefiera utilizar.

3. Seleccionar la versión de Spring Boot que se desea utilizar. Se recomienda elegir la versión estable más reciente a menos que se necesite una versión específica por compatibilidad.

4. Elegir el lenguaje de programación. Las opciones disponibles son:

• Java
• Kotlin
• Groovy

5. Proporcionar los datos del grupo (Group ID) que generalmente corresponde al dominio de la organización en formato inverso, por ejemplo: com.miempresa.

6. Especificar el artefacto (Artifact ID) que será el nombre del proyecto y también el nombre del archivo JAR generado, por ejemplo: mi-aplicacion.

7. Seleccionar el tipo de empaquetado:

• JAR (recomendado para aplicaciones independientes)
• WAR (para despliegue en servidores de aplicaciones externos)

8. Elegir la versión de Java con la que se desarrollará el proyecto.

9. Seleccionar las dependencias necesarias para el proyecto. Algunas dependencias comunes son:

Spring Web
Spring Data JPA
Spring Security
Thymeleaf
H2 Database
MySQL Driver
PostgreSQL Driver
Lombok

10. Elegir la ubicación donde se guardará el proyecto en el sistema de archivos.

11. Una vez completados todos los pasos, VSCode generará el proyecto con la estructura básica y las dependencias seleccionadas.

Exploración del proyecto generado

Después de crear el proyecto, VSCode abrirá automáticamente la estructura de carpetas. El proyecto generado contiene:

• Archivo de configuración de construcción: pom.xml (Maven) o build.gradle (Gradle)
• Clase principal con anotación @SpringBootApplication
• Carpeta de recursos con archivos de configuración
• Carpeta de pruebas con una clase de prueba básica

Ejecutar el proyecto

Para ejecutar el proyecto recién creado:

1. Abrir el Spring Boot Dashboard desde la barra lateral de VSCode.

2. Localizar el proyecto en la lista de aplicaciones disponibles.

3. Hacer clic en el icono de reproducción (▶️) junto al nombre del proyecto para iniciarlo.

También se puede ejecutar el proyecto desde la paleta de comandos:

1. Abrir la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P).

2. Escribir "Spring Boot: Run" y seleccionar esta opción.

3. Elegir el proyecto que se desea ejecutar si hay varios disponibles.

Alternativamente, se puede ejecutar directamente desde el explorador de archivos:

1. Localizar la clase principal (la que contiene el método main).

2. Hacer clic derecho sobre ella y seleccionar "Run Java" o "Debug Java".

Verificación de la aplicación en ejecución

Una vez iniciada la aplicación:

1. Observar la consola de salida en VSCode para verificar que la aplicación se ha iniciado correctamente.

2. Por defecto, si se ha incluido la dependencia Spring Web, la aplicación estará disponible en http://localhost:8080.

3. Abrir un navegador y acceder a esta URL para comprobar que la aplicación responde.

Personalización del proyecto

Después de crear el proyecto básico, se pueden realizar algunas personalizaciones comunes:

• Configurar propiedades: Editar el archivo application.properties o application.yml en la carpeta src/main/resources para ajustar configuraciones como el puerto del servidor, conexiones a bases de datos, etc.

# Ejemplo de configuración en application.properties
server.port=9090
spring.application.name=mi-aplicacion

• Crear paquetes adicionales: Es recomendable organizar el código en paquetes según la funcionalidad:

com.miempresa.miaplicacion
├── controller
├── service
├── repository
├── model
└── config

• Añadir dependencias adicionales: Si se necesitan más dependencias después de la creación inicial, se pueden añadir mediante el comando "Spring Boot: Add Starters" desde la paleta de comandos.

Depuración del proyecto

Para depurar la aplicación Spring Boot:

1. Establecer puntos de interrupción haciendo clic en el margen izquierdo del editor junto a los números de línea.

2. Iniciar la aplicación en modo de depuración:

• Desde el Spring Boot Dashboard, hacer clic en el icono de depuración (🐞)
• O desde la clase principal, seleccionar "Debug Java"

3. La ejecución se detendrá en los puntos de interrupción, permitiendo inspeccionar variables y el estado de la aplicación.

Gestión de perfiles

Spring Boot permite trabajar con diferentes perfiles de configuración. Para configurarlos desde VSCode:

1. Crear archivos de propiedades específicos para cada perfil:

• application-dev.properties
• application-prod.properties

2. Para ejecutar la aplicación con un perfil específico, modificar la configuración de ejecución:

• Abrir el archivo .vscode/launch.json
• Añadir el argumento -Dspring.profiles.active=dev a la configuración

{
  "configurations": [
    {
      "type": "java",
      "name": "Spring Boot App",
      "request": "launch",
      "mainClass": "com.miempresa.miaplicacion.MiAplicacionApplication",
      "args": "--spring.profiles.active=dev"
    }
  ]
}

Integración con control de versiones

Para integrar el proyecto con un sistema de control de versiones como Git:

1. Inicializar un repositorio Git:

• Abrir la terminal integrada de VSCode (Ctrl+ o `Cmd+``)
• Ejecutar git init

2. Crear un archivo .gitignore adecuado para proyectos Spring Boot (VSCode puede sugerirlo automáticamente).

3. Realizar el primer commit:

• git add .
• git commit -m "Proyecto inicial Spring Boot"

Solución de problemas comunes

Si se encuentran problemas durante la creación o ejecución del proyecto:

• Error de conexión al crear el proyecto: Verificar la conexión a internet y los ajustes del proxy si es necesario.

• Errores de compilación: Comprobar que la versión de Java configurada en VSCode coincide con la especificada en el proyecto.

• La aplicación no inicia: Revisar los logs en la consola para identificar errores específicos.

• Dependencias no resueltas: Ejecutar "Maven: Update Project" o "Gradle: Refresh Dependencies" desde la paleta de comandos.

Con estos pasos, se puede crear y configurar rápidamente un proyecto Spring Boot desde Visual Studio Code, aprovechando todas las ventajas que ofrece el Spring Boot Extension Pack para proporcionar una experiencia de desarrollo integrada y productiva.