Master 2 Miage MBDS 2019-2020

Rappels sur l'asynchronisme en JavaScript, les reqêtes Ajax

Support de cours :

1. Des callbacks aux promesses et révision sur la gestion des erreurs, map/reduce, le parallélisme...
2. async/await : des promesses plus simples au niveau syntaxique (mais moins puissantes) 
   
   • Exemples fait en classe en live coding : https://jsbin.com/xoboneb/edit?js,console
      
3. Requêtes Ajax : de XmlHttpRequest à fetch,  la fetch API 
   
   • Exemples fait en classe en live coding :

Rappels sur les Web Services REST

Supports de cours :

1. Les bonnes pratiques pour créer une API REST: https://blog.octo.com/designer-une-api-rest/ (note : en cours on verra comme gérer les uploads de fichiers via des WS)

2. On peut tester des appels Ajax avec des "Fake REST APis" comme https://jsonplaceholder.typicode.com/
3. On testera des APIs REST avec un outil comme l'extension Google Chrome Postman 

Exercice à faire :

1. Créez votre propre "fake API" en mettant un fichier JSON finissant par .db sur un de vos repositories github. Vous lirez la documentation de https://my-json-server.typicode.com pour y arriver.
   Exemple ici https://my-json-server.typicode.com/micbuffa/hobbies/db

On commence l'étude de NodeJS 

Support de cours :

1. Transparents de présentation de NodeJS 
2. Transparents de présentation de Express 
3. Livres à demander au prof pour ceux qui sont déjà à l'aise avec NodeJS.

Exercice à faire :

1.  Récupérez cette archive, dezippez là quelque part, avec la ligne de commande, faites cd dans le répertoire TP_ROUTAGE_EXPRESS_CRUD_AJAX créé, et exécutez la commande "npm install".
   
   Ceci devrait créer un sous directory node_modules contenant les modules nécessaires (dans notre cas: express et multer).
    
2. Suivez les consignes du prof et les explications au tableau.

Exemple de code NodeJS pour faire le CRUD sur une base MongoDB

1. Récupérez cette archive qui est une version modifiée de l'exercice précédent: TPRoutageExpressWithMongo3.zip 
    
2.  Dezipper, allez dans le répertoire créé (TPRoutageExpressWithMongo3) et faites "npm install"
    
3. Exécutez node serverCrudWithMongo (ou nodemon)
    
4. Ouvrez localhost:8080
   

5. Etudiez le code, regardez en particulier comment, quand on clique sur le premier bouton GET AJAX un tableau est construit dynamiquement. 

Ajouter le support "cross domain" à votre projet node/MongoDB

Ajouter les lignes suivantes dans la configuration de votre serveur (fichier serverCrudWithMongo.js), ça se passe dans la configuration de express, c'est l'équivalent des "Servlet Filters" en JavaEE :

app.use(function (req, res, next) {
    res.header("Access-Control-Allow-Origin", "*");
    res.header("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
    res.header("Access-Control-Allow-Methods", "POST, GET, OPTIONS, PUT, DELETE");

    next();
});

Note : vous pouvez également utiliser un des nombreux modules npm pour ajouter à votre projet le support cross-domain, par exemple le module cors. Notez bien qu'on va écrire presqu'autant de lignes de code qu'en le faisant à la main.

Introduction à React

Supports de cours :

• SupportsDeCoursReactRedux.zip

Si on va voir la page de facebook sur "how to start with React", il y a un chapitre qui concerne le mode "CLI": https://reactjs.org/docs/add-react-to-a-new-app.html

1. Vous devez avoir nodeJS correctement installé (node, npm, etc, tout ceci doit fonctionner...)
    
2. Installez l'extension Google Chrome "React Developer Tools" (https://chrome.google.com/webstore/d...jfkapdkoienihi), elle existe aussi pour Firefox.
    
3. Installez une bonne fenêtre terminal pour Windows -si vous êtes sous windows comme http://cmder.net/ ou autre (github bash, etc.) si je vous vois avec une fenêtre DOS basique vous allez m'entendre !
    
4. Installer les packages "babel" et "emmet" si vous êtres sous Sublime Text 3 ou Atom. Ca doit etre ok pour Visual Studio Code, WebStorm etc.
    
5. Ouvrir la ligne de commande et exécuter la commande "npm install -g create-react-app",
   • Pour vérifier que ça fonctionne, créez un autre répertoire nommé "react_cli" et cd dedans,
   • Executez "create-react-app hello-world" (ça prend du temps, quelques minutes)...
   • Allez dans le répertoire créé (cd hello-world), et faites "npm install" (là aussi, quelques minutes)
   • Exécutez le programme en tapant "npm start", ça doit ouvrir automatiquement le browser sur le port 3000 et afficher une page avec le logo React qui tourne.
   • Editez le code du fichier src/App.js, changez le texte et sauvez -> la page Web de l'application doit se rafraichir automatiquement.
      
6. Maintenant on va étudier le code, regardez les fichiers html, js, les configs etc.
    
7. Essayez de modifier la partie "render" de App.js... hmmm ok. Bon, on va faire un simple composant <Username name="toto"/> qu'on va mettre dans un sous répertoire "components" dans les sources, il va simplement afficher un nom passé en attribut/props dans un paragraphe en couleur. Vous ajouterez dans <App/> Plusieurs instances de ce composant.

Exercice: refaire dans le projet les hobbies en mode CLI !

• Ici correction (inclut fetch)  (désarchiver, cd dans le repertoire, npm install, npm start)

Exercice: afficher les restaurants avec un fetch, en mode CLI !

 

Exercice à faire pour la prochaine fois : utiliser un outil pour générer la documentation HTML de vos API REST

• A vous de choisir : 
  • Apidoc js (le plus simple) : https://www.supinfo.com/articles/single/8405-apidoc-outil-generation-documentation-application, vori aussi https://apidocjs.com/example/
  • Solutions basées sur swagger (swagger.io) qui est un outil très puissant de conception d'APIs. Mais il existe des modules npm qui mélangent swagger et jsdoc un standard pour faire des commentaires augmentés. Voir https://www.npmjs.com/package/swagger-jsdoc