GraphQL Java — biblioteca del lado del servidor para implementar API GraphQL en Java

GraphQL Java — biblioteca del lado del servidor para implementar API GraphQL en Java

GraphQL Java es una potente y flexible biblioteca del lado del servidor para implementar la especificación GraphQL en el lenguaje Java. Permite a los desarrolladores crear API eficientes, con seguridad de tipos y fácilmente extensibles, brindando a los clientes la posibilidad de solicitar solo los datos necesarios. La biblioteca cuenta con el apoyo activo de la comunidad y se utiliza en entornos de producción por muchas grandes empresas.

Características principales

• Soporte completo de la especificación GraphQL — implementación de todos los tipos, directivas, mutaciones, suscripciones y fragmentos.
• Sistema de tipos flexible — posibilidad de definir esquemas tanto basados en clases Java (code-first) como a través de SDL (schema-first).
• Soporte integrado de asincronía — uso de CompletableFuture para el procesamiento eficiente de solicitudes.
• DataLoader — utilidad integrada para resolver el problema de consultas N+1 y la carga por lotes de datos.
• Herramientas de prueba — clases integradas para pruebas unitarias de esquemas y resolvers.
• Extensibilidad — soporte para escalares personalizados, directivas y herramientas de validación.

Arquitectura de la biblioteca

La biblioteca consta de varios componentes clave:

• GraphQLSchema — objeto que representa el esquema de la API.
• DataFetcher — interfaz funcional para obtener datos (análogo al resolver en GraphQL).
• TypeResolver — interfaz para resolver tipos polimórficos (interfaces y uniones).
• ExecutionStrategy — estrategia de ejecución de consultas (por defecto asíncrona).
• Instrumentation — mecanismo para inyectar lógica adicional (registro, métricas).

Ejemplo de uso

Consideremos un ejemplo simple de creación de un servidor GraphQL para gestionar libros.

1. Definición del esquema mediante SDL

// schema.graphqlstype Query {    books: [Book]    bookById(id: ID!): Book}

type Book {    id: ID!    title: String!    author: String!    year: Int}

2. Creación de resolvers

import graphql.schema.DataFetcher;import graphql.schema.DataFetchingEnvironment;

public class BookDataFetcher {

    public static DataFetcher<List<Book>> getBooksDataFetcher() {        return environment -> {            // En una aplicación real aquí habría una consulta a la base de datos            return List.of(                new Book("1", "1984", "George Orwell", 1949),                new Book("2", "Brave New World", "Aldous Huxley", 1932)            );        };    }

    public static DataFetcher<Book> getBookByIdDataFetcher() {        return environment -> {            String id = environment.getArgument("id");            // Búsqueda de libro por ID            return findBookById(id);        };    }}

3. Ensamblaje del esquema y ejecución de la consulta

import graphql.GraphQL;import graphql.schema.GraphQLSchema;import graphql.schema.idl.RuntimeWiring;import graphql.schema.idl.SchemaParser;import graphql.schema.idl.SchemaGenerator;import graphql.schema.idl.TypeDefinitionRegistry;

public class GraphQLExample {    public static void main(String[] args) {        // Carga de SDL        String schema = "type Query { books: [Book] } type Book { id: ID! title: String! }";        SchemaParser schemaParser = new SchemaParser();        TypeDefinitionRegistry typeRegistry = schemaParser.parse(schema);

        // Configuración de runtime wiring        RuntimeWiring wiring = RuntimeWiring.newRuntimeWiring()            .type("Query", builder -> builder                .dataFetcher("books", BookDataFetcher.getBooksDataFetche