Erstellen eines GraphQL-Servers in Mockingbird

Einführung

Willkommen! Diese Anleitung führt Sie durch die Schritte zum Erstellen eines GraphQL-Servers mit Mockingbird. Unabhängig davon, ob Sie Entwickler oder Tester sind, hilft Ihnen dieser Leitfaden dabei, einen simulierten GraphQL-Server einzurichten, Abfragen und Mutationen zu erstellen und alles zu testen. Am Ende verfügen Sie über einen robusten Mock-Server, der Ihren Entwicklungsprozess reibungsloser und schneller macht.

In früheren Leitfäden haben wir Themen wie Einrichten Ihres Mock-Servers mit Mockingbird, Mockingbird-Voreinstellungen: API-Entwicklungsworkflows optimieren und Erstellen und Verwalten mehrerer Projekte und Server mit Mockingbird behandelt. Diese Leitfäden bildeten eine solide Grundlage für die Verwendung von Mockingbird in verschiedenen Szenarien. Aufbauend auf diesem Wissen konzentriert sich dieser Leitfaden speziell auf die Nutzung von Mockingbird zum Verspotten von GraphQL-Servern. Wenn Sie unsere vorherigen Leitfäden hilfreich fanden, werden Sie diese ebenso wertvoll finden, da sie sich mit den Besonderheiten der Handhabung von GraphQL mit Mockingbird befasst.

Lassen Sie uns eintauchen und sehen, wie Mockingbird die Einrichtung und das Testen Ihres GraphQL-Servers vereinfachen kann.

Schritt 1: Laden Sie Mockingbird herunter und installieren Sie es

1. Gehen Sie zur Mockingbird GitHub-Veröffentlichungsseite.
2. Laden Sie die neueste Version herunter.
3. Sobald der Download abgeschlossen ist, öffnen Sie Mockingbird.

Schritt 2: Erstellen Sie ein neues Projekt oder klonen Sie ein vorhandenes

1. Wenn Sie Mockingbird öffnen, wird ein Bildschirm „Projekt erstellen“ mit drei Optionen angezeigt:
   • Neues Projekt erstellen: Starten Sie ein neues Projekt von Grund auf, indem Sie einen Projektnamen eingeben.
   • Vorhandenes Projekt klonen: Klonen Sie ein Projekt, indem Sie die Repository-URL und alle erforderlichen Authentifizierungsdetails eingeben.
   • Vorhandenes Projekt öffnen: Öffnen Sie ein Projekt, das bereits auf Ihrem Computer gespeichert ist.

Schritt 3: Erstellen Sie einen Server

1. Nachdem Sie Ihr Projekt eingerichtet haben, müssen Sie einen Server erstellen.
2. Geben Sie Ihrem Server einen Namen.
3. Geben Sie die Portnummer an, auf der es ausgeführt werden soll.

Schritt 4: Erstellen Sie ein übergeordnetes Element

1. Als nächstes müssen Sie einen übergeordneten Server für Ihren Server erstellen.
2. Wählen Sie die Option zum Erstellen eines übergeordneten GraphQL-Elements.
3. Geben Sie einen Namen für das übergeordnete GraphQL-Element ein.
4. Legen Sie den REST-Pfad für den GraphQL-Endpunkt fest, normalerweise /graphql.
5. Entscheiden Sie mithilfe des Dropdown-Menüs, ob das übergeordnete Element ein Abfrage-Elternteil oder ein Mutation-Elternteil sein soll.
6. Geben Sie bei Bedarf einen Schemapfad für verschachtelte Abfragen in Punktnotation an (z. B. user.address).
7. Speichern Sie das übergeordnete Element, sobald alles ausgefüllt ist.

Schritt 5: Abfragen oder Mutationen erstellen

1. Klicken Sie auf der Seite „Elterndetails“ je nach Elterntyp auf „Abfrage hinzufügen“ oder „Mutation hinzufügen“.
2. Geben Sie einen Namen für die Abfrage oder Mutation ein. Dieser Name dient als Schemasignatur und sollte bei Bedarf Parameter enthalten. Beispielsweise würde eine Abfrage mit dem Namen „users“, die eine ID annimmt, „users(id: String)“ lauten.
3. Für komplexe Parameter wie benutzerdefinierte Objekte verwenden Sie „Any“ als Typ. Zum Beispiel „users(param: Any)“.
4. Optional können Sie eine Beschreibung hinzufügen.
5. Speichern Sie Ihre Abfrage oder Mutation.

Schritt 6: Fügen Sie der Abfrage oder Mutation mehrere Antworten hinzu

1. Gehen Sie zur Seite „Abfrage- oder Mutationsdetails“.
2. Klicken Sie auf „Antwort hinzufügen“.
3. Geben Sie im sich öffnenden Fenster Ihre Antwort ein. Sie haben drei Möglichkeiten:
   • JSON: Für JSON-Antworten können Sie automatisch Typen generieren. Klicken Sie auf „Generieren“, um den Antworttyp im Editor zu erstellen.
   • Funktion: Für Funktionsantworten müssen Sie den Antworttyp manuell einfügen. Alternativ können Sie mit einer JSON-Antwort beginnen, um den Typ zu generieren, und dann zu einer Funktion wechseln.
   • Proxy: Geben Sie für Proxy-Antworten den Antworttyp manuell ein oder verwenden Sie zuerst eine JSON-Antwort, um den Typ zu generieren, und wechseln Sie dann zu Proxy.
4. Füllen Sie außerdem das Feld „Antworttypname“ mit dem Haupttypnamen der Antwort aus.
5. Speichern Sie die Antwort.

Schritt 7: Proxy-Modus aktivieren (optional)

1. Mockingbird kann als Proxyserver für GraphQL fungieren. Wenn eine Abfrage oder Mutation nicht lokal gefunden wird, wird die Anfrage an den Zielserver weitergeleitet.
2. Sobald Sie eine Antwort vom Zielserver erhalten, können Sie sowohl die Abfrage als auch ihre Antwort über die Konsole zu Mockingbird hinzufügen.

Schritt 8: Starten Sie den Server und testen Sie ihn

1. Starten Sie den Server, um Ihre Konfigurationen anzuwenden.
2. Sobald der Server läuft, erhalten Sie einen Link zum GraphQL-Spielplatz.
3. Verwenden Sie diesen Link, um den Spielplatz zu öffnen.
4. Es wird auch eine Schaltfläche zum Kopieren einer Beispielabfrage für Ihr Setup geben.
5. Fügen Sie die Beispielabfrage in den Spielplatz ein, um zu überprüfen, ob Sie die gewünschte Antwort vom GraphQL-Server erhalten.

Epilog

Mockingbird erleichtert die komplexe Aufgabe, einen GraphQL-Server zu verspotten, erheblich. Dieses Tool eignet sich perfekt für Entwickler und Tester, da es ihnen ermöglicht, verschiedene Szenarien zu simulieren, ohne auf die Erstellung des eigentlichen Servers warten zu müssen. Mit Funktionen wie der Erstellung mehrerer Antworten, der Typgenerierung und dem einfachen Wechsel zwischen Setups optimiert Mockingbird Ihre Entwicklungs- und Testprozesse.

Proxy-Modus

Eine der herausragenden Funktionen von Mockingbird ist seine Fähigkeit, auch für GraphQL als Proxyserver zu fungieren. Diese Funktion ist unglaublich nützlich, wenn Sie Abfragen oder Mutationen haben, die nicht lokal in Mockingbird definiert sind. So funktioniert es:

• Anfragen weiterleiten: Wenn eine Abfrage oder Mutation in Ihrem lokalen Mockingbird-Setup nicht gefunden wird, leitet Mockingbird die Anfrage an den Zielserver weiter. Dadurch wird sichergestellt, dass Sie immer eine Antwort erhalten, auch wenn diese noch nicht lokal verspottet wurde.

• Antworten erfassen: Sobald Mockingbird die Antwort vom Zielserver erhält, können Sie sowohl die Abfrage als auch die Antwort zu Ihrem lokalen Mockingbird-Setup hinzufügen. Das bedeutet, dass Sie Ihren Scheinserver schnell mit echten Daten aufbauen können, ohne jede Antwort im Voraus manuell definieren zu müssen.

• Vereinfachung der Einrichtung: Diese Proxy-Funktion ermöglicht die schnelle und problemlose Einrichtung eines Scheinservers mit echten Daten. Anstatt jede mögliche Anfrage und Antwort manuell eingeben zu müssen, können Sie Mockingbird die eingehenden Anfragen erfassen und für Sie speichern lassen.

Diese Funktion eignet sich perfekt zum schnellen Einrichten realistischer Scheinumgebungen, insbesondere in dynamischen Entwicklungs- und Testszenarien. Es spart Ihnen Zeit und Mühe und stellt sicher, dass Ihr Mock-Server mit minimalem manuellen Eingriff so genau und umfassend wie möglich ist.

Ob Sie neue Funktionen entwickeln, automatisierte Tests durchführen oder komplexe Integrationen einrichten, mit den Proxy-Funktionen von Mockingbird sparen Sie Zeit und reduzieren Fehler. Seine Flexibilität und Benutzerfreundlichkeit machen es zu einem entscheidenden Werkzeug für moderne Softwareentwicklungs- und Testumgebungen.

Durch die Verwendung von Mockingbird können Sie sich auf die Erstellung und Verfeinerung Ihrer Anwendung konzentrieren und wissen, dass Ihre Scheinumgebung zuverlässig und effizient ist.

Treten Sie der Community bei

Wenn Ihnen dieser Leitfaden geholfen hat, warum probieren Sie es nicht einmal aus? Sie können Mockingbird herunterladen und noch heute mit dem Aufbau Ihrer eigenen Mock-Server beginnen. Wenn Ihnen gefällt, was Sie sehen, würde ein Stern auf GitHub viel bedeuten – es ist eine kleine Möglichkeit, Ihre Unterstützung für das Projekt zu zeigen. Und wenn Sie daran interessiert sind, einen Beitrag zu leisten, würden wir uns freuen, Sie an Bord zu haben. Ihr Feedback und Ihre Beiträge machen Mockingbird mit jedem Update besser.

Das obige ist der detaillierte Inhalt vonErstellen eines GraphQL-Servers in Mockingbird. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!