Une introduction à node.js

Node.js est un framework implémentant, coté serveur, la version 8 du moteur Javascript de Google (pour une présentation rapide, je vous conseille de parcourir ces quelques slides).

L'objectif de ce billet est d'installer Node.js sur votre machine GNU/Linux et d'exécuter votre premier programme (hello.js).

Installation de Node.js

Il n'existe pas, à l'heure à laquelle je rédige ce billet, de "package" officiel de Node.js pour Debian/Ubuntu. L'installation est cependant assez simple. Pour installer la dernière version (stable) depuis le dépôt officiel GIT, il suffit de saisir les commandes suivantes:

mkdir ~/src

cd ~/src

git clone --depth 1 git://github.com/joyent/node.git

cd node

git checkout v0.4.12

sudo mkdir /opt/node

./configure --prefix=/opt/node

make

sudo make install

echo 'export PATH=$PATH:/opt/node/bin' >> ~/.profile

echo 'export NODE_PATH=/opt/node:/opt/node/lib/node_modules' >> ~/.profile

source ~/.profile

L'installation va se faire dans le répertoire /opt/node.

Pour vérifier que Node.js est bien installé sur votre machine:

# node -v

v0.4.12

Un premier exemple, ou le fameux "Hello world !"

On commence par éditer un fichier 'hello.js' contenant le code suivant:

//

// A JavaScript based on Node.js and VNStat

//

// Nicolas Hennion (aka) Nicolargo

//

// GPL v3.0

//

 

var http = require('http');

var url = require('url');

var spawn = require ('child_process').spawn;

 

//**********

// Variables

//**********

 

var listenport = 1337;

 

//**********

// Functions

//**********

 

// Chomp function (delete the \\n)

String.prototype.chomp = function () {

return this.replace(/(\\n|\\r)+$/, '');

};

 

// HTTP request

function onRequest(req, res) {

console.log("New request: "+req.url);

res.writeHead(200, {'Content-Type': 'text/plain'});

res.write('Hello World');

res.end();

};

 

//*************

// Main program

//*************

 

// Create the HTTP server

http.createServer(onRequest).listen(listenport);

 

// Get the hostname (FQDN)

var listenaddress = spawn('hostname', ['-f']);

listenaddress.stdout.on('data', function (data) {

var fqdn = new String(data);

console.log('Server running listenning http://'+fqdn.chomp()+':'+listenport+'/');

});

Puis on lance le noeud (node) avec la commande:

# node ./hello.js

Server running listenning http://VotreMachine:1337/

Il ne reste plus (après avoir autorisé les requêtes vers le port TCP 1337 si vous avez un Firewall sur votre machine de test) qu'à pointer une navigateu Web vers l'URL donnée par la commande pour voir affiché le résultat:

Détail du code

On commence par initialisé les fonctions de Node.js dont on a besoin (voir la liste dans la documentation officielle). Pour notre exemple, nous avons besoin de générer un serveur HTTP (http) et de lancer une commande système (spawn) récupérant le nom FQDN de la machine.

var http = require('http');

var spawn = require ('child_process').spawn;

Après la définition d'une variable globale (contenant le numéro TCP du port d'écoute du serveur) ainsi que d'une fonction enlevant le caractère de retour à la ligne du chaine (chomp), on passe au vif du sujet en générant un serveur HTTP:

// Create the HTTP server

http.createServer(function (req, res) {

res.writeHead(200, {'Content-Type': 'text/plain'});

res.end('Hello World\\n');

}).listen(listenport);

Cette commande est "forké" (elle génère donc un daemon HTTP écoutant sur le port 'listenport' et renvoyant le message texte 'Hello World'). Enfin on affiche dans la console l'URL du serveur:

// Get the hostname (FQDN)

var listenaddress = spawn('hostname', ['-f']);

listenaddress.stdout.on('data', function (data) {

var fqdn = new String(data);

console.log('Server running listenning http://'+fqdn.chomp()+':'+listenport+'/');

});

Les modules avec NPM

Pour étendre les fonctions de bases de Node.js, il faut utiliser l'utilitaire NPM (Node Package Manager). Grâce à lui il est possible d'ajouter des packages à Node.js.

Pour installer Node.js:

curl http://npmjs.org/install.sh | sudo sh -c 'export PATH=$PATH:/opt/node/bin ; export NODE_PATH=/opt/node:/opt/node/lib/node_modules ; sh'

Je vous laisse ensuite regarder la documentation puis la liste des packages disponibles.

Aller plus loin

Bien évidement, ce billet n'est qu'une simple introduction à ce framework (d'ou le titre :) ). Le code donnée en exemple est sûrement "optimisable" mais à un objectif pédagogique.  Je reviendrai rapidement sur ce sujet en proposant des développement basée sur Node.js pour la supervision de nos belles machines. Stay tuned...

Sources ayant inspirées ce billet:

Vus : 1987
Publié par Nicolargo : 402