Création d'un serveur GraphQL dans Mockingbird

Introduction

Bienvenue ! Ce guide vous guidera à travers les étapes de création d'un serveur GraphQL à l'aide de Mockingbird. Que vous soyez développeur ou testeur, ce guide vous aidera à configurer un serveur GraphQL fictif, à créer des requêtes et des mutations et à tout tester. À la fin, vous disposerez d'un serveur fictif robuste qui rendra votre processus de développement plus fluide et plus rapide.

Dans les guides précédents, nous avons abordé des sujets tels que la configuration de votre serveur fictif avec Mockingbird, les préréglages Mockingbird : optimisation des flux de travail de développement d'API et la création et la gestion de plusieurs projets et serveurs avec Mockingbird. Ces guides ont fourni une base solide pour utiliser Mockingbird dans divers scénarios. S'appuyant sur ces connaissances, ce guide se concentre spécifiquement sur l'exploitation de Mockingbird pour simuler les serveurs GraphQL. Si vous avez trouvé nos guides précédents utiles, vous trouverez celui-ci tout aussi précieux car il aborde les spécificités de la gestion de GraphQL avec Mockingbird.

Plongeons-nous et voyons comment Mockingbird peut simplifier la configuration et les tests de votre serveur GraphQL.

Étape 1 : Téléchargez et installez Mockingbird

1. Rendez-vous sur la page des versions de Mockingbird GitHub.
2. Téléchargez la dernière version.
3. Une fois le téléchargement terminé, ouvrez Mockingbird.

Étape 2 : Créer un nouveau projet ou cloner un projet existant

1. Lorsque vous ouvrez Mockingbird, vous verrez un écran « Créer un projet » avec trois options :
   • Créer un nouveau projet : démarrez un nouveau projet à partir de zéro en saisissant un nom de projet.
   • Cloner un projet existant : clonez un projet en saisissant l'URL du référentiel et tous les détails d'authentification nécessaires.
   • Ouvrir un projet existant : ouvrez un projet déjà enregistré sur votre ordinateur.

Étape 3 : Créer un serveur

1. Après avoir configuré votre projet, vous devrez créer un serveur.
2. Donnez un nom à votre serveur.
3. Spécifiez le numéro de port sur lequel il s'exécutera.

Étape 4 : Créer un parent

1. Ensuite, vous devez créer un parent pour votre serveur.
2. Choisissez l'option pour créer un parent GraphQL.
3. Entrez un nom pour le parent GraphQL.
4. Définissez le chemin REST pour le point de terminaison GraphQL, généralement /graphql.
5. Décidez si le parent sera un parent de requête ou un parent de mutation à l'aide du menu déroulant.
6. Si nécessaire, spécifiez un chemin de schéma pour les requêtes imbriquées en utilisant la notation par points (par exemple, user.address).
7. Sauvez le parent une fois que tout est rempli.

Étape 5 : Créer des requêtes ou des mutations

1. Dans la page Détails du parent, cliquez sur « Ajouter une requête » ou « Ajouter une mutation » en fonction de votre type de parent.
2. Entrez un nom pour la requête ou la mutation. Ce nom sera la signature du schéma et devra inclure des paramètres si nécessaire. Par exemple, une requête appelée utilisateurs qui prend un identifiant serait users(id: String).
3. Pour les paramètres complexes tels que les objets personnalisés, utilisez Any comme type. Par exemple, utilisateurs (param : Any).
4. Facultativement, ajoutez une description.
5. Enregistrez votre requête ou mutation.

Étape 6 : Ajouter plusieurs réponses à la requête ou à la mutation

1. Accédez à la page Détails de la requête ou de la mutation.
2. Cliquez sur « Ajouter une réponse ».
3. Dans la fenêtre qui s'ouvre, saisissez votre réponse. Vous avez trois options :
   • JSON : Pour les réponses JSON, vous pouvez générer automatiquement des types. Cliquez sur "Générer" pour créer le type de réponse dans l'éditeur.
   • Fonction : Pour les réponses de fonction, vous devez insérer manuellement le type de réponse. Vous pouvez également commencer par une réponse JSON pour générer le type, puis passer à une fonction.
   • Proxy : pour les réponses proxy, insérez manuellement le type de réponse ou utilisez d'abord une réponse JSON pour générer le type, puis passez au proxy.
4. Remplissez également le champ « Nom du type de réponse » avec le nom du type principal de la réponse.
5. Enregistrez la réponse.

Étape 7 : Activer le mode proxy (facultatif)

1. Mockingbird peut servir de serveur proxy pour GraphQL. Si une requête ou une mutation n'est pas trouvée localement, elle transmet la requête au serveur cible.
2. Une fois que vous obtenez une réponse du serveur cible, vous pouvez ajouter à la fois la requête et sa réponse à Mockingbird depuis la console.

Étape 8 : démarrer le serveur et tester

1. Démarrez le serveur pour appliquer vos configurations.
2. Une fois le serveur exécuté, vous obtiendrez un lien vers le terrain de jeu GraphQL.
3. Utilisez ce lien pour ouvrir le terrain de jeu.
4. Il y aura également un bouton pour copier un exemple de requête pour votre configuration.
5. Collez l'exemple de requête dans le terrain de jeu pour vérifier que vous obtenez la réponse souhaitée du serveur GraphQL.

Épilogue

Mockingbird facilite grandement la tâche complexe de simulation d'un serveur GraphQL. Cet outil est parfait pour les développeurs et les testeurs, leur permettant de simuler divers scénarios sans attendre la construction du serveur réel. Avec des fonctionnalités telles que la création de réponses multiples, la génération de types et le basculement facile entre les configurations, Mockingbird rationalise vos processus de développement et de test.

Mode proxy

L'une des fonctionnalités les plus remarquables de Mockingbird est sa capacité à agir comme un serveur proxy, même pour GraphQL. Cette fonctionnalité est incroyablement utile lorsque vous avez des requêtes ou des mutations qui ne sont pas définies localement dans Mockingbird. Voici comment cela fonctionne :

• Demandes de transfert : lorsqu'une requête ou une mutation n'est pas trouvée dans votre configuration Mockingbird locale, Mockingbird transmet la demande au serveur cible. Cela garantit que vous obtenez toujours une réponse, même si elle n'est pas encore moquée localement.

• Capture des réponses : Une fois que Mockingbird reçoit la réponse du serveur cible, il vous permet d'ajouter à la fois la requête et sa réponse à votre configuration Mockingbird locale. Cela signifie que vous pouvez rapidement créer votre serveur fictif en utilisant des données réelles sans définir manuellement chaque réponse à l'avance.

• Simplification de la configuration : Cette fonctionnalité de proxy permet de configurer un serveur fictif avec des données réelles rapidement et sans tracas. Au lieu d'avoir à saisir manuellement toutes les requêtes et réponses possibles, vous pouvez laisser Mockingbird les capturer et les stocker pour vous au fur et à mesure de leur arrivée.

Cette fonctionnalité est parfaite pour configurer rapidement des environnements simulés réalistes, en particulier dans des scénarios de développement et de test dynamiques. Cela vous fait gagner du temps et des efforts, en garantissant que votre serveur fictif est aussi précis et complet que possible avec une intervention manuelle minimale.

Que vous développiez de nouvelles fonctionnalités, exécutiez des tests automatisés ou mettiez en place des intégrations complexes, les capacités de proxy de Mockingbird vous font gagner du temps et réduisent les erreurs. Sa flexibilité et sa facilité d'utilisation en font un outil crucial pour les environnements modernes de développement et de test de logiciels.

En utilisant Mockingbird, vous pouvez vous concentrer sur la création et le perfectionnement de votre application, sachant que votre environnement fictif est fiable et efficace.

Rejoignez la communauté

Si ce guide vous a aidé, pourquoi ne pas l'essayer ? Vous pouvez télécharger Mockingbird et commencer à créer vos propres serveurs fictifs dès aujourd'hui. Si vous aimez ce que vous voyez, une étoile sur GitHub signifierait beaucoup : c’est une petite façon de montrer votre soutien au projet. Et si vous souhaitez contribuer, nous serions ravis de vous compter parmi nous. Vos commentaires et contributions sont ce qui rend Mockingbird meilleur à chaque mise à jour.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!