Node.js

Introduction

NodeJS est une technologie qui permet d'utiliser du JavaScript côté serveur. Il est écrit en language C.


Fonctionnement

Permet d'utiliser du script asynchrone (≠ scripts bloquants). Serveur NodeJS

Plusieurs scripts sont executés en même temps pendant l'attente de la réponse. Continue la suite du code, et ajoute le code à executer dans une queue d'évènement (event queue). Serveur NodeJS

Inconvénients

  • Code non-bloquant : toujours développer du code non-bloquant (I/O model) pour profiter du système asynchrone
  • Single Thread : ne pas demander des calculs trop compliqué pour ne pas bloquer le thread. Une solution est le Child process, qui permet d'optimiser du code simplement.
  • Code de bas niveau

Avantages

  • Très performants, permet de faire beaucoup de traitments en simultannée
  • Multi-platforme
  • Un seul langage côté client et serveur
  • Gestionnaire de paquets: npm
  • Grande communauté

Installation

Avec un navigateur : Aller sur le site web de NodeJS et télécharger la dernière version.

Avec Homebrew : brew install node

Pour vérifier l'installation : node --version

L'installeur NodeJS installe aussi le Gestionnaires de paquets NPM.

Documentation :


Modules NodeJS

Installer un module npm i -s module.

Appeler le module au début du fichier si besoin const module = require('module');.

Liste des modules de base disponibles les plus utilisés

  • Node bindings
    • http : permet de lancer un serveur SSL
    • file system : permet d'accéder au système de fichiers sous-jacent
    • path : permet de gérer le chemin du système d'exploitation
    • os : permet d'interagir avec le système d'exploitation.
    • socket
  • moteur V8
  • thread pool (libeio)
  • event loop (libev)
  • crypto (OpenSSL)
  • DNS (c-ares)

http

  • http.createServer(function(req, res) {}) :

    • req
      • req.url : donne accès à l'URL appelé par le client. Si c'est http://localhost:3000, req.url contains the value / or the root path.
      • req.method : méthode HTTP de la requête en cours (get, post, delete).
      • req.headers : objet contenant les en-têtes de la requête comme Content-Type, Authorization, etc.
      • ...
    • res
      • res.setHeader() : définit les meta-données de la réponse
      • res.write() : écris sur la page
      • res.end() : termine la requête
      • ...

Créer un serveur

How to create a NodeJS server from scratch

Exemple de server basique

  1. Créer un serveur NodeJS

Créer un fichier pour le serveur node. Le fichier peut avoir n'importe quel nom mais pas convention on utilise index.js, server.js ou app.js.

Pour exécuter le script serveur: node <nom-fichier.js>

Pour créer un serveur on va utiliser le module http avec la méthode createServer();.

La méthode renvoit une instance http.Server. Cette instance contient des méthodes tel que (listen, set, close...) et des évènements (request, connection, close...) (voir liste complète).

Les évènements sont écoutées avec la méthode on() server.on('type', function(request, response) {} )

request est de type http.IncomingMessage et la response http.ServerResponse.

Il reste à déinir le port d'écoute: server.listen(8080);

server.js

var http = require('http');

var server = http.createServer();

server.on('request', function(req, res) {
  console.log('Il y a eut une requête.');
});

server.listen(8080);

En lançant le script server.js on s'appercoit que le server mouline car il manque le status de la réponse.


Gestionnaire de paquets

NPM

NPM est un gestionnaire de paquets qui permet de télécharger des modules dont on a besoin.

Pour initialiser votre projet npm init.

Installer un module : npm i -S <nom_module>

Dans le package.json :

^1.0.0 les versions 1.x.x peuvent être télécharger.

~1.0.0 les versions 1.0.x peuvent être télécharger.

⚠ Sur mon poste lancer cette commande pour utiliser npm: source ~/.bashrc

Yarn

Yarn est un gestionnaire de modules plus rapide que NPM mais il doit être utilisé avec celui-ci.

Installer Yarn avec NPM :

npm install -g yarn

ou avec un script bash :

curl -o- -L https://yarnpkg.com/install.sh | bash

Ajouter une dépendance :

yarn add <packagename>

Ajouter une dev dépendance :

yarn add --dev <packagename>

Enlever une dépendance :

yarn remove <packagename>

Comparaisons des gestionnaires

https://medium.com/s/silicon-satire/i-peeked-into-my-node-modules-directory-and-you-wont-believe-what-happened-next-b89f63d21558


ExpressJS

Définition

ExpressJS est une librairie qui permet de créer une application Web plus facilement qu'avec le module NodeJS de base http. Elle fournit un ensemble de méthode permettant de traiter les requêtes HTTP.

Installation

npm i -S express

Middlewares

Les middlewares permettent d'effectuer un traitement pendant que la requête est en cours. Express permet de créer des middlewares en utilisant app.use().

On trouvera de nombreux middleware disponible sur NPM comme par exemple body-parser permettant de gérer les données postées par un formulaire.

// ....
let bodyParser = require('body-parser')

app.use('/assets', express.static('public')) // Gestion des fichiers statiques
app.use(bodyParser.urlencoded({ extended: false })) 
app.use(bodyParser.json())

// Nos routes...

app.use() prend une fonction qui a 3 paramètres : request object, response object et une fonction spéciale next().

next() est une fonction que nous appelons pour que la requête poursuit au prochain middleware.

const express = require('express');

const app = express();
app.use((req, res, next) => {
    console.log('In the middleware!')
    next();
})

app.use((req, res, next) => {
    console.log('In another middleware!')
    res.send('<h1>Hello from Express</h1>')
})

app.listen(3000)

Routes

ExpressJS se présente comme un routeur où l'on va déclarer les routes supportées par notre application ainsi que le traitement à effectuer lorsque cette dernière est rencontrée.

let express = require('express')
let app = express()

app.get('/', (request, response) => {
  response.send('Bonjour')
})
app.post('/', (request, response) => {
    // Traitement des données
})

app.listen(8080)

Important ! La route racine / doit être déclaré en dernier sinon elle attrape toutes les requêtes avant d'atteindre les autres routes déclaré en-dessous.


NVM

Définition

Node Version Manager est un script bash qui permet de télécharger et gérer les différentes versions de Node.

Installation

Github

    curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.5/install.sh | bash

Usage

Alias :

  • node: installe la dernière version de node
  • iojs: installe la dernière version de io.js

Pour télécharger, compiler et installer node :

# latest version
nvm install node

# specific version
nvm install 8.1.0

Pour trouver quelles versions déjà installées et lesquelles sont utilisées :

nvm ls

Pour sélectionner la version à utiliser :

# latest version
nvm use node

# specific version
nvm use 4.2

Liste toutes les versions disponible à l'installation :

nvm ls-remote

NPX

The script npx is also installed with Nodejs—this script is used to run packages not yet installed.