Tutorial SpringBoot: Introducción a Spring Boot

Spring Boot es un framework que facilita el desarrollo de aplicaciones Java, automatizando la configuración y reduciendo el tiempo de desarrollo. Provee una forma rápida de construir aplicaciones sin necesidad de una configuración extensa, aprovechando la autoconfiguración y las convenciones sobre la configuración para gestionar las dependencias y la configuración del entorno.

Para comenzar a trabajar con Spring Boot, es importante configurar un entorno de desarrollo adecuado.

Instalación de IntelliJ IDEA Community Edition

Visitar el sitio web oficial de IntelliJ IDEA para descargarlo: https://www.jetbrains.com/idea/download/

Elegir la versión Community Edition, que es gratuita, y hacer clic en el enlace de descarga adecuado para el sistema operativo.

Una vez completada la descarga, abrir el archivo descargado para iniciar el proceso de instalación.

Seguir las instrucciones en pantalla, aceptando los términos de la licencia y seleccionando las opciones de instalación deseada.

Con IntelliJ IDEA Community Edition instalado, se está listo para empezar a desarrollar aplicaciones con Spring Boot, aprovechando las herramientas y características que este IDE ofrece para facilitar el desarrollo de software.

Creación de un proyecto Spring Boot

Para crear un nuevo proyecto Spring Boot, se recomienda utilizar la herramienta online start.spring.io, que simplifica la configuración inicial del proyecto.

Acceder a https://start.spring.io en el navegador web.

Configurar las opciones del proyecto:

• Project: Seleccionar Maven Project.
• Language: Elegir Java.
• Spring Boot: Escoger la versión de Spring Boot deseada.
• Project Metadata: Rellenar los campos con información específica del proyecto:
  • Group: Define el identificador del grupo del proyecto, usualmente utilizado para especificar la organización o equipo desarrollador, siguiendo la convención de nombrado inverso de dominios de internet, por ejemplo, com.empresa.
  • Artifact: Es el nombre del artefacto del proyecto, que suele ser el nombre del proyecto o módulo, utilizado como el identificador del proyecto, por ejemplo, aplicacion-web.
  • Name: Representa el nombre descriptivo del proyecto, que puede contener espacios y ser más legible, como Aplicación Web.
  • Description: Ofrece una breve descripción del proyecto, indicando su propósito o función principal, por ejemplo, Proyecto para gestión de inventarios.
  • Package name: Define la estructura de paquete base para el código fuente, siguiendo las convenciones de nomenclatura de paquetes de Java, como com.empresa.inventario.
• Packaging: Elegir entre Jar o War, según la preferencia.
• Java Version: Seleccionar la versión de Java que se va a utilizar.

Añadir las dependencias necesarias para el proyecto. Para una aplicación web básica, se puede buscar y añadir Spring Web.

Hacer clic en el botón Generate para descargar el proyecto como un archivo .zip.

Descomprimir el archivo .zip descargado en el directorio deseado.

Con estos pasos, se ha creado un proyecto Spring Boot básico, listo para ser importado en IntelliJ IDEA Community Edition para su desarrollo y ejecución.

Importar y ejecutar en IntelliJ IDEA

Una vez creado el proyecto Spring Boot usando start.spring.io y descomprimido en tu sistema, el siguiente paso es importarlo a IntelliJ IDEA para comenzar con el desarrollo y la ejecución. A continuación, se describe el proceso paso a paso.

Importar el proyecto

1. Abrir IntelliJ IDEA y seleccionar la opción Open o Import Project en la pantalla de inicio.
2. Navegar en el sistema de archivos y seleccionar la carpeta del proyecto Spring Boot descomprimido.
3. IntelliJ IDEA detectará automáticamente que se trata de un proyecto Maven y sugerirá configuraciones adecuadas. Aceptar la configuración por defecto y esperar a que el IDE configure el proyecto.

Ejecutar la aplicación

1. Una vez importado el proyecto, IntelliJ IDEA resolverá las dependencias y preparará el entorno de desarrollo.
2. Localizar la clase principal de la aplicación Spring Boot, que tiene la anotación @SpringBootApplication. Esta clase se encuentra generalmente en el directorio src/main/java bajo el paquete base que se especificó durante la creación del proyecto.
3. Hacer clic derecho sobre la clase principal y seleccionar Run 'nombreDeClase.main()' para iniciar la aplicación.
4. IntelliJ IDEA compilará y ejecutará la aplicación Spring Boot. Observar la salida en la consola del IDE para verificar que la aplicación se ha iniciado correctamente.

Acceder a la aplicación

• Con la aplicación en ejecución, abrir un navegador web y navegar a http://localhost:8080 seguido del endpoint específico que se desea acceder, por ejemplo, /saludo si se ha creado un controlador como en el ejemplo de código proporcionado anteriormente.
• Se debería ver la respuesta del controlador, indicando que la aplicación Spring Boot está funcionando correctamente.

Este proceso muestra cómo importar y ejecutar un proyecto Spring Boot en IntelliJ IDEA Community Edition, facilitando el desarrollo, prueba y depuración de la aplicación en un entorno integrado.

Estructura básica de un proyecto Spring Boot

Un proyecto Spring Boot típico tiene una estructura de directorios y archivos bien definida, que facilita el desarrollo y la organización del código. A continuación, se describen los componentes principales de esta estructura:

src/main/java/: Este directorio contiene el código fuente de la aplicación, incluyendo la clase principal de Spring Boot que inicia la aplicación y los controladores, servicios, y repositorios.

Clase principal de la aplicación (@SpringBootApplication): Es el punto de entrada de la aplicación Spring Boot. Esta clase incluye la anotación @SpringBootApplication, que habilita la autoconfiguración y el escaneo de componentes en el paquete donde se encuentra.

src/main/resources/: Aquí se almacenan los recursos de la aplicación, como archivos de propiedades de configuración (application.properties o application.yml), así como otros recursos como plantillas y archivos estáticos.

pom.xml (para Maven): Este archivo define las dependencias del proyecto y la configuración específica de la construcción. A través de él, Maven gestiona las bibliotecas necesarias y otras tareas de construcción.

Controladores (@RestController): Los controladores manejan las solicitudes entrantes y devuelven respuestas a los clientes. Están anotados con @RestController y mapean las rutas de acceso a los métodos correspondientes.

application.properties o application.yml: Estos archivos de configuración se utilizan para personalizar la configuración de la aplicación, como la configuración del servidor, parámetros de base de datos, y más.

Conclusión

En esta lección se ha proporcionado una introducción a Spring Boot, destacando su capacidad para simplificar el desarrollo de aplicaciones Java mediante la automatización de la configuración y la gestión de dependencias. Se ha aprendido cómo configurar un entorno de desarrollo con IntelliJ IDEA Community Edition, cómo crear un proyecto Spring Boot utilizando start.spring.io, importar y ejecutar este proyecto en IntelliJ, y comprender la estructura básica y componentes principales de un proyecto Spring Boot.