Documentos de Académico
Documentos de Profesional
Documentos de Cultura
El Libro para Principiantes en Node Js Un Tutorial Completo de Node
El Libro para Principiantes en Node Js Un Tutorial Completo de Node
Sobre el Tutorial
El objetivo de este documento es ayudarte a empezar con el desarrollo de
aplicaciones para Node.js, ensendote todo lo que necesites saber acerca de
JavaScript "avanzado" sobre la marcha. Este tutorial va mucho ms all del tpico
manual "Hola Mundo".
Status
Ests leyendo la versin final de este libro, es decir, las actualizaciones solo
sern hechas para corregir errores o para reflejar cambiar en nuevas versiones de
Node.js.
Las muestras de cdigo de este libro estn probadas para funcionar con la
versin 0.6.11 de Node.js.
Audiencia Objetivo
Este documento probablemente ser mejor entendido por los lectores que
tengan un trasfondo similar al mo: Programadores experimentados en al menos
un lenguaje orientado al objeto, como Ruby, Python, PHP o Java; poca
experiencia con JavaScript, y ninguna experiencia en Node.js.
El que este documento est orientado a desarrolladores que ya tienen
experiencia con otros lenguajes de programacin significa que no vamos a cubrir
temas realmente bsicos como tipos de datos, variables, estructuras de control y
similares. Debes saber acerca de estos tpicos para entender este documento.
Sin embargo, dado que las funciones y objetos en JavaScript son diferentes de
sus contrapartes en la mayora de los lenguajes, estos sern explicados con ms
www.nodebeginner.org/index-es.html
1/41
04/09/13
detalle.
Tabla de Contenidos
JavaScript y Node.js
www.nodebeginner.org/index-es.html
2/41
04/09/13
JavaScript y T
Antes que hablemos de toda la parte tcnica, tommonos un minuto y hablemos
acerca de ti y tu relacin con JavaScript. Este captulo est aqu para permitirte
estimar si tiene sentido el que sigas o no leyendo este documento.
Si eres como yo, empezaste con el "desarrollo" HTML hace bastante tiempo,
escribiendo documentos HTML. Te encontraste en el camino con esta cosa
simptica llamada JavaScript, pero solo la usabas en una forma muy bsica,
agregando interactividad a tus pginas de cuando en cuando.
Lo que realmente quisiste era "la cosa real", Queras saber cmo construir sitios
web complejos - Aprendiste un lenguaje de programacin como PHP, Ruby,
Java, y empezaste a escribir cdigo "backend".
No obstante, mantuviste un ojo en JavaScript, y te diste cuenta que con la
introduccin de jQuery, Prototype y otros, las cosas se fueron poniendo ms
avanzadas en las Tierras de JavaScript, y que este lenguaje era realmente ms
que hacer un window.open().
Sin embargo, esto era todo cosa del frontend ,y aunque era agradable contar con
jQuery a tu disposicin en cualquier momento que te sintieras con nimo de
sazonar una pgina web, al final del da, lo que eras a lo ms, era un usuario de
JavaScript, pero no, un desarrollador de JavaScript.
Y entonces lleg Node.js. JavaScript en el servidor, Qu hay con eso?
Decidiste que era ya tiempo de revisar el nuevo JavaScript. Pero espera: Escribir
aplicaciones Node.js es una cosa ; Entender el porqu ellas necesitan ser escritas
en la manera que lo son significa entender JavaScript! Y esta vez es en serio.
Y aqu est el problema: Ya que JavaScript realmente vive dos, o tal vez tres vidas
(El pequeo ayudante DHTML de mediados de los 90's, las cosas ms serias
tales como jQuery y similares, y ahora, el lado del servidor), no es tan fcil
encontrar informacin que te ayude a aprender JavaScript de la "manera
correcta", de forma de poder escribir aplicaciones de Node.js en una apariencia
que te haga sentir que no slo ests usando JavaScript, sino que tambin estn
desarrollando con l.
www.nodebeginner.org/index-es.html
3/41
04/09/13
Una Advertencia
Hay algunas personas realmente excelente en JavaScript. No soy una de ellas.
Yo soy realmente el tipo del que te he hablado en los prrafos previos. S un par
de cosas acerca de desarrollar aplicaciones backend, pero an soy nuevo al
JavaScript "real" y an ms nuevo a Node.js. He aprendido solo recientemente
alguno de los aspectos avanzados de JavaScript. No soy experimentado.
Por lo que este no es un libro "desde novicio hasta experto". Este es ms bien un
libro "desde novicio a novicio avanzado".
Si no fallo, entonces este ser el tipo de documento que deseo hubiese tenido
cuando empec con Node.js.
4/41
04/09/13
"Hola Mundo"
Ok. Saltemos entonces al agua fra y escribamos nuestra primera aplicacin
Node.js: "Hola Mundo".
Abre tu editor favorito y crea un archivo llamado holamundo.js. Nosotros
queremos escribir "Hola Mundo" a STDOUT, y aqu est el cdigo necesario para
hacer esto:
console.log("Hola Mundo");
node holamundo.js
5/41
04/09/13
Muy bien. Ahora, tu puedes ser capaz de alcanzar este objetivo googleando y
programando lo que sea, pero eso no es lo que queremos hacer aqu.
Ms que eso, no queremos escribir simplemente el cdigo ms bsico posible
para alcanzar este objetivo, no importa lo elegante y correcto que pueda ser este
cdigo. Nosotros agregaremos intencionalmente ms abstraccin de la necesaria
de manera de poder tener una idea de lo que es construir aplicaciones ms
complejas de Node.js.
La Pila de Aplicaciones
Hagamos un desglose a nuestra aplicacin. Qu partes necesitan ser
implementadas para poder satisfacer nuestros casos de uso?
Queremos servir pginas web, de manera que necesitamos un Servidor
HTTP.
Nuestro servidor necesitar responder directamente peticiones (requests),
dependiendo de qu URL sea pedida en este requerimiento, es que
necesitaremos algn tipo de enrutador (router) de manera de mapear
los peticiones a los handlers (manejadores) de stos.
Para satisfacer a los peticiones que llegaron al servidor y han sido ruteados
usando el enrutador, necesitaremos de hecho handlers (manejadores)
de peticiones
El Enrutador probablemente debera tratar cualquier informacin POST
que llegue y drsela a los handlers de peticiones en una forma conveniente,
www.nodebeginner.org/index-es.html
6/41
04/09/13
7/41
04/09/13
node server.js
8/41
04/09/13
www.nodebeginner.org/index-es.html
9/41
04/09/13
function decir(palabra) {
console.log(palabra);
}
function ejecutar(algunaFuncion, valor) {
algunaFuncion(valor);
}
ejecutar(decir, "Hola");
Lee esto cuidadosamente! Lo que estamos haciendo aqu es, nosotros pasamos
la funcin decir() como el primer parmetro de la funcin ejecutar. No el valor de
retorno de decir, sino que decir() misma!
Entonces, decir se convierte en la variable local algunaFuncion dentro de
ejecutar, y ejecutar puede llamar a la funcin en esta variable usando
algunaFuncion() (agregando llaves).
Por supuesto, dado que decir toma un parmetro, ejecutar puede pasar tal
parmetro cuando llama a algunaFuncion.
Nosotros podemos, tal como lo hicimos, pasar una funcin por su nombre como
parmetro a otra funcin. Pero no estamos obligados a tener que definir la
funcin primero y luego pasarla. Podemos tambin definir y pasar la funcin
como un parmetro a otra funcin todo al mismo tiempo:
10/41
04/09/13
A estas alturas, debera quedar claro lo que estamos haciendo ac: Estamos
pasndole a la funcin createServer una funcin annima.
Podemos llegar a lo mismo refactorizando nuestro cdigo as:
11/41
04/09/13
12/41
04/09/13
ser llamada.
No sabemos qu es lo que va a suceder, pero ahora tenemos un lugar donde
vamos a poder manipular la peticin entrante. Es la funcin que pasamos, sin
importar si la definimos o si la pasamos de manera annima.
Este concepto es llamado un callback (del ingls: call = llamar; y back = de
vuelta). Nosotros pasamos una funcin a algn mtodo, y el mtodo ocupa esta
funcin para llamar (call) de vuelta (back) si un evento relacionado con este
mtodo ocurre.
Al menos para m, esto tom algn tiempo para ser entendido. Lee el articulo del
blog de Felix de nuevo si todava no te sientes seguro.
Juguemos un poco con este nuevo concepto. Podemos probar que nuestro
cdigo contina despus de haber creado el servidor, incluso si no ha sucedido
ninguna peticin HTTP y la funcin callback que pasamos no ha sido llamada?
Probemos:
Noten que utilizo console.log para entregar un texto cada vez que la funcin
onRequest (nuestro callback) es gatillada, y otro texto despus de iniciar nuestro
servidor HTTP.
Cuando iniciamos esta aplicacin (con node server.js, como siempre). Esta
inmediatamente escribir en pantalla "Servidor Iniciado" en la lnea de
comandos. Cada vez que hagamos una peticin a nuestro servidor (abriendo
http://localhost:8888/ en nuestro browser), el mensaje "Peticion Recibida." va a
www.nodebeginner.org/index-es.html
13/41
04/09/13
14/41
04/09/13
Bien. Ya tenemos claro como hacer uso de los mdulos internos de Node.js.
Cmo hacemos para crear nuestros propios mdulos, y Cmo los utilizamos?
Descubrmoslo transformando nuestro script server.js en un mdulo real.
www.nodebeginner.org/index-es.html
15/41
04/09/13
Sucede que, no tenemos que transformarlo tanto. Hacer que algn cdigo sea
un Mdulo, significa que necesitamos exportar las partes de su funcionalidad
que queremos proveer a otros scripts que requieran nuestro mdulo.
Por ahora, la funcionalidad que nuestro servidor HTTP necesita exportar es
simple: Permitir a los scripts que utilicen este mdulo arrancar el servidor.
Para hacer esto posible, Dotaremos al cdigo de nuestro servidor de una funcin
llamada inicio, y exportaremos esta funcin:
Como puedes ver, nosotros utilizamos nuestro mdulo de servidor tal como
cualquier otro mdulo interno: requiriendo el archivo donde est contenido y
asignndolo a una variable, con las funciones que tenga 'exportadas' disponibles
para nosotros.
www.nodebeginner.org/index-es.html
16/41
04/09/13
Eso es. Podemos ahora arrancar nuestra aplicacin por medio de nuestro script
principal, y va a hacer exactamente lo mismo:
node index.js
17/41
04/09/13
url.parse(string).query
|
url.parse(string).pathname
|
|
|
|
|
------ ------------------http://localhost:8888/iniciar?foo=bar&hello=world
------|
|
|
|
querystring(string)["foo"]
|
|
querystring(string)["hello"]
18/41
04/09/13
function route(pathname) {
console.log("A punto de rutear una peticion para " + pathname);
}
exports.route = route;
Por supuesto, este cdigo no est haciendo nada, pero eso est bien por ahora.
Empecemos a ver como vamos a encajar este router con nuestro servidor antes
de poner ms lgica en el router.
Nuestro servidor HTTP necesita saber y hacer uso de nuestro router. Podemos
escribir directamente esta dependencia a nuestro servidor, pero como hemos
aprendido de la manera difcil en nuestras experiencias, vamos a acoplar de
manera dbil (loose coupling en Ingls) al router y su servidor va inyeccin por
dependencia. Para una referencia de fondo, leer el Artculo de Martin Fowler (en
Ingls).
Primero extendamos nuestra funcin iniciar() de manera de permitirnos pasar
la funcin de ruteo a ser usada como parmetro:
19/41
04/09/13
function iniciar(route) {
function onRequest(request, response) {
var pathname = url.parse(request.url).pathname;
console.log("Peticion para " + pathname + " recibida.");
route(pathname);
response.writeHead(200, {"Content-Type": "text/html"});
response.write("Hola Mundo");
response.end();
}
http.createServer(onRequest).listen(8888);
console.log("Servidor Iniciado.");
}
exports.iniciar = iniciar;
www.nodebeginner.org/index-es.html
20/41
04/09/13
21/41
04/09/13
function iniciar() {
console.log("Manipulador de peticin 'iniciar' ha sido llamado.");
}
function subir() {
console.log("Manipulador de peticin 'subir' ha sido llamado.");
}
exports.iniciar = iniciar;
exports.subir = subir;
22/41
04/09/13
23/41
04/09/13
(N. del T.: Se Opta por dejar los verbos en Ingls 'route' para rutear y 'handle'
para manipular).
Aunque handle es ms una "cosa" (una coleccin de manipuladores de peticin),
Propongo que lo nombremos como un verbo, ya que esto resultar en una
expresin fluida en nuestro router, como veremos a continuacin:
Como puedez ver, es realmente simple mapear diferentes URLs al mismo
manipulador de peticiones: Mediante la adicin de un par llave/valor de "/" y
requestHandlers.iniciar, podemos expresar en una forma agradable y limpia que
no slo peticiones a /start, sino que tambin peticiones a / pueden ser
manejadas por el manipulador inicio.
Despus de definir nuestro objeto, se lo pasamos al servidor como un parmetro
adicional. Modifiquemos nuestro server.js para hacer uso de este:
www.nodebeginner.org/index-es.html
24/41
04/09/13
Servidor Iniciado.
Peticion para /iniciar recibida.
A punto de rutear una peticin para /iniciar
Manipulador de peticion 'iniciar' ha sido llamado.
25/41
04/09/13
el
browser.
Necesitamos
modificar
function iniciar() {
console.log("Manipulador de peticion 'iniciar' fue llamado.");
return "Hola Iniciar";
}
function subir() {
console.log("Manipulador de peticion 'subir' fue llamado.");
return "Hola Subir";
}
exports.iniciar = iniciar;
exports.subir = subir;
www.nodebeginner.org/index-es.html
26/41
04/09/13
Bloqueante y No-Bloqueante
www.nodebeginner.org/index-es.html
27/41
04/09/13
function iniciar() {
console.log("Manipulador de peticion 'iniciar' fue llamado.");
function sleep(milliSeconds) {
// obten la hora actual
var startTime = new Date().getTime();
// atasca la cpu
while (new Date().getTime() < startTime + milliSeconds);
}
sleep(10000);
return "Hola Iniciar";
}
function subir() {
console.log("Manipulador de peticion 'subir' fue llamado.");
return "Hola Subir";
}
exports.iniciar = iniciar;
exports.subir = subir;
Dejemos claros que es lo que esto hace: Cuando la funcin iniciar() es llamada,
Node.js espera 10 segundos y slo ah retorna "Hola Iniciar". Cuando est
llamando a subir(), retorna inmediatamente, la misma manera que antes.
(Por supuesto la idea es que te imagines que, en vez de dormir por 10 segundos,
exista una operacin bloqueante verdadera en iniciar(), como algn tipo de
www.nodebeginner.org/index-es.html
28/41
04/09/13
29/41
04/09/13
/inicio.
Lo que el cdigo hace es claro: Crea una nueva variable content() (con el valor
incial de "vacio"), ejecuta "ls -lah", llena la variable con el resultado, y lo retorna.
Como
siempre,
arrancaremos
nuestra
aplicacin
visitaremos
http://localhost:8888/iniciar.
Lo que carga una bella pgina que despliega el string "vacio". Qu es lo que est
incorrecto ac?
Bueno, como ya habrn adivinado, exec() hace su magia de una manera nobloqueante. Buena cosa esto, porque de esta manera podemos ejecutar
operaciones de shell muy caras en ejecucin (como, por ejemplo, copiar archivos
enormes o cosas similares) sin tener que forzar a nuestra aplicacin a detenerse
como lo hizo la operacin sleep.
(Si quieres probar esto, reemplaza "ls -lah" con una operacin ms cara como
"find /").
Pero no estaramos muy felices si nuestra elegante aplicacin no bloqueante no
desplegara algn resultado, cierto?.
Bueno, entonces, arreglmosla. Y mientras estamos en eso, tratemos de
entender por qu la arquitectura actual no funciona.
El problema es que exec(), para poder trabajar de manera no-bloqueante, hace
uso de una funcin de callback.
En nuestro ejemplo, es una funcin annima, la cual es pasada como el segundo
parmetro de la llamada a la funcin exec():
30/41
04/09/13
31/41
04/09/13
32/41
04/09/13
}
exports.route = route;
33/41
04/09/13
34/41
04/09/13
travs de la aplicacin.
OK, vemoslo paso a paso, pero ahora, con la mayora de las tcnicas y principios
de JavaScript explicadas, acelermoslo un poco al mismo tiempo.
Aqu, paso a paso significa a grandes razgos dos pasos: Vamos a ver primero
como manejar peticiones POST entrantes (pero no subidas de archivos), y en un
segundo paso, haremos uso de un modulo externo de Node.js para la
manipulacin de subida de archivos. He escogido este alcance por dos razones:
Primero, manejar peticiones POST bsicas es relativamente simple con Node.js,
pero an nos ensea lo suficiente para que valga la pena ejercitarlo.
Segundo, manejar las subidas de archivos (i.e. peticiones POST multiparte) no es
simple con Node.js, consecuentemente est ms all del alcance de este tutorial,
pero el aprender a usar un modulo externo es una leccin en s misma que tiene
sentido de ser includa en un tutorial de principiantes.
function iniciar(response) {
console.log("Manipulador de peticiones 'iniciar' fue llamado.");
var body = '<html>'+
'<head>'+
'<meta http-equiv="Content-Type" content="text/html;
charset=UTF-8" />'+
'</head>'+
'<body>'+
'<form action="/subir" method="post">'+
'<textarea name="text" rows="20" cols="60"></textarea>'+
'<input type="submit" value="Submit text" />'+
'</form>'+
'</body>'+
www.nodebeginner.org/index-es.html
35/41
04/09/13
'</html>';
response.writeHead(200, {"Content-Type": "text/html"});
response.write(body);
response.end();
}
function upload(response) {
console.log("Manipulador de peticiones 'subir' fue llamado.");
response.writeHead(200, {"Content-Type": "text/html"});
response.write("Hola Subir");
response.end();
}
exports.iniciar = iniciar;
exports.subir = subir;
36/41
04/09/13
cdigo la informacin POST en pequeos trozos con callbacks que son llamadas
ante determinados eventos. Estos eventos son data (un nuevo trozo de
informacin POST ha llegado) y end (todos los trozos han sido recibidos).
Necesitamos decirle a Node.js que funciones llamar de vuelta cuando estos
eventos ocurran. Esto es hecho agregando listeners (N. del T.: Del verbo listen escuchar) al objeto de peticin (request) que es pasado a nuestro callback
onRequest cada vez que una peticin HTTP es recibida.
Esto bsicamente luce as:
request.addListener("data", function(chunk) {
// funcion llamada cuando un nuevo trozo (chunk)
// de informacion (data) es recibido.
});
request.addListener("end", function() {
// funcion llamada cuando todos los trozos (chunks)
// de informacion (data) han sido recibidos.
});
www.nodebeginner.org/index-es.html
37/41
04/09/13
Bsicamente hicimos tres cosas aqu: Primero, definimos que esperamos que la
codificacin de la informacin recibida sea UTF-8, agregamos un listener de
eventos para el evento "data" el cual llena paso a paso nuestra variable
dataPosteada cada vez que un nuevo trozo de informacin POST llega, y
movemos la llamada desde nuestro router al callback del evento end de manera
de asegurarnos que slo sea llamado cuando toda la informacin POST sea
reunida. Adems, pasamos la informacin POST al router, ya que la vamos a
necesitar en nuestros manipuladores de eventos.
Agregar un loggueo de consola cada vez que un trozo es recibido es una mala
idea para cdigo de produccin (megabytes de informacin POST, recuerdan?,
pero tiene sentido para que veamos que pasa.
Mejoremos nuestra aplicacin. En la pgina /subir, desplegaremos el contenido
recibido. Para hacer esto posible, necesitamos pasar la dataPosteada a los
manipuladores de peticin, en router.js.
38/41
04/09/13
Eso es, ahora somos capaces de recibir informacin POST y usarla en nuestros
manipuladores de peticin.
www.nodebeginner.org/index-es.html
39/41
04/09/13
Una ltima cosa para este tema: Lo que le estamos pasando al router y los
manipuladores de peticin es el cuerpo (body) de nuestra peticin POST.
Probablemente necesitemos consumir los campos individuales que conforman
la informacin POST, en este caso, el valor del campo text.
Nosotros ya hemos ledo acerca del mdulo querystring, el que nos ayuda con
esto:
40/41
04/09/13
The Node Beginner Book by Manuel Kiessling (see Google+ profile) is licensed under a
Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.
Permissions beyond the scope of this license may be available at manuel@kiessling.net.
www.nodebeginner.org/index-es.html
41/41