Server-side JavaScript

1 - Installer MongoDB sur votre machine

Suivez les installations propres à votre système d'exploitation situées sur cette page du site officiel. Ne choisissez pas l'installation manuelle.

Sur mon Mac j'ai fait:

• brew update
• brew install mongodb
• mkdir -p /data/db
• chmod 777 /data/db (pour autoriser un user lambda à écrire dedans)
• mongod (pour exécuter MongoDB)

2 - Créer et peupler une collection par défaut (avec un dataset issu du tutorial MongoDB officiel)

• Suivre les instructions situées sur cette page. Vous allez devoir récupérer le fichier primer-dataset.json (assez gros, attention, ne pas faire copier/coller), et exécuter la commande suivante, qui créer une bd "test" et ajoute dedans la collection "restaurants" :

  • mongoimport --db test --collection restaurants --drop --file primer-dataset.json

• Une fois l'importation faite, garder l'onglet ouvert sur cette page, car on va continuer le tutorial à l'étape 5.

3 - Installer un outil d'administration sympa

Je vous recommande fortement MongoChef, un produit commercial mais gratuit pour utilisation non commerciale. Le télécharger sur: http://3t.io/mongochef/

4 - Ouvrir MongoChef et voir la collection que l'on vient d'importer

• S'assurer que MongoDB tourne (mongod doit être lancé, ou bien vous devez avoir installé MongoDB en service)
• Lancer l'application 3T Mongo Chef, connectez-vous sur MongoDB. Les valeurs par défaut doivent être Ok, normalement.
• Ouvrir la collection "restaurants" dans la base "test"

Quelques screenshots:

5 - Installer le driver MongoDB pour NodeJS

• Créez un répertoire tpmongo
• cd tpmongo
• npm install mongodb

Ca doit télécharger le module driver mongodb dans un sous-répertoire node_modules.

6 - Tester des bouts de code JavaScript qui font le CRUD dans cette base

Suivre la suite du tutorial MongoDB, en commençant par la page montrant comment se connecter à la base restaurant. Vous devez copier/coller le code dans un fichier connect.js puis l'exécuter avec node connect.js. Si vous suivez bien les instructions de la page vous devriez obtenir:

connect.js:

var MongoClient = require('mongodb').MongoClient;
var assert = require('assert');
var url = 'mongodb://localhost:27017/test';


MongoClient.connect(url, function(err, db) {
  assert.equal(null, err);
  console.log("Connected correctly to server", url);
  db.close();
});

Vous le testerez en exécutant node connect.js et ça devrait afficher sur la console "Connected correctly to server".

Vous passerez ensuite à la page de tutorial suivante, et ainsi de suite...

Chaque page va vous proposer des bouts de code JavaScript pour chercher, modifier, supprimer et insérer des données dans la base des restaurants. Je vous conseille à chaque fois de faire un fichier différent et le tester ensuite avec la commande node:

• node connect.js
• node insert_document.js
• node find_all.js
• node find_some.js
• node update.js
• node delete.js
• node aggregation.js
• node indexes.js

Correction de cette partie:

• connect_driver.js
• find_all.js
• find_some.js
• insert_document.js avec vella.js qui contient la définition d'un restaurant (utilisé par insert_document.js)
• aggregate.js

7 - Intégrer le code dans une application Node/Express qui fait du routage

Pour MBDS Madagascar :

• A étudier: findServer.js et mettre dans public le fichier : restaurants.h en le renommant restaurants.html.
• Testez en lançant node findServer.js

Ce sera le TP à rendre pour la semaine prochaine ! Je passerai lundi ou mardi vous voir en classe.

Vous devrez insérer le code qui fait le CRUD dans MongoDB dans les fonctions de routage vues lors du cours sur Express. Vous renverrez les résultats en JSON. Pour les POSTs vous devrez produire un formulaire et vous pourrez tester dans un premier temps les updates et delete via GET, en tapant l'URL dans votre navigateur.

Allez-y incrémentalement, petit à petit.

1. Mettez un bouton "connexion à MongoDB" dans la page d'accueil. On clique dessus et ça doit renvoyer "connexion effectuée".
2. Ajoutez un bouton "voir 10 données" qui doit afficher les 10 premiers restaurants, pour voir si cela fonctionne.
3. Maintenant on essaie d'envoyer une requête en Ajax et on essaie de retourner les résultats en JSON. On les affichera avec console.log dans un premier temps.
4. Maintenant on essaie de les afficher dans un tableau HTML construit dynamiquement en utilisant l'API du DOM.
5. Maintenant on essaie de rajouter dans le tableau un bouton "supprimer" et quand on clique dessus ça appelle l'URL pour supprimer une donnée. On re-affichera les données pour vérifier que le restaurant a disparu.
6. On fera un formulaire pour ajouter un restaurant, un autre pour modifier un restaurant..

Ici deux corrections possibles:

1. Une correction qui n'utilise pas jQuery. La correction comprend un fichier package.json qui contient la liste des modules nécessaires. Ce fichier package.json contient également une directive pour lancer le serveur. Regardez ce fichier, puis, pour installer automatiquement les modules nécessaires au projet, exécuter la commande "npm install". Ceci va télécharger et installer les modules. Pour exécuter le serveur vous pouvez taper "npm start" (encore une fois, regardez package.json, le script "start" lance "node connect.js".
   • tpmongo1.zip
      
2. Une correction utilisant jQuery et un widget jQuery très populaire qui s'appelle une DataTable (voir sur datatables.net). Ce projet ne comprends pas de package.json, il faudra donc installer à la main les packages express, mongodb, body-parser avec la commande "npm install express body-parser mongodb".
   • tpMongoAvecDataTableEtjQuery.zip

Vous pourrez trouver de la documentation sur la commande npm et sur le fichier package.json dans ce tutorial.

MOOCS SUR MONGODB

MOOC pour bien débuter, donné par les auteurs de MongoDB

• https://university.mongodb.com/courses/M101JS/about

Créer un server Web (routage, Web Services, etc.)

• Mod ule express (http://expressjs.com/). Beaucoup de documentation en français sur le site officiel , notamment des tutoriaux de base pour faire un routage simple.
  • Bon tutorial sur le routage simple: https://codeforgeek.com/2015/05/expr...uter-tutorial/, comment récupérer des paramètres passés dans l'URL, comment gérer les erreurs 404, comment définir de simples services REST
  • Très bon tuto sur le routage, explique static_files, RESTFUL, multipart, etc. http://www.tutorialspoint.com/nodejs..._framework.htm
  • Un tuto sur openclassroom express de base et ejs (moteur de templates): https://openclassrooms.com/courses/d...ork-express-js

Bases de données relationnelles

• Module Knex (http://knexjs.org/), permet de manipuler des données relationnelles avec Postgres, MySQL, MariaDB, SQLite3, et Oracle. Supporte les transactions via des promesses, très bien adapté à JavaScript.
  • Voir par exemple cette vidéo de création d'un blog avec express et Knex: https://www.livecoding.tv/video/crea...-using-nodejs/