Qué es Restify y cómo utilizarlo para crear APIs RESTful en Node.js

Restify es un framework ligero para Node.js que se centra en el diseño y la implementación de servicios web y APIs RESTful.

Restify se destaca por su enfoque en la eficiencia y la simplicidad, permitiéndonos desarrollar aplicaciones que manejan una gran cantidad de solicitudes sin sacrificar el rendimiento.

Para más detalles y documentación sobre Restify, podéis visitar el repositorio oficial en GitHub - restify/node-restify. Aquí encontraremos ejemplos adicionales y la documentación completa para explorar todas las funcionalidades que Restify tiene para ofrecer.

Cómo instalar Restify

Para comenzar a utilizar Restify, primero necesitamos instalarlo en nuestro proyecto Node.js. Podemos hacerlo fácilmente utilizando el gestor de paquetes npm. Ejecutamos el siguiente comando para agregar Restify a nuestro proyecto:

npm install restify

Este comando descargará e instalará la biblioteca Restify en nuestro directorio node_modules y la añadirá a nuestras dependencias en package.json.

Cómo usar Restify

Una vez que hemos instalado Restify, podemos comenzar a utilizarlo para construir nuestra API. A continuación, veremos cómo crear un servidor básico, definir rutas y manejar solicitudes utilizando Restify.

Crear un servidor básico

Primero, vamos a crear un archivo llamado server.js en nuestro proyecto. En este archivo, vamos a configurar un servidor Restify básico:

const restify = require('restify');

// Crear el servidor Restify
const server = restify.createServer({
    name: 'MyApiServer'
});

// Middleware para manejar el cuerpo de la solicitud
server.use(restify.plugins.bodyParser());

// Ruta GET de ejemplo
server.get('/hello', (req, res, next) => {
    res.send('Hello, World!');
    return next();
});

// Ruta POST de ejemplo
server.post('/echo', (req, res, next) => {
    res.send(req.body);
    return next();
});

// Iniciar el servidor en el puerto 8080
server.listen(8080, () => {
    console.log(`${server.name} escuchando en el puerto 8080`);
});

En este código:

• Utilizamos restify.createServer para crear una instancia del servidor Restify.
• Aplicamos el middleware bodyParser para poder manejar datos en el cuerpo de las solicitudes POST.
• Definimos dos rutas: una ruta GET en /hello que devuelve un saludo simple y una ruta POST en /echo que devuelve el contenido enviado en la solicitud.
• Finalmente, iniciamos el servidor en el puerto 8080 y mostramos un mensaje en la consola para confirmar que está en funcionamiento.

Manejo de errores

Restify facilita el manejo de errores mediante la definición de un middleware específico para capturarlos. Podemos agregar un middleware de manejo de errores global al final de nuestra configuración de rutas:

// Middleware para manejo de errores
server.on('uncaughtException', (req, res, route, err) => {
    console.error(err.stack);
    res.send(500, { error: 'Internal Server Error' });
});

En este ejemplo, estamos capturando excepciones no controladas y respondiendo con un mensaje de error genérico y un código de estado 500.

Uso de plugins

Restify permite la extensión de su funcionalidad mediante plugins. Por ejemplo, podemos usar el plugin restify.plugins.queryParser para analizar parámetros de consulta en nuestras solicitudes:

// Middleware para manejar parámetros de consulta
server.use(restify.plugins.queryParser());

Con este middleware, podemos acceder a los parámetros de consulta en nuestras rutas utilizando req.query.