Dans les didacticiels précédents, vous auriez vu des fonctions de rappel utilisées pour les événements asynchrones. Mais parfois, les fonctions de rappel peuvent devenir un cauchemar lorsqu'elles commencent à être imbriquées et que le programme commence à devenir long et complexe.
Dans ce didacticiel, vous apprendrez-
- Que sont les promesses?
- Rappels aux promesses
- Gérer les promesses imbriquées
- Créer une promesse personnalisée
Que sont les promesses?
Avant de commencer avec les promesses, revoyons d'abord ce que sont les fonctions de "rappel" dans Node.js. Nous avons beaucoup vu ces fonctions de rappel dans les chapitres précédents, alors passons rapidement en revue l'une d'entre elles.
L'exemple ci-dessous montre un extrait de code, qui est utilisé pour se connecter à une base de données MongoDB et effectuer une opération de mise à jour sur l'un des enregistrements de la base de données.
-
Dans le code ci-dessus, la partie de la fonction (err, db) est connue sous le nom de déclaration d'une fonction anonyme ou de rappel. Lorsque MongoClient crée une connexion à la base de données MongoDB, il reviendra à la fonction de rappel une fois l'opération de connexion terminée. Donc, dans un sens, les opérations de connexion se produisent en arrière-plan, et quand cela est fait, cela appelle notre fonction de rappel. N'oubliez pas que c'est l'un des points clés de Node.js pour permettre à de nombreuses opérations de se dérouler simultanément et ainsi ne pas empêcher un utilisateur d'effectuer une opération.
-
Le deuxième bloc de code est ce qui est exécuté lorsque la fonction de rappel est effectivement appelée. La fonction de rappel ne met à jour qu'un seul enregistrement dans notre base de données MongoDB.
Alors, qu'est-ce qu'une promesse? Eh bien, une promesse n'est qu'une amélioration des fonctions de rappel dans Node.js. Au cours du cycle de vie du développement, il peut y avoir une instance dans laquelle vous devrez imbriquer plusieurs fonctions de rappel ensemble. Cela peut devenir un peu compliqué et difficile à entretenir à un moment donné. En bref, une promesse est une amélioration des rappels qui vise à atténuer ces problèmes.
La syntaxe de base d'une promesse est présentée ci-dessous;
var promise = doSomethingAync()promise.then(onFulfilled, onRejected)
- "doSomethingAync" est une fonction de rappel ou asynchrone qui effectue une sorte de traitement.
- Cette fois, lors de la définition du rappel, il y a une valeur qui est renvoyée appelée «promesse».
- Lorsqu'une promesse est renvoyée, elle peut avoir 2 sorties. Ceci est défini par la «clause alors». Soit l'opération peut être un succès, ce qui est indiqué par le paramètre «onFulfilled». Ou il peut avoir une erreur qui est indiquée par le paramètre «onRejected».
Remarque: l'aspect clé d'une promesse est donc la valeur de retour. Il n'y a pas de concept de valeur de retour lorsque vous travaillez avec des rappels normaux dans Node.js. En raison de la valeur de retour, nous avons plus de contrôle sur la façon dont la fonction de rappel peut être définie.
Dans la rubrique suivante, nous verrons un exemple de promesses et comment elles bénéficient des rappels.
Rappels aux promesses
Regardons maintenant un exemple de la façon dont nous pouvons utiliser des «promesses» à partir d'une application Node.js. Afin d'utiliser les promesses dans une application Node.js, le module 'promise' doit d'abord être téléchargé et installé.
Nous modifierons ensuite notre code comme indiqué ci-dessous, ce qui met à jour un nom d'employé dans la collection «Employé» en utilisant des promesses.
Étape 1) Installation des modules NPM
Pour utiliser Promises à partir d'une application Node JS, le module Promises est requis. Pour installer le module de promesse, exécutez la commande ci-dessous
promesse d'installation npm
Étape 2) Modifiez le code pour inclure les promesses
var Promise = require('promise');var MongoClient = require('mongodb').MongoClient;var url = 'mongodb://localhost/EmployeeDB';MongoClient.connect(url).then(function(err, db) {db.collection('Employee').updateOne({"EmployeeName": "Martin"}, {$set: {"EmployeeName": "Mohan"}});});
Explication du code: -
- La première partie est d'inclure le module «promesse» qui nous permettra d'utiliser la fonctionnalité de promesse dans notre code.
- Nous pouvons maintenant ajouter la fonction «alors» à notre fonction MongoClient.connect. Donc, ce que cela fait, c'est que lorsque la connexion est établie à la base de données, nous devons exécuter l'extrait de code défini par la suite.
- Enfin, nous définissons notre extrait de code qui effectue le travail de mise à jour de EmployeeName de l'employé avec le nom de "Martin" en "Mohan".
Noter:-
Si vous vérifiez maintenant le contenu de votre base de données MongoDB, vous constaterez que si un enregistrement avec EmployeeName de «Martin» existe, il sera mis à jour en «Mohan».
Pour vérifier que les données ont été correctement insérées dans la base de données, vous devez exécuter les commandes suivantes dans MongoDB
- Utiliser EmployeeDB
- db.Employee.find ({EmployeeName: Mohan})
La première instruction garantit que vous êtes connecté à la base de données EmployeeDb. La deuxième instruction recherche l'enregistrement dont le nom d'employé est "Mohan".
Gérer les promesses imbriquées
Lors de la définition des promesses, il faut noter que la méthode «alors» elle-même renvoie une promesse. Donc, dans un sens, les promesses peuvent être imbriquées ou enchaînées les unes aux autres.
Dans l'exemple ci-dessous, nous utilisons le chaînage pour définir 2 fonctions de rappel, qui insèrent toutes deux un enregistrement dans la base de données MongoDB.
( Remarque : le chaînage est un concept utilisé pour lier l'exécution de méthodes l'une à l'autre. Supposons que votre application dispose de 2 méthodes appelées «méthodeA» et «méthodeB». Et la logique était telle que «méthodeB» devrait être appelée après «méthodeA», alors vous enchaîneriez l'exécution de telle manière que 'methodB' soit appelé directement après 'methodA'.)
La chose clé à noter dans cet exemple est que le code devient plus propre, lisible et maintenable en utilisant des promesses imbriquées.
var Promise = require('promise');var MongoClient = require('mongodb').MongoClient;var url = 'mongodb://localhost/EmployeeDB';MongoClient.connect(url).then(function(db) {db.collection('Employee').insertOne({Employeeid: 4,EmployeeName: "NewEmployee"}).then(function(db1) {db1.collection('Employee').insertOne({Employeeid: 5,EmployeeName: "NewEmployee1"})})});
Explication du code: -
- Nous définissons maintenant 2 clauses "alors" qui sont exécutées l'une après l'autre. Dans la première clause then, nous transmettons le paramètre 'db' qui contient notre connexion à la base de données. Nous utilisons alors la propriété collection de la connexion 'db' pour insérer des enregistrements dans la collection 'Employee'. La méthode 'insertOne' est utilisée pour insérer le document réel dans la collection Employee.
- Nous utilisons alors la clause 2 nd then pour insérer également un autre enregistrement dans la base de données.
Si vous vérifiez maintenant le contenu de votre base de données MongoDB, vous trouverez les 2 enregistrements insérés dans la base de données MongoDB.
Créer une promesse personnalisée
Une promesse personnalisée peut être créée à l'aide d'un module de nœud appelé «q». La bibliothèque 'q' doit être téléchargée et installée à l'aide du gestionnaire de packages de nœuds. Après avoir utilisé la bibliothèque 'q', la méthode "denodeify" peut être appelée, ce qui fera de n'importe quelle fonction une fonction qui renvoie une promesse.
Dans l'exemple ci-dessous, nous allons créer une fonction simple appelée "Ajouter" qui ajoutera 2 nombres. Nous allons convertir cette fonction en fonction pour renvoyer une promesse.
Une fois que cela est fait, nous utiliserons la promesse retournée par la fonction Add pour afficher un message dans le console.log.
Suivons les étapes ci-dessous pour créer notre fonction personnalisée pour renvoyer une promesse.
Étape 1) Installation des modules NPM
Pour utiliser 'q' depuis une application Node JS, le module 'q' est requis. Pour installer le module 'q', exécutez la commande ci-dessous
npm installer q
Étape 2) Définissez le code suivant qui sera utilisé pour créer la promesse personnalisée.
Explication du code: -
- Le premier bit consiste à inclure la bibliothèque 'q' en utilisant le mot clé require. En utilisant cette bibliothèque, nous pourrons définir n'importe quelle fonction pour renvoyer un rappel.
- Nous créons une fonction appelée Add qui ajoutera 2 nombres définis dans les variables a et b. La somme de ces valeurs sera stockée dans la variable c.
- Nous utilisons alors la bibliothèque q pour dénodifier (la méthode utilisée pour convertir n'importe quelle fonction en une fonction qui renverrait une promesse) notre fonction Add ou pour convertir autrement notre fonction Add en une fonction qui renvoie une promesse.
- Nous appelons maintenant notre fonction "Ajouter" et sommes capables d'obtenir une valeur de promesse de retour en raison de l'étape précédente que nous avons effectuée pour dénodifier la fonction Ajouter.
- Le mot-clé 'then' est utilisé pour spécifier que si la fonction est exécutée avec succès, afficher la chaîne "Addition fonction terminée" dans le console.log.
Lorsque le code ci-dessus est exécuté, la sortie "Fonction d'ajout terminée" sera affichée dans console.log comme indiqué ci-dessous.
Résumé
- L'utilisation des fonctions de rappel dans Node.js a ses inconvénients. Parfois, au cours du processus de développement, l'utilisation imbriquée des fonctions de rappel peut rendre le code plus compliqué et difficile à maintenir.
- La plupart des problèmes liés aux fonctions de rappel imbriquées peuvent être atténués avec l'utilisation de promesses et de générateurs dans node.js
- Une promesse est une valeur renvoyée par une fonction asynchrone pour indiquer l'achèvement du traitement effectué par la fonction asynchrone.
- Les promesses peuvent être imbriquées les unes dans les autres pour rendre le code meilleur et plus facile à gérer lorsqu'une fonction asynchrone doit être appelée après une autre fonction asynchrone