Cómo escribir una API REST en Java en 30 minutos: para principiantes

Cómo escribir una API REST en Java en 30 minutos: para principiantes

Crear una API REST es una de las habilidades clave del desarrollador moderno. Si recién está comenzando a aprender Java y quiere crear rápidamente su primer servicio web, esta guía es para usted. Recorreremos el camino desde la instalación de herramientas hasta una API funcional que se puede probar en el navegador o Postman. Todo el proceso tomará no más de 30 minutos.

En este artículo usaremos Spring Boot, el framework más popular para crear aplicaciones web en Java. Él se encarga de toda la configuración rutinaria, permitiéndole concentrarse en la lógica. Como resultado, obtendrá una API simple para gestionar una lista de tareas (Todo List).

¿Qué es una API REST y para qué sirve?

REST (Transferencia de Estado Representacional) es un estilo arquitectónico para construir servicios web. Una API REST funciona sobre el protocolo HTTP y utiliza métodos estándar:

• GET — obtener datos
• POST — crear un nuevo registro
• PUT — actualizar un registro existente
• DELETE — eliminar un registro

Los datos generalmente se transmiten en formato JSON. La API REST se usa en todas partes: desde aplicaciones móviles hasta arquitectura de microservicios. Al dominarla, podrá crear la parte del servidor para cualquier cliente.

Paso 1: Preparación del entorno

Para trabajar necesitaremos tres cosas. Asegúrese de que estén instaladas en su computadora.

1.1. JDK (Kit de Desarrollo de Java)

Descargue e instale JDK 17 o superior desde el sitio oficial de Oracle o use OpenJDK. Verifique la instalación con el comando en la terminal:

java -version

1.2. IntelliJ IDEA (Community Edition)

Este es un entorno de desarrollo gratuito, ideal para Java. Descárguelo desde el sitio oficial.

1.3. Postman (opcional)

Herramienta para probar APIs. Se puede descargar desde postman.com. Al principio, puede arreglárselas con el navegador.

Paso 2: Creación del proyecto Spring Boot

La forma más rápida es usar Spring Initializr. Es una herramienta web que genera un esqueleto de proyecto.

1. Vaya a start.spring.io.
2. Seleccione: Project: Maven, Language: Java, Spring Boot: 3.x.x.
3. En el campo Group ingrese com.example, en Artifact — todoapi.
4. Presione Add Dependencies y agregue Spring Web.
5. Presione Generate — se descargará un archivo ZIP con el proyecto.
6. Descomprima el archivo y abra la carpeta en IntelliJ IDEA.

La estructura del proyecto se verá así:

• src/main/java/com/example/todoapi/ — código principal
• src/main/resources/application.properties — configuración
• pom.xml — archivo de compilación de Maven

Paso 3: Creación del modelo de datos y el controlador

Ahora escribiremos el código. Primero crearemos un modelo simple: la clase TodoItem.

3.1. Clase del modelo

Cree una nueva clase Java en el paquete com.example.todoapi con el nombre TodoItem.java:

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // Constructor por defecto    public TodoItem() {}

    // Constructor con parámetros    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // Getters y Setters    public L