Rendez-vous sur le site https://nodejs.org/en/ pour télécharger et installer la dernière version de NodeJS (minimum version 8 pour ce workshop).
Vous pouvez également l’installer via votre gestionnaire de paquet favoris, cependant, dans ce cas, veuillez installer également le paquet npm ou yarn.
Dans votre terminal créez un nouveau dossier et initialisez le projet
$ mkdir api-graphql-node-mongo
$ cd api-graphql-node-mongo
$ npm init -yNous allons utiliser plusieurs librairies :
apollo-server: Notre serveur GraphQLgraphql: Utilisé par notre serveur Apollomongoose: Pour creer des documents MongoDB
Pour les installer :
$ npm install -save apollo-server graphql mongooseCréez un fichier index.js
const { ApolloServer, gql } = require("apollo-server");
const lang = {
name: "Javascript",
ext: "js"
};
const typeDefs = gql`
type Lang {
name: String
ext: String
}
type Query {
lang: Lang
}
`;
const resolvers = {
Query: {
lang: lang
}
};
const server = new ApolloServer({ typeDefs, resolvers });
server.listen().then(({ url }) => console.log(`Listening on ${url}`));Puis dans un terminal
$ node index.jsVous pouvez maintenant vous rendre dans votre navigateur à l'adresse http://localhost:4000/ où vous pourrez tester votre premiere requete GraphQL :
{
lang {
name
ext
}
}Et ainsi recevoir l'user que nous avons defini precedement
Rendez vous sur https://mlab.com/ et créez un compte gratuit pour heberger une base de donnée MongoDB
Une fois votre base de donnée crée, récuperez son URL et modifiez le fichier index.js
// ...
const server = new ApolloServer({ typeDefs, resolvers });
mongoose.connect("__URL_MONGOLAB__", { useNewUrlParser: true });
mongoose.connection
.once("open", () => {
console.log("Connected to MongoLab");
server.listen().then(({ url }) => console.log(`Listening on ${url}`));
})
.on("error", error => console.log("Error connecting to MongoLab:", error));Dans l'interface de MongoLab vous devrez ensuite créer un utilisateur ainsi que la collection lang.
Ajouter ensuites quelques documents dans la collection lang:
{
"name": "Javascript",
"ext": "js"
}{
"name": "GraphQL",
"ext": "gql"
}Creez un fichier Lang.js
const mongoose = require("mongoose");
const LangSchema = new mongoose.Schema(
{
name: { type: String },
ext: { type: String }
},
{ collection: "lang" }
);
module.exports = mongoose.model("Lang", LangSchema);Creez un fichier resolver.js
const Lang = require("./Lang");
async function lang(parent, args, context) {
const res = await Lang.find({ name: args.name });
if (res.length < 1) {
return null;
}
return res[0];
}
async function allLang(parent, args, context) {
return Lang.find();
}
module.exports = {
lang,
allLang
};Puis modifiez le fichier index.js
// ...
const { lang, allLang } = require("./resolver");
const typeDefs = gql`
type Lang {
name: String
ext: String
}
type Query {
lang(name: String): Lang
allLang: [Lang]
}
`;
const resolvers = {
Query: {
lang: lang,
allLang: allLang
}
};
// ...Dans le fichier resolver.js ajoutez les deux resolvers suivants :
async function addLang(parent, args, context) {
const newLang = new Lang({ name: args.name, ext: args.ext });
const savedLang = await newLang.save();
return savedLang;
}
async function deleteLang(parent, args, context) {
const deletedLang = await Lang.findOneAndDelete({ name: args.name });
return deletedLang;
}N'oubliez pas d'export ces deux fonctions
Et dans index.js on va definir ces deux mutations dans le typedef
const typeDefs = gql`
type Lang {
name: String
ext: String
}
type Query {
lang(name: String): Lang
allLang: [Lang]
}
type Mutation {
addLang(name: String, ext: String): Lang
deleteLang(name: String): Lang
}
`;
const resolvers = {
Query: {
lang: lang,
allLang: allLang
},
Mutation: {
addLang: addLang,
deleteLang: deleteLang
}
};N'oubliez pas d'importer les deux nouveaux resolvers
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent