Master 2 INTENSE 2019-2020 : Frameworks JavaScript et Server-Side JavaScript BD NoSQL Cloud etc.

Avoir une vue de l'écosystème JavaScript (sites vus en cours)

• https://risingstars.js.org/2018/en/
• https://2018.stateofjs.com/introduction/
• Visual Studio code dans browser pour projets React, Angular...

Introduction à React

Supports de cours :

• SupportsDeCoursReactRedux.zip

A FAIRE POUR SEANCE SUIVANTE :

• Regarder le livre sur React (celui sur les bases)
• Regarder https://material-ui.com le site de la librairie de composants graphiques pour react la plus populaire. Ici un livre pour démarrer .
• Essayer d'inclure cette librairie dans votre projet CLI et utiliser quelques composants graphiques pour le rendu.

1 - installation (si ce n'est pas déjà fait) de MongoDB  et d'un outil d'administration

Nous allons poursuivre le cours en gérant maintenant un Back-End NoSQL, en l'occurence une base MongoDB, que nous utiliserons indifféremment localement ou dans le cloud.

Pour vérifier que vous avez bien installé MongoDB:

1. Ouvrir une fenêtre de terminal et taper la commande "mongod"
   • Si tout va bien, cela devrait afficher une liste de traces et ne pas rendre la main. Bravo, MongoDB est correctement installé.
   • Si vous avez "command not found", vérifiez que 1) vous avez déjà installé MongoDB et 2) que votre variable PATH est correctement positionnée.
     • Si vous n'avez pas installé MongoDB : suivez ce guide d'installation.
        
2. Lancez un outil d'administration (peu importe celui que vous utilisez, l'outil officiel MongoDB Compass, ou un outil comme Studio 3T, ou un autre...)
3. Vérifiez que vous avez encore la base de données de test des restaurants de l'année dernière, on va l'utiliser pour le TP... si ce n'est pas le cas, voici le fichier à importer: primer-dataset.json 
   
   Commande pour importer : 

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

     
     

2 - Exemple de client de ces WebServices, en pur HTML/CSS/JS et utilisation de l'API fetch

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. 

3 - 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();
});

4 - Heberger la base Mongo dans le cloud sur https://cloud.mongodb.com et modifier votre programme

1. Allez sur cloud.mongodb.com et ouvrez un compte
2. Suivez les instructions pour créer un cluster gratuit
3. Suivez les instructions du prof (user admin/admin, autoriser tout le monde, etc.)
4. Importez des données d'exemple (menu déroulant)
5. Une fois le cluster créé, dans le menu déroulant, utiliser "command line tools" et regardez comment importer une base JSON
6. Vous importerez en ligne de commande la base primer-dataset.json
7. Lancez l'outil d'administration de MongoDB (atlas) et connectez-vous sur le cluster que vous venez de créér
8. Regardez aussi à partir de la page "command line tools" comment vous connecter depuis votre application. 
9. Modifier le programme précédent (partie app-modules/crud-mongo.js) pour utiliser maintenant la BD située dans le cloud, sur mlabs.com. Attention vous devrez sans doute ouvrir un VPN ou utiliser votre téléphone en partgae de connexion car mlabs expose les BDs sur un port qui ne passe pas par unice-hotspot ou eduroam.
10. Comment faire pour que votre programme travaille indifféremment sur cloud.mongodb.com ou en local sans le modifier ?

4 - quelques rappels sur les Promesses et async/await

• Introduction rapide aux "promesses de JavaScript" et à "async/await" 
• Comparaison codage avec callbacks et promesses dans node/express/mongodb et avec async/await
  • Regardez comment est codé le web service /api/restaurants en GET et la méthode findRestaurants dans crud-mongo.js par rapport aux autres, dans cette archive.

6  - A RENDRE POUR SEANCE SUIVANTE. Noté : développer un client qui fait le CRUD sur les restaurants, mais en React

Vous allez créer un autre projet react, dans un autre répertoire, à l'aide de la commande create-react-app.

Aide : refaire quelque chose de ce genre (ici en VueJS), mais avec React. Vous pourrez regarder les différents appels CRUD effectués à l'aide de la fetch API, que vous réutiliserez dans votre code React

1. Récupérez cette archive 
2. Dezippez-là
3. Allez dans le répertoire et faites "npm install"
4. Assurez-vous que MongoDB tourne (lancer mongod dans une fenêtre si ce n'est pas le cas)
5. Exécutez "node serverCrudWithMongo.js"
6. Ouvrez localhost:8080/tableVue.html
7. Testez les fonctionnalités
8. Regardez le code de tableVue.html pour une application VueJS assez "classique" réalisée sans utiliser le mode CLI de VueJS.

Démarrer le codage du client React : vous commencerez pas simplement afficher des restaurants dans une table. Peu importe si ce n'est pas joli... En vous inspirant du TP de la séance prtécédente sur les Hobbies, vous devriez y arriver sans problèmes.

On utilisera un tableau de restaurants dans le "state" de React en s'inspirant des exemples vus précédemment avec les hobbies. On utilisera la méthode componentDidMount() pour faire un fetch sur les restaurants avant l'affichage du composant principal (voit cycle de vie des composants React):

componentDidMount() {
    console.log("Composant avant premier affichage")
    // ici aller chercher des données dans une source de données (ex: GET /api/restaurants)
  }

Si vous avez récupéré le livre recommandé au début de cette section, il y a un chapitre qui s'intitule "Aller chercher les données" qui montre des exemples d'utilisation de fetch en React.

1 : création d'une application "squelette"

1. Installer angular-cli : dans une fenêtre de terminal, tapez la commande "npm install -g @angular/cli" (éventuellement avec "sudo" avant si vous êtes sous Linux ou Mac OS)

2. Créez un répertoire "exo1Angular" et faites cd dans ce répertoire,
3. Générez une application "squelette" angular en tapant la commande "ng new angular-framework-intro"
4. Faites cd angular-framework-intro et ouvrez visual studio code sur ce répertoire (commande "code ." sur Mac)
5. Faites npm install pour installer les modules nécessaires (pour l'application et pour l'environnement de développement)
6. Exécutez le projet en lançant la commande ng serve --open dans le répertoire
7. Ok, maintenant faites "view source" sur la page, que remarquez-vous ? Comparez avec React et VueJS... Qu'en déduisez-vous ? A propos, est-ce qu'on a installé une extension dans le browser ?
8. Etudions maintenant la structure du projet....

2 : affichage d'une liste d'éléments

1. Regardez le fichier index.html, remarquez l'élément <app-root></app-root>, est-ce du HTML standard ?
2. Regardez les fichiers src/app.component.ts, src/app.component.html et src/app.component.css
3. Modifiez le fichier de templates app.components.html et faites ctrl-s,
4. Regardez le fichier app.module.ts, Angular va vous obliger à mettre à jour ce fichier très régulièrement.
5. Maintenant on va effacer le contenu du fichier de template, et on va essayer d'afficher une liste d'éléments : CA SE PASSE EN LIVE CODING (une correction sera postée ici à la fin), utilisation de *ngFor (<li *ngFor="let el of elements">...</li> si elements est la propriété du composant -un tableau de chaines de caractères-), un peu l'équivalent du v-for de VueJS.
6. Ajout d'un bouton pour ajouter un nouvel élément, utilisation de (click)="expression" comme attribut,
7. Regardons comment afficher une ligne verte, une ligne rouge, etc. Utilisation de [ngStyle]="{propriété CSS : expression}", écrire une fonction getColor(element) comme dans les exemples qu'on avait fait avec VueJS et React, et l'appeler dans l'expression).

3 : création d'un nouveau composant

• On va créer "manuellement" un nouveau composant intitulé "username", qui sera juste un<li> qui affichera la valeur de la propriété username. Pour cela, créer le fichier "app/username.component.ts, et il doit ressembler à cela.
  REMARQUE: vous pouvez utiliser la ligne de commande pour ajouter un nouveau composant: 
  
  > ng generate component username

import { Component, Input } from "@angular/core";

@Component ({
    selector: 'app-username',
    template:`
    <p>{{username}}</p>
    `
})

export class UsernameComponent {
    @Input() username :string;
}

Remarquez qu'on n'a pas utilisé ici de template html séparé, à la place on a mis le template directement sous forme de chaine de caractère entre les caractères `....`

Le @Input sert à définir une propriété qu'on pourra passer via des attributs HTML, c'est l'équivalent des "props" de VueJS et de React.

Maintenant, ajoutez des instances de ce composant dans le template app.components.html:

<app-username [username]="'Michel'"></app-username>

<app-username [username]="'John'"></app-username>

Regardez ce que cela donne.... 

Regardez aussi le fichier app.module.ts, le composant a été ajouté dans la liste des composants par la commande ng add component username.

Maintenant on veut pouvoir cliquer sur un nom et afficher un message dans le template du composant principal. On va faire comme en VueJS : envoyer un événement quand on clique sur le nom.

4 : définition d'un événement qui sera envoyé du composant "fils" vers le composant "père"

1. Dans le composant (app/username/username.component.ts), définir un événement comme ceci: 

export class UsernameComponent {
    @Input() username :string;
    @Output() userClicked = new EventEmitter<string>(); // définition d'un événement

    onUsernameClicked() {
        this.userClicked.emit(this.username);            // émission de l'événément
    }
}

Et dans le template (app/username/username.component.ts) :

    template:`
       <p (click)="onUsernameClicked()">{{username}}</p>
    `

Ainsi, dans le template du composant (app.component.html) qui instancie ce composant, on pourra écouter l'événement "userClicked" :

<app-username [username]="'Michel1'" (userClicked)="onUserWasClicked($event)"></app-username>
<app-username [username]="'John'"    (userClicked)="onUserWasClicked($event)"></app-username>

Et maintenant on peut écrire la méthode onUserWasClicked(username) dans app.component.ts :

onUserWasClicked(username: string) {
    alert(username);
}

Testez l'application : en cliquant sur un nom, ça doit afficher une alerte avec la valeur associée.

5 : binding bi-directionnel avec [(ngModel)]="nom"

• Définissez un champs de saisie dans le template pour une propriété "nom" que vous ajouterez dans le fichier .ts de app.component.ts
• Dans le template, affichez la valeur de cette propriété en-dessous du champs de saisie. 
• Tapez quelque chose dans le champ de saisie
• Plus simple qu'en React non ? Ca ressemble au v-model de VueJS non ?

ICI UNE CORRECTION DES ETAPES PRECEDENTES (exemple fait en live). Dezippez, cd dans le repertoire, npm install puis ng serve --open

6 : Completer l'exemple des hobbies complet, mais en angular

 En vous aidant de l'exemple précédent :  

1. Ajouter un compteur de hobbies (<p>Nombre de Hobbies: ...</p>) au-dessus de la liste des hobbies
    
2. Changez le style CSS du compteur, selon sa valeur: vert si moins de 3 hobbies, rouge sinon
    
3. Transformez les éléments <li> en un composant réutilisable <app-hobby>
    
4. On veut remplir les hobbies au démarrage de l'application en récupérant les hobbies au format JSON sur l'URL : https://my-json-server.typicode.com/...ffa/hobbies/db (au passage, j'ai utilisé les services de jsonplaceholder.typicode.com pour servir un fichier json qui se trouve sur un de mes repository github). LIVE CODING AVEC LE PROF pour voir comment créer un service
   • Commande pour créer un service : "ng generate service hobby" (va créer le fichier hobby.service.ts et le fichier pour les tests)
   • Pour aller récupérer le JSON des hobbies sur le WebService on va utiliser une méthode "simple" (angular propose aussi des méthodes plus complexes permettant de typer les données lorsqu'elles arrivent):
     • Importez le module HttpClient en ajoutant "import { HttpClient } from "@angular/common/http";" en haut de votre fichier hobby.service.ts
     • Modifiez le code de la classe du service comme suit :
       
       
       export class HobbyService {

         constructor(private http: HttpClient) {}

         private url = "https://my-json-server.typicode.com/...ffa/hobbies/db";

       
       

         getHobbies(): Promise<any> {

           // on va chercher par GET le fichier JSON sur un REST endpoint

           return this.http.get(this.url).toPromise();

         }

       }
     • Modifiez le fichier app.module.ts pour rajouter le module "HttpClient" à l'application: import { HttpClientModule } from "@angular/common/http";
       
       import { HobbyService } from "./hobby.service";
       et ajoutez aussi le service HobbyService et ml module HttpClient e aussi à la directive @NgModule:
       
       
       
       @NgModule({

         declarations: [AppComponent, UsernameComponent],

         imports: [BrowserModule, FormsModule, HttpClientModule],

         providers: [HobbyService],

         bootstrap: [AppComponent]

       })
        
     • Enfin, dans le composant principal app.component.ts, qui affiche les hobbies, il faut aussi importer HobbyService:
       
       import { HobbyService } from './hobby.service';
       
       "Injecter le service" via le constructeur :
       

       // On "injecte le service" qui servira par la suite à

         // récupérer des données sur le Web

         constructor(private hobbyService: HobbyService) {}
       
       Indiquer qu'on va charger les hobbies avant d'afficher la liste :
       

       // Appelé lorsque le composant est créé

         ngOnInit(): void {

           this.getHobbies();

         }

       
       et voici la méthode getHobbies() qui utilise le service, l'ajouter aussi au fichier

       getHobbies() {

           this.hobbyService.getHobbies().then(response => {

             this.hobbies = response.data;

           });
     •  
   • Correction de cet exercice
      
5. Exercice à faire : afficher les restaurants de votre base MongoDB (juste les noms pour commencer) à la place des hobbies...
   • Si vous avez des soucis de cross origin,  ajouter ces lignes dans le fichier serverCrodWithMongo.js d'un des TPs précédents, après les autres lignes de la configuration express qui font des app.use...
   • // Pour autoriser le cross origin

     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();

     });