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:
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:
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:
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 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:
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:
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:
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:
- Le site officiel de Node.js
- Une introduction à Node.js
- Faite une recherche de Node.js sur le blog IT-Wars, vous ne serez pas déçu...