Abbiamo già notato come esista una pletora di moduli utilizzabili da un programma node.js:
basta utilizzare l'istruzione require('nomemodulo') per utilizzare le funzionalità esportate dal modulo.
La piattaforma provvede una serie di moduli inclusi nella distribuzione di base, abbiamo visto ad esempio l'utilizzo del modulo fs o del modulo path
In questo post impariamo a definire i nostri moduli da utilizzare nei nostri programmi, per cercare di programmare utilizzando ravioli e non spaghetti
Una volta definito un modulo, è anche possibile pubblicarlo sul repository ufficiale dei moduli gestiti da npm.
Date un'occhiata alla lista ufficiale di moduli per node disponibili attualmente.
Se vi piace un modulo, basterà eseguire in una shell il comando npm <nomemodulo> nella cartella radice del progetto che state sviluppando, per poterlo utilizzare con una istruzione di require('nomemodulo') dal vostro codice.
Ad esempio, supponete di aver bisogno della funzionalità di trasformazione dei vostri oggetti json in formato xml: basterà utilizzare il modulo di terze parti che si chiama xml registrato sul repository ufficiale.
Vi posizionate nella cartella del vostro progetto e digitate npm install xml: verrà creata una directory node_modules, all'interno del vostro progetto, che contiene i sorgenti del modulo, se un modulo dipende da altri moduli, questi verranno a loro volta scaricati in locale, tutto in maniera semplice e trasparente.
Ogni modulo ufficiale ha una pagina di documentazione come questa in cui ci sono le informazioni su come utilizzarlo.
In questo caso basta scrivere del codice di questo tipo
var xml = require('xml');
var xmlString = xml({libri :
[
{
libro: [
{titolo : 'Il signore degli anelli'},
{autore : 'Tolkien'}
],
},
{
libro: [
{titolo: 'Guerra e pace'},
{autore: 'Tolstoj'}
]
}
]
}, true);
console.log(xmlString); <libri>
<libro>
<titolo>Il signore degli anelli</titolo>
<autore>Tolkien</autore>
</libro>
<libro>
<titolo>Guerra e pace</titolo>
<autore>Tolstoj</autore>
</libro>
</libri> Facciamo un esempio.
Immaginiamo di implementare un modulo biblioteca che ci permetta di salvare in memoria dei libri e di ottenere la lista attuale dei libri.
Il programma principale utilizza il modulo biblioteca
var biblioteca = require('./biblioteca');
biblioteca.inserisciLibro({
titolo : "Il signore degli anelli",
autore : "Tolkien"
});
biblioteca.inserisciLibro({
titolo : "Guerra e pace",
autore : "Tolstoj"
});
biblioteca.elaboraLibri(function(error, libri) {
if (error)
console.log(error.messaggio);
else {
libri.forEach(function(libro) {
console.log("Titolo: " +
libro.titolo +
"- Autore: " +
libro.autore);
});
}
}); module.exports = (function() {
var libri = [],
inserisciLibro = function(libro) {
libri.push(libro);
},
elaboraLibri = function(callback) {
if (libri.length === 0)
callback({messaggio: 'biblioteca vuota'}, null);
else
callback(null, libri);
};
return {
inserisciLibro : inserisciLibro,
elaboraLibri : elaboraLibri
};
})(); Notate anche l'utilizzo di una funzione di callback definita in programma.js e passata come argomento a eleboraLibri, tale funzione di callback verrà eseguita solo se non ci sono condizioni di errore (in questo caso rappresentate da una biblioteca vuota).
Ho aggiornato su github il progetto, effettuate un git pull per aggiornare i sorgenti che avete in locale, come mostrato questo post.
Ricordatevi, per il progetto esempio-xml, di posizionarvi nella cartella radice ed eseguire npm install xml per includere il modulo xml nel progetto.
Se avete dubbi e/o domande, commentate!
Alla prox.
Ivan
