graphql Zelfstudie
Aan de slag met graphql

Opmerkingen

versies

Serverinstallatie en -implementatie

GraphQL.js

GraphQL.js is een JavaScript-referentie-implementatie voor GraphQL. Je kunt het installeren via npm:

• Initialiseer npm in uw project als u dit nog niet hebt gedaan: npm init
• Installeer GraphQL.js vanaf npm: npm install --save graphql

Voorbeeldserver

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);
});

Alternatieven voor servermiddleware

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

GraphQL Query Language (GQL)

In plaats van URL-eindpunten voor elke gegevensbron te definiëren, definieert u in GraphQL een enkel eindpunt dat GraphQL-query's accepteert. In tegenstelling tot traditionele databasequery-talen, is GraphQL Query Language (GQL) een projectie van gegevens die worden geretourneerd door een query op hoofdniveau. Het GraphQL-schema definieert het datamodel en query's en mutaties op hoofdniveau. GQL voert deze query's uit en bepaalt welke gegevens moeten worden geretourneerd.

Query voor alle filmtitels uit Star Wars Schema

GraphiQL-vraag

Query for Planet Residents to Star Wars-film "A New Hope"

GraphiQL-vraag

Merk op hoe de root-query film() de parameter id van de film "A New Hope" aanneemt en de projectie van GQL de titel retourneert, planeten die zijn verbonden met de film en vervolgens de namen van de planeten. Bekijk de Star Wars GraphiQL- site om te experimenteren met query's in GraphQL.

Schemadefinitie

In GraphQL definieert het schema de rootuitvoeringsquery 's en -mutaties en de typen voor uw gegevens.

Schema Objecttype

Het Person heeft twee velden, één is een standaard Scalar-type en de andere vertegenwoordigt een relatie met een lijst met andere persoonstypes die 'vrienden' zijn. Het koppelen van andere typen maakt GraphQL zo krachtig. Nu in GraphQL Query Language (GQL) kan de client de vriendengrafiek doorlopen zonder extra code of geavanceerde query's.

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

Schema Query

De zoekopdracht van een person zoekt een persoon op aan de hand van zijn ID. Dit is het toegangspunt tot uw gegevens voor klanten die GQL gebruiken.

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

Vraag Nick's Friend's Friends's Friends

Nu we een personentype en een root-vraag hebben, kunnen we een persoon opzoeken en zoveel scheidingsgraden als we willen van het vriendennetwerk van de persoon.

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