Tutorial - Aprende Node.js – Tutorial de Primeros Pasos

¿Qué es Node.js?

Node.js es una plataforma de desarrollo basada en Google’s V8, que es el motor de Google Chrome para Javascript, para ejecutar código Javascript en cualquier plataforma, sin necesidad de que sea un navegador. Además es de código abierto con una gran comunidad detrás y se suele utilizar para realizar tareas de servidor.

Node.js maneja todas la peticiones de manera asíncrona, por lo que se continúa ejecutando el código aún si espera a la respuesta del servidor.

Instalación

Para instalar Node.js solo tenemos que ir a su página web, descargar el instalador y ejecutarlo.

Node.js en la consola

Lo primero que haremos será utilizar Node.js directamente desde la consola de nuestro terminal, para  lo que tendremos que utilizar el comando node en esta, y ya podemos escribir nuestro código Javascript.

Por ejemplo si ejecutamos el código:

var suma = 1 + 4console.log(suma)

Primer servidor

Ahora que ya hemos visto que Node.js ejecuta Javascript desde la consola vamos a crear un archivo .js para crear un pequeño servidor que nos muestre el mensaje Hola Mundo.

Para eso creamos el archivo server.js, en el que escribimos:

Este código lo que hace es importar la funcionalidad http de node con la primera línea, después utiliza la función createServer de esta para crear un servidor. Esta función recibe como parámetro una función que gestiona la petición y la respuesta se realiza al servidor al crearse, así que solo responde enviando el código 200 para confirmar que la respuesta se ha realizado de manera correcta y la finaliza con el mensaje ‘Hola mundo’. Por último dice en que puerto local esta ubicado el servidor.

Ahora si en consola utilizamos el comando:

node server.js

podremos acceder a http://localhost:8080/ para ver nuestro “Hola Mundo”.

Crear API rest

También podemos crear una API con Node.js. Una API es el conjunto de reglas y mecanismos mediante los cuales una aplicación interactúa con las demás, devolviendo los datos en XML y JSON. Una API rest es aquella que utiliza métodos HTTP  para presentar datos de una base de datos al cliente.

Para esto, node.js utiliza el framework express para realizar peticiones HTTP. Tendremos que crear un proyecto con la utilidad npm incluida en Node.js. Así que iremos a la carpeta en la que queramos alojar el proyecto y utilizamos el siguiente comando:

npm init

El cual nos pedirá algunos datos del proyecto. Además crea, entre otras cosas,  un archivo de configuración del proyecto para poder añadir las extensiones llamado package.json y una carpeta para almacenarlas . Así que ahora instalaremos express en este directorio con el comando:

npm i --save express

Ahora tenemos que crear una ‘base de datos’ en JavaScript a la cual solicitar la información. Para esto creamos un archivo db.js dentro de una carpeta db. En este archivo añadimos una entrada:

const horario =  [
   {
     id: 1,
     title: "comida",
     description: "La hora de comer son las 2pm"
   }
];
 
module.exports = {
   horario: horario
}

module.exports lo que hace es darle nombre a lo que exportamos a otro archivo.

Ahora crearemos el archivo .js que gestione las peticiones y devuelva datos de la ‘base datos’. Llamaremos a este archivo api.js

const express = require('express');
 
const db = require('./db/db');
 
// Inicia express
 
const app = express();
 
// get horario
 
app.get('/api/horario', function(req, res){
 
 res.status(200).send({
 
   success: 'true',
 
   message: 'Horario conseguido satisfactoriamente',
 
   horario: db.horario
 })
});
 
const PORT = 5000;
 
app.listen(PORT, function(){
 
 console.log(`servidor corriendo en puerto ${PORT}`)
 
});

En este código lo primero que hacemos en importar express y nuestra base de datos con require.

Después iniciamos express para utilizar sus métodos, que utilizamos get, para indicarle que hacer cuando recibe una petición GET, que es la petición para obtener datos de una API Rest. Sus parámetros són la dirección http que tiene que recibir la petición y una función para manejar la petición y la respuesta. Le decimos que el status de la respuesta es 200, es decir que todo ha salido correcto y añadimos a los datos de la base de datos un mensaje de que todo ha ido bien.

Ahora solo queda utilizar el método listen para iniciar un servidor, que recibe el puerto en el que se despliega y la función a realizar al desplegarse, que en este caso es decir por consola en que puerto esta.

Para comprobar que todo ha ido bien utilizaremos la aplicación Postman para probar las APIs. Debemos descargarla desde aquí e instalarla. Una vez iniciada utilizamos el siguiente comando para iniciar el servidor:

node api.js

Ahora le indicamos a postman la dirección a la que realizar el método GET y lanzamos la petición. Si todo ha salido bien, debería aparecer un mensaje así:

Ahora crearemos código para añadir un nuevo horario a través de nuestra API, para esto necesitamos instalar body-parser para cambiar el JSON que le enviamos en el body de la petición a objetos que utilizar en nuestro archivo api.js.

Para instalarlo utilizamos:

npm install body-parser --save

Utilizamos require para importarlo:

const bodyParser = require('body-parser');

Y le indicamos a express que tiene que utilizarlo para traducir el JSON:

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));

Ahora ya añadimos el POST, que es la petición a una API para crear una nueva entrada:

app.post('/api/horario', function(req, res){
 
   if(!req.body.title) {
 
     return res.status(400).send({
 
       success: 'false',
 
       message: 'title es necesario'
 
     });
 
   } else if(!req.body.description) {
 
     return res.status(400).send({
 
       success: 'false',
 
       message: 'description es necesario'
     });
   }
 
  const hora = {
 
    id: db.horario[db.horario.length-1].id + 1,
 
    title: req.body.title,
 
    description: req.body.description
 
  }
 
  db.horario.push(hora);
 
  return res.status(201).send({
 
    success: 'true',
 
    message: 'Horario añadido',
 
    hora
  })
 });

En este código primero comprobamos que en la petición tengo tanto title cómo description, devolviendo un error en el caso que no haya salido bien, con el status 400, que quiere decir que la petición no tenía los datos necesarios.

A continuación, si todo va bien añadimos la hora a nuestra “base de datos”, utilizando horario.push y la hora que hemos creado con los datos enviados.

Para comprobar que ha ido bien volveremos a utilizar Postman, pero esta vez utilizando el método POST, y añadiendo en body el tipo de datos x-www-form-urlencoded y, aquí, el title y la descripción. Dado que no lo almacenamos en una base de datos real, si no en una archivo .js una vez reiniciemos el servidor los cambios a la “base de datos” cambien se revertirán.

Podemos realizar una parecida a esta:

Además del mensaje satisfactorio podemos comprobar que todo ha ido bien realizando una petición GET, en la cual si todo ha ido bien deberán aparecer las dos entradas: