GraphQL: Abfragesprache für APIs

GraphQL: Fordern Sie genau das, was Sie brauchen

Haben Sie jemals eine API verwendet, die zu viele oder zu wenige Daten zurückgegeben hat? Das ist das Problem, das GraphQL lösen soll. Anstatt dass der Server entscheidet, welche Daten gesendet werden, fordert der Client genau das an, was er benötigt, und erhält nur das zurück. Es ist wie das Bestellen von einer Speisekarte anstatt ein festes Menü zu bekommen.

Wie GraphQL funktioniert

Im Zentrum von GraphQL steht ein Schema – eine Beschreibung aller verfügbaren Daten und wie sie miteinander verbunden sind. Das Schema ist stark typisiert, was bedeutet, dass jedes Datum einen bestimmten Typ hat: String, Zahl, Boolean oder komplexere Typen wie Objekte und Listen. Dieses Schema fungiert als Vertrag zwischen Client und Server.

Clients senden Abfragen, die genau beschreiben, was sie wollen. Zum Beispiel könnte eine Abfrage nach dem Namen und der E-Mail eines Benutzers sowie nach den aktuellsten Bestellungen des Benutzers fragen. Der Server antwortet mit einem JSON-Objekt, das der Form der Abfrage entspricht – keine zusätzlichen Daten, keine fehlenden Felder. Dies eliminiert sowohl Überabruf (Daten erhalten, die Sie nicht benötigen) als auch Unterabruf (mehrere Anfragen stellen müssen, um alle benötigten Daten zu erhalten).

Abfragen, Mutationen und Abonnements

GraphQL hat drei Arten von Operationen. Abfragen dienen zum Lesen von Daten – sie entsprechen GET-Anfragen. Mutationen dienen zum Schreiben von Daten – Erstellen, Aktualisieren oder Löschen von Ressourcen. Abonnements dienen für Echtzeit-Updates – der Server sendet Daten an den Client, sobald sich etwas ändert, wie neue Benachrichtigungen oder Live-Chat-Nachrichten.

Resolver: Wie Daten abgerufen werden

Auf der Serverseite hat jedes Feld im Schema eine Resolver-Funktion, die weiß, wie diese Daten abgerufen werden. Resolver können Datenbanken, externe APIs aufrufen oder Werte spontan berechnen. Sie erhalten das übergeordnete Objekt, Argumente, einen Kontext (der typischerweise Authentifizierung und Datenbankverbindungen enthält) und Informationen über die Abfrage. GraphQL ruft Resolver selektiv auf – es führt nur die Resolver für Felder aus, die tatsächlich angefordert wurden.

Eine häufige Herausforderung ist das N+1-Problem, bei dem das Abrufen einer Liste von Elementen und das anschließende Abrufen eines zugehörigen Felds für jedes Element zu vielen Datenbankabfragen führt. Die Lösung ist DataLoader, der Anfragen bündelt und zwischenspeichert, sodass mehrere Resolver, die dieselben Daten benötigen, eine einzige Datenbankabfrage gemeinsam nutzen können.

Föderation: Kombinieren mehrerer Dienste

Für große Organisationen kann ein einzelnes GraphQL-Schema unhandlich werden. Die Föderation ermöglicht es Ihnen, das Schema auf mehrere Dienste aufzuteilen, die jeweils für ihre eigene Domäne verantwortlich sind. Ein Gateway kombiniert sie zu einem einzigen vereinheitlichten Graphen, mit dem Clients interagieren. Dies ermöglicht es unabhängigen Teams, ihren Teil der API zu besitzen und gleichzeitig eine kohärente Erfahrung für die Nutzer zu bieten.

GraphQL vs REST: Wann man was verwendet

GraphQL glänzt, wenn Sie komplexe Datenbeziehungen, mehrere Clients mit unterschiedlichen Anforderungen haben und schnell iterieren möchten, ohne Versionierung. REST ist einfacher und ausgereifter, mit nativem Caching, breiterer Tool-Unterstützung und einer leichteren Lernkurve. Für viele Projekte ist der beste Ansatz, mit REST zu beginnen und zu GraphQL zu wechseln, wenn die Komplexität dies rechtfertigt.

GraphQL ist kein Ersatz für REST – es ist ein anderes Werkzeug für andere Probleme. Wenn Sie beide verstehen, können Sie das richtige für jede Situation auswählen.