Hvad er GraphQL?

Kunne du tænke dig, at en API gav dig præcis det, du bad om? GraphQL er et forespørgselssprog til API'er, som lader klienter anmode om netop de data, de har brug for.

REST-slutpunkter returnerer en fast struktur, så du rammes af for meget data — du beder om en brugers navn, men downloader hele brugerens profil og spilder båndbredde.

Den modsatte udfordring er for lidt data: Ét slutpunkt er ikke nok, så du kæder kald sammen for brugere, derefter indlæg og derefter kommentarer — mange rundture, der gør dig langsommere.

GraphQL løser begge problemer: Klienter beder om præcis de felter, de har brug for, fra ét enkelt slutpunkt, så du får færre forespørgsler og mindre dataoverførsel.

Hjertet i enhver GraphQL-API er dens skema — kontrakten. Det definerer alle de typer, klienter kan forespørge om, og hvordan de hænger sammen, skrevet i SDL.

Typer defineres i SDL. Her har en User felterne id, name og email; ! markerer et felt som ikke-nullbart.

En forespørgsel er den måde, en klient anmoder om data på. Den afspejler den struktur, du ønsker, og henter kun de felter, du angiver — også fra indlejrede objekter.

Her er en enkel forespørgsel: Bed kun om id og name, så er det alt, serveren returnerer for brugeren med id 1. Intet ekstra.

Hvorfor vælge GraphQL? Effektiv datahentning, et stærkt typet skema, der forebygger fejl, problemfri udvikling af API'en og gode værktøjer som GraphiQL.

GraphQL er særligt velegnet til komplekse, indbyrdes forbundne data, flere klientplatforme på én API, gateways til mikrotjenester og hurtig videreudvikling af frontend.

Nu kender du grundprincipperne: GraphQL fjerner problemerne med for meget og for lidt data, skemaet er kontrakten, og forespørgsler anmoder om præcis det, du ønsker. Dernæst Spring Boot.