Het maken van een GraphQL API met Node.js omvat verschillende stappen. Hier is een eenvoudige handleiding:
1. Project Setup:
Eerst moet je een nieuw project aanmaken. Als je Node en npm geïnstalleerd hebt, maak dan een nieuwe map aan voor je project en initialiseer een nieuw Node.js-project door het commando ‘npm init’ te gebruiken.
1. Installeren van Afhankelijkheden:
Voor dit project heb je de volgende pakketten nodig: graphql, express, express-graphql. Je kunt ze installeren via npm:
```
npm install graphql express express-graphql —save
```
1. Maak een GraphQL Schema:
Daarna moet je een GraphQL Schema maken. Dit is een speciaal object dat definieert welke data er opgehaald kan worden uit je database. Hier is een eenvoudig voorbeeld:
```
const { buildSchema } = require(“graphql”);
const schema = buildSchema(`
type Query {
hello: String
}
`);
```
In dit geval is er slechts één query die een enkele string teruggeeft – ‘hello’. In een daadwerkelijke API zou je hier waarschijnlijk veel verschillende velden hebben die verband houden met verschillende delen van je database.
1. Definieer een Resolvers:
Resolvers worden gebruikt om werkelijke data te halen voor de velden die in je schema gedefinieerd zijn. Hier is de resolver voor het bovenstaande schema:
```
const root = {
hello: () => {
return “Hello, world!”;
},
};
```
1. Maak een Express App:
Nu je een schema en een resolver hebt, kun je een Express app maken die je gebruikt om je API te ‘hosten’. Eerst moet je express en express-graphql importeren en dan kun je een nieuwe app maken en een enkele route definiëren die je GraphQL schema en resolvers gebruikt:
```
const express = require(“express”);
const { graphqlHTTP } = require(“express-graphql”);
const app = express();
app.use(
“/graphql”,
graphqlHTTP({
schema: schema,
rootValue: root,
graphiql: true,
})
);
app.listen(4000);
```
In dit voorbeeld wordt de graphqlHTTP middleware functie gebruikt om je schema en resolvers te verbinden en is de graphiql-optie ingesteld op ‘true’ om een handige testinterface in je browser te kunnen gebruiken.
Als je de app nu draait (met ‘node app.js’ of iets dergelijks), zou je in staat moeten zijn om naar localhost:4000/graphql te gaan in je browser en de string ‘Hello, world!’ terug te krijgen als je de ‘hello’ query uitvoert.
Dit is slechts een zeer eenvoudig voorbeeld, maar het geeft hopelijk een beetje inzicht in hoe je een GraphQL API met Node.js kunt maken. In een daadwerkelijk project zou je waarschijnlijk ook een database nodig hebben (zoals mongoose voor MongoDB) en zou je waarschijnlijk veel meer complexe schema’s en resolvers hebben.
