graphql Tutorial
Erste Schritte mit graphql

Bemerkungen

Versionen

Serverinstallation und Implementierung

GraphQL.js

GraphQL.js ist eine JavaScript-Referenzimplementierung für GraphQL. Sie können es über npm installieren:

• Initialisieren Sie npm in Ihrem Projekt, wenn Sie dies noch nicht getan haben: npm init
• Installieren Sie GraphQL.js von npm: npm install --save graphql

Beispiel Server

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

Server-Middleware-Alternativen

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

GraphQL-Abfragesprache (GQL)

Anstatt URL-Endpunkte für jede Datenressource zu definieren, definieren Sie in GraphQL einen einzelnen Endpunkt, der GraphQL-Abfragen akzeptiert. Im Gegensatz zu herkömmlichen Datenbankabfragesprachen ist GraphQL Query Language (GQL) eine Projektion von Daten, die von einer Abfrage auf Stammebene zurückgegeben werden. Das GraphQL-Schema definiert das Datenmodell und Abfragen und Mutationen auf Stammebene. GQL führt diese Abfragen aus und definiert, welche Daten zurückgegeben werden sollen.

Abfrage für alle Filmtitel aus Star Wars Schema

GraphiQL-Abfrage

Frage nach Planetenbewohnern im Star Wars Film "A New Hope"

GraphiQL-Abfrage

Beachten Sie, wie die Root-Abfrage film() den id-Parameter des Films "A New Hope" übernimmt und die Projektion von GQL den Titel, die mit dem Film verbundenen Planeten und die residenten Namen der Planeten zurückgibt. Besuchen Sie die Star Wars GraphiQL- Site, um mit Abfragen in GraphQL zu experimentieren.

Schema-Definition

In GraphQL definiert das Schema die Root-Ausführungsabfragen und -mutationen sowie die Typen für Ihre Daten.

Schema-Objekttyp

Der Person hat zwei Felder, eines ist ein Standard-Skalartyp, und das andere stellt eine Beziehung zu einer Liste anderer Personentypen dar, die "Freunde" sind. Die Verknüpfung mit anderen Typen macht GraphQL so mächtig. In der GraphQL-Abfragesprache (GQL) kann der Client nun den Freundesgraph ohne zusätzlichen Code oder erweiterte Abfragen durchsuchen.

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

Schema-Abfrage

Die person sucht eine einzelne Person anhand ihrer ID. Dies ist der Einstiegspunkt in Ihre Daten für Kunden, die GQL verwenden.

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

Freunde des Freundes von Nick fragen

Da wir nun einen Personentyp und eine Personenwurzelabfrage haben, können wir eine Person suchen und so viele Trennungsgrade wie wir vom Freundesnetzwerk der Person wünschen.

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