REST vs GraphQL: En jämförelse av förändringspåverkan och kodkomplexitet

Sammanfattning

När system förändras över tid behöver även API:er anpassas för att hantera förändringen. Eftersom REST och GraphQL bygger på olika principer för förfrågningar och datastruktur kan valet mellan teknikerna påverka hur sådana förändringar får genomslag i kodbasen. Denna studie undersöker hur REST och GraphQL skiljer sig åt när sådana förändringar hanteras i kodbasen. Genom en implementeringsbaserad jämförelse utvecklas två API:er med likvärdig funktionalitet i samma tekniska miljö och mot samma databas. Genom att båda API:erna utsätts för samma förändringar i datamodell och funktionella krav analyseras antal ändrade, tillagda och borttagna artefakter samt förändringens spridning i kodbasen. Kodkomplexitet analyseras genom Lines of Code och cyklomatisk komplexitet för att identifiera skillnader mellan teknologierna samt undersöka hur förändring påverkar komplexiteten. Antal API-anrop används som ett kompletterande mått i studien för att synliggöra skillnader i hur funktionalitet exponeras för klienter.Resultatet visar att GraphQL i studiens kontext har en mer centraliserad förändringspåverkan, där förändringar främst hanteras genom schema och tillhörande resolvers. REST:s distribuerade struktur kräver i större utsträckning förändringar i separata endpoints och tillhörande funktioner. Denna struktur leder till en större förändringsyta, där förändringar sprids över fler delar av kodbasen. Studiens resultat visar även att REST generellt har högre kodmängd och cyklomatisk komplexitet, samtidigt som GraphQL möjliggör färre API-anrop vid hämtning av data från relaterade tabeller i databasen. Slutsatsen är att GraphQL kan vara fördelaktigt i system där datamodellen ofta förändras och där data hämtas från flera relaterade resurser. Samtidigt bör resultatet tolkas utifrån den begränsade prototypmiljö som studien baseras på. Det innebär att valet mellan REST och GraphQL bör baseras på de krav som ställs på förändring, struktur och datahämtning.