Introduction à Sequelize [Picasoft]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu’il s’agit d’une erreur.
====== Introduction à Sequelize ======


Sequelize est un ORM ([[https://en.wikipedia.org/wiki/Object-relational_mapping | Object-relational mapping]]) SQL basé sur les [[https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise | promesses ]]. 

=== Notion d'ORM ===
Un ORM permet de faire le lien entre les bases de données relationnelles et l'approche orientée objet. Souvent, sur un [[https://bdd.librecours.net/module/gen1/pri1c12.xhtml | système de gestion de bases de données]] (SGBD), on peut stocker et manipuler seulement des valeurs scalaires (entiers, chaînes de caractères...). Celles-ci sont organisées sous forme de tables. On ne peut (normalement) pas avoir de tables imbriquées. À l'inverse, dans la programmation orientée objet, un objet peut être composé d'autres objets. Par exemple, un objet ''Carnet d'adresses'' contient des objets ''Personne'' qui contiennent eux mêmes des objets ''Numéro de téléphone''.

Un ORM servira donc à convertir un objet en un groupe de valeurs scalaires, pour le stockage dans une base de données relationnelle. Il permettra aussi de faire l'opération inverse.

=== Notion de promesse en JavaScript ===

Les promesses sont de moins en moins utilisées [[ https://hackernoon.com/6-reasons-why-javascripts-async-await-blows-promises-away-tutorial-c7ec10518dd9 | au profit de //async/await//]], mais elles sont encore utilisées dans le code de PeerTube, ainsi que par Sequelize.

Extrait du [[ https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise | MDN ]]:

> L'objet ''Promise'' (pour « promesse ») est utilisé pour réaliser des traitements de façon asynchrone. Une promesse représente une valeur qui peut être disponible maintenant, dans le futur, voire jamais.

Les promesses sont souvent utilisées lors des appels à une API. Imaginons qu'on fasse trois requêtes et que pour chacune on ait besoin du résultat de la précédente. On pourrait traiter cela avec des fonctions imbriquées, mais ça deviendrait vite compliqué et difficile à maintenir. Les promesses permettent d'avoir une syntaxe plus simple, en utilisant une chaîne de promesses. 

  * Chaque tâche retourne un objet ''promise''
  * Chaque objet ''promise'' possède une méthode ''then'' qui peut prendre deux autres fonctions en arguments : un gestionnaire de succès et un gestionnaire d'erreur.
  * Un seul des gestionnaires sera appelé lorsque la tâche sera terminée. S'il retourne une valeur, celle-ci sera passée en argument à la fonction suivante dans la chaîne.
  * La méthode ''then'' retournera à son tour un objet ''promise''.

Pour illustrer ceci, voici un exemple tiré du [[ https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise | MDN ]]:
<code>
doSomething().then(function(result) {
  return doSomethingElse(result);
})
.then(function(newResult) {
  return doThirdThing(newResult);
})
.then(function(finalResult) {
  console.log('Got the final result: ' + finalResult);
})
.then(null, failureCallback);
</code>

La fonction ''doSomething()'' retourne ''result'', qui est passé en argument à ''doSomethingElse'', qui à son tour retournera ''newResult'', et ainsi de suite.

Dans le code de PeerTube, une syntaxe plus compacte est utilisée : les [[ https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Fonctions/Fonctions_fl%C3%A9ch%C3%A9es | fonctions fléchées]].

Voici la version compacte du code ci-dessus:
<code>
doSomething()
.then(result => doSomethingElse(result))
.then(newResult => doThirdThing(newResult))
.then(finalResult => {
  console.log(`Got the final result: ${finalResult}`);
})
.catch(failureCallback);
</code>


=== Liens utiles ===
[[ https://stackoverflow.com/questions/3884281/what-does-the-function-then-mean-in-javascript#31453579 | Explication du fonctionnement des promesses ]]\\
[[ https://developer.mozilla.org/fr/docs/Learn/JavaScript/Objects/Basics | Les objets en JavaScript ]]. La syntaxe d'une classe en JavaScript peut être un peu confuse pour ceux qui sont habitués au C++, mais [[https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/Object-oriented_JS#A_simple_example | cet exemple]] permet de la comprendre rapidement.