graphql Handledning
Komma igång med graphql

Anmärkningar

versioner

Serverinstallation och implementering

GraphQL.js

GraphQL.js är en JavaScript-referensimplementering för GraphQL. Du kan installera det via npm:

• Initiera npm i ditt projekt om du inte redan har gjort det: npm init
• Installera GraphQL.js från npm: npm install --save graphql

Exempel 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-alternativ

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

GraphQL Query Language (GQL)

I stället för att definiera URL-slutpunkter för varje dataresurs definierar du i GraphQL en enda slutpunkt som accepterar GraphQL-frågor. Till skillnad från traditionella databasfrågespråk är GraphQL Query Language (GQL) en projicering av data som returneras av en rotnivåfråga. GraphQL-schemat definierar datamodellen och rotnivåfrågor och mutationer. GQL kör dessa frågor och definierar vilka data som ska returneras.

Fråga för alla filmtitlar från Star Wars Schema

GraphiQL Query

Fråga för Planet Residents till Star Wars-filmen "Ett nytt hopp"

GraphiQL Query

Lägg märke till hur rotfrågefilmen film() tar in ID-parametern för filmen "Ett nytt hopp" och projektionen från GQL returnerar titeln, planeter som är anslutna till filmen och sedan bosatta namn på planeterna. Kolla in Star Wars GraphiQL- webbplatsen för att experimentera med frågeställningar i GraphQL.

Schema Definition

I GraphQL definierar schemat root-exekveringsfrågor och mutationer samt typerna för dina data.

Schemaobjekttyp

Person har två fält, ett är en standard skalartyp och den andra representerar en relation till en lista med andra persontyper som är "vänner". Att länka andra typer är det som gör GraphQL så kraftfull. Nu i GraphQL Query Language (GQL) kan klienten korsa vännergrafen utan ytterligare kod eller avancerad fråga.

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

Schemafråga

Den person frågan slår upp en enda person genom sin id. Detta är ingångspunkten för dina data för klienter som använder GQL.

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

Fråga Nick's Friend's Friend's Friends

Nu när vi har en persontyp och en personrotsfråga kan vi slå upp en person och så många grad av separering vi vill ha i personens vänner nätverk.

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