graphql Tutoriel
Démarrer avec graphql

Remarques

Versions

Installation et implémentation du serveur

GraphQL.js

GraphQL.js est une implémentation de référence JavaScript pour GraphQL. Vous pouvez l'installer via npm:

• Initialisez npm dans votre projet si vous ne l'avez pas déjà fait: npm init
• Installez GraphQL.js à partir de npm: npm install --save graphql

Exemple de serveur

var { graphql, buildSchema } = require('graphql');

// Construct a schema, using GraphQL schema language
var schema = buildSchema(`
  type Query {
    hello: String
  }
`);

// The root provides a resolver function for each API endpoint
var root = {
  hello: () => {
    return 'Hello world!';
  },
};

// Run the GraphQL query '{ hello }' and print out the response
graphql(schema, '{ hello }', root).then((response) => {
  console.log(response);
});

Alternatives au middleware serveur

• Middleware Express GraphQL
• Middleware Hapi GraphQL
• Koa GraphQL Middleware

Langage d'interrogation GraphQL (GQL)

Au lieu de définir les noeuds finaux d'URL pour chaque ressource de données, vous définissez dans GraphQL un seul noeud final qui accepte les requêtes GraphQL. Contrairement aux langages de requête de base de données traditionnels, le langage de requête GraphQL (GQL) est une projection de données renvoyée par une requête de niveau racine. Le schéma GraphQL définira le modèle de données et les requêtes et mutations au niveau racine. GQL exécute ces requêtes et définit les données à renvoyer.

Query for All Film Titles de Star Wars Schema

Requête GraphiQL

Query for Planet Residents au film Star Wars "Un nouvel espoir"

Requête GraphiQL

Remarquez comment le film() requête racine film() prend en compte le paramètre id du film "A New Hope" et la projection de GQL renvoie le titre, les planètes connectées au film, puis les noms de résident des planètes. Découvrez le site Star Wars GraphiQL pour tester les requêtes dans GraphQL.

Définition du schéma

Dans GraphQL, le schéma définit les requêtes et les mutations d' exécution racine, ainsi que les types de vos données.

Type d'objet de schéma

Le type Person a deux champs, l'un est un type Scalar standard et l'autre représente une relation avec une liste d'autres types de personnes qui sont des «amis». Lier d'autres types est ce qui rend GraphQL si puissant. Désormais, dans le langage de requête GraphQL (GQL), le client peut parcourir le graphique des amis sans code ni requête avancée.

type Person {
  id: ID
  name: String
  friends: [Person]
}

Requête de schéma

La person interroge une personne par son identifiant. C'est le point d'entrée de vos données pour les clients utilisant GQL.

type Query {   
  person(id: ID!): Person
}

Interroger les amis de l'ami de Nick

Maintenant que nous avons un type de personne et une requête de personne, nous pouvons rechercher une personne et autant de degrés de séparation que nous voulons du réseau d'amis de la personne.

query {
  person(id: 'nick'){
    id
    name
    friends{
      id
      name
      friends{
        id
        name
        friends{
          id
          name
        }
      }
    }
  }
}