GraphQL is een querytaal voor uw API en een serverside runtime voor het uitvoeren van die queries met uw bestaande gegevens. Het biedt een efficiënt en krachtig alternatief voor REST.
Hier is een stap voor stap gids over hoe u GraphQL kunt instellen en gebruiken met Node.js:
1. Installeer benodigde dependencies: Gebruik npm (node package manager) om de nodige pakketten te installeren. U heeft nodig: express (een minimal en flexibel Node.js web application framework), graphql en express-graphql.
```
npm install express express-graphql graphql
```
1. Import de benodigde modules in uw applicatiebestand:
```
var express = require(‘express’);
var graphqlHTTP = require(‘express-graphql’);
var { buildSchema } = require(‘graphql’);
```
1. Definieer uw schema: GraphQL vraagt u om uw data set te definiëren in een schema. Voorbeeld:
```
var schema = buildSchema(`
type Query {
hallo: String
}
`);
```
1. Bepaal de resolver: Bij het ontvangen van specifieke GraphQL-query’s wordt telkens een resolver aangeroepen. De createResolver-functie retourneert de resolver naar ons schema.
```
var root = {
hallo: () => {
return ‘Hallo wereld!’;
},
};
```
1. Installeer de middleware: Om HTTP-aanvragen als GraphQL-query’s te verwerken, moet u de express-graphql-middleware op uw express-server installeren.
```
var app = express();
app.use(‘/graphql’, graphqlHTTP({
schema: schema,
rootValue: root,
graphiql: true, // het stelt je in staat om je GraphQL API in de browser te testen
}));
app.listen(4000);
```
1. Run uw applicatie: Nu kunt u uw express app draaien. Het zal luisteren naar de poort 4000.
```
node uw-applicatiebestand.js
```
1. Test uw GraphQL server: Open uw browser en ga naar `http://localhost:4000/graphql`. U kunt beginnen met testen van de GraphQL server. Bijvoorbeeld, in het invoervak aan de linkerkant van de pagina voert u `{ hallo }` in en drukt u op de “Play” knop, u zou “Hallo wereld!” aan de rechterkant van de pagina moeten zien.
Let op: De bovenstaande instructie is een fundamentele introductie. In de praktijk zal uw applicatie veel complexer zijn met database-operaties en authenticaties.
