Pour construire une API GraphQL dans GO, la bibliothèque GQLGEN est recommandée pour améliorer l'efficacité du développement. 1. Tout d'abord, sélectionnez la bibliothèque appropriée, telle que GQLGEN, qui prend en charge la génération automatique de code basée sur le schéma; 2. Définissez ensuite le schéma GraphQL, décrivez la structure de l'API et le portail de requête, tels que la définition des types de post et des méthodes de requête; 3. Puis initialisez le projet et générez le code de base pour implémenter la logique métier dans Resolver; 4. Enfin, connectez le gestionnaire GraphQL au serveur HTTP et testez l'API via le terrain de jeu intégré. Les notes incluent les spécifications de dénomination du champ, la gestion des erreurs, l'optimisation des performances et les paramètres de sécurité, etc. pour assurer la maintenance et la stabilité du projet.

La construction d'une API GraphQL n'est pas réellement compliquée dans le langage Go, surtout après avoir des bibliothèques comme graphql-go ou gqlgen . Si vous connaissez déjà la syntaxe de base et le processus de développement Web de GO, cette étape ajoute simplement une autre couche de logique de requête et d'analyse.

Ci-dessous, je commencerai de plusieurs perspectives pratiques pour vous aider à régler l'ensemble du processus.

Préparation: choisissez la bonne bibliothèque

Il y a deux bibliothèques GraphQL traditionnelles dans l'écosystème Go:

• GraphQL-Go : communauté à l'ancienne et mature, adaptée à ceux qui veulent comprendre les principes sous-jacents.
• GQLGEN : un cadre moderne généré par le code adapté aux projets avec un développement rapide et une structure claire.

Si vous souhaitez réduire le travail répétitif de l'écriture manuelle du schéma et du résolveur, GQLGEN est recommandé . Il peut générer automatiquement des définitions de type et des interfaces résolvantes en fonction de votre schéma, ce qui fait gagner beaucoup de temps.

étape 1: Définir le schéma (système de type GraphQL)

Le c?ur de GraphQL est son schéma, qui est le fichier de description de l'interface de votre API. Dans GQLGEN, vous devez créer un fichier schema.graphqls pour définir le portail de type et de requête.

Par exemple, si vous souhaitez créer un système de blog simple, vous pouvez l'écrire comme ceci:

 Type Post {
  je l'ai fait!
  Titre: String!
  Contenu: String!
}

Type Query {
  Posts: [Post!]!
  Post (ID: ID!): Post
}

Ce schéma signifie que vous pouvez obtenir tous les articles via /query ou interroger un seul article en fonction de votre identifiant.

Conseils: Les définitions de schéma doivent être aussi proches de la logique commerciale que possible pour éviter une nidification excessive ou une redondance sur le terrain. Cela facilite le maintien plus tard.

étape 2: Initialisez le projet et générez du code

L'un des principaux avantages de l'utilisation de GQLGEN est la génération automatique de code . En supposant que vous ayez installé l'environnement GO, exécutez la commande suivante:

 allez exécuter github.com/99designs/gqlgen init

Il générera la structure du répertoire suivant:

 graphique/
  modèle/
  résolver.go
  schéma.resolvers.go
schéma.graphqls

Ensuite, il vous suffit d'implémenter la méthode Resolver correspondante. Par exemple, complétez la logique des méthodes Posts() et Post() dans schema.resolvers.go .

 Func (r * QueryResolver) Posts (ctx context.context) ([] * modèle.post, error) {
    // Implémentation de la logique de requête de la base de données}

étape 3: Connectez-vous au serveur HTTP et testez

La dernière étape consiste à connecter le gestionnaire GraphQL à votre framework Web. GQLGEN prend en charge le net/http standard par défaut, vous pouvez donc écrire directement une fonction principale pour démarrer le service:

 package principal

importer (
    "enregistrer"
    "net / http"
    "Votre_project / graphique"
    "github.com/99designs/gqlgen/graphql/handler"
    "github.com/99designs/gqlgen/graphql/playground"
)

func main () {
    srv: = handler.newDefaultServer (graph.newExEcutablesChema (graph.config {résolvers: & graph.resolver {}}))

    http.handle ("/ query", srv)
    http.handle ("/", playground.handler ("GraphQL Playground", "/ Query"))

    Log.println ("Connectez-vous à http: // localhost: 8080 / pour GraphQL Playground")
    Log.fatal (http.ListenandServe (": 8080", nil))
}

Après avoir fonctionné, visitez http://localhost:8080 et vous pouvez utiliser le terrain de jeu intégré pour tester votre requête GraphQL.

Des questions et des notes fréquemment posées

• Spécification de dénomination des champs : Les champs GraphQL utilisent généralement CamelCase, et la structure GO est également recommandée à ComelCase. être cohérent entre les deux peut réduire les erreurs de mappage.
• Gestion des erreurs : il est légal de renvoyer error dans Resolver, et le frontal recevra des informations d'erreur détaillées.
• Optimisation des performances : Si le volume de données est important, n'oubliez pas d'ajouter un dataloader pour charger par lots les données associées pour éviter les problèmes de requête.
• Paramètres de sécurité : il est recommandé de fermer la page de terrain de jeu dans l'environnement de production et de limiter la profondeur ou la complexité de la requête maximale.

Fondamentalement, ce sont les étapes. Bien qu'il puisse prendre un certain temps pour comprendre la relation entre le schéma et le résolveur au début, une fois le premier exemple terminé, il sera facile de se développer plus tard.

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!