API GraphQL con Java: tutorial paso a paso para principiantes

Introducción: Por qué GraphQL y Java son una combinación poderosa

El desarrollo moderno de API requiere flexibilidad y eficiencia. REST API, a pesar de su popularidad, a menudo se enfrenta al problema de over-fetching (carga excesiva de datos) o under-fetching (falta de datos). GraphQL resuelve estos problemas permitiendo al cliente solicitar solo los datos que necesita.

Java, por su parte, sigue siendo uno de los lenguajes más confiables para el desarrollo empresarial. La combinación de GraphQL y Java a través del framework Spring Boot proporciona una herramienta poderosa para crear API escalables y de alto rendimiento. En este tutorial paso a paso, crearemos una API GraphQL simple desde cero.

Este material será útil para desarrolladores Java que quieran dominar un enfoque moderno para la construcción de API. Analizaremos conceptos clave, escribiremos código y probaremos nuestra implementación.

1. Configuración del proyecto y dependencias

El primer paso es crear un proyecto base de Spring Boot. Usaremos Maven para la gestión de dependencias. Asegúrate de tener instalados JDK 17+ y Maven 3.8+.

Crea el archivo pom.xml con el siguiente contenido:

<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0         http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>

    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>3.2.0</version>    </parent>

    <groupId>com.example</groupId>    <artifactId>graphql-java-tutorial</artifactId>    <version>1.0.0</version>

    <properties>        <java.version>17</java.version>    </properties>

    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>        <dependency>            <groupId>com.graphql-java</groupId>            <artifactId>graphql-spring-boot-starter</artifactId>            <version>5.0.2</version>        </dependency>        <dependency>            <groupId>com.graphql-java</groupId>            <artifactId>graphql-java-tools</artifactId>            <version>5.2.4</version>        </dependency>    </dependencies></project>

Después de configurar el pom.xml, crea la clase principal de la aplicación:

package com.example.graphqldemo;

import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplicationpublic class GraphqlDemoApplication {    public static void main(String[] args) {        SpringApplication.run(GraphqlDemoApplication.class, args);    }}

Ahora la estructura del proyecto está lista. Pasamos a la definición de los datos.

2. Definición del modelo de datos y GraphQL Schema

GraphQL Schema es el contrato entre el cliente y el servidor. Comenzaremos creando un modelo simple de Book (libro).

2.1 Clase del modelo Java

package com.example.graphqldemo.model;

public class Book {    private String id;    private String title;    private String author;    private int pages;

    public Book(String id, String title, String author, int pages) {        this.id = id;        this.title = title;        this.author = author;        this.pages = pages;    }

    // Getters y Setters    public String getId