Nosotros normalmente usamos Express para crear aplicaciones REST pero este no es el único web framework que existe. Hoy tratare de introducirles uno que me ha parecido increíblemente bueno, su nombre es Fastify.

Fastify es un muy rápido y bajo costo web framework que esta basado completamente en Plugins. Esto hace que sea muy fácil escalar proyectos que tengas con el framework ya que permite una modularidad propia de NodeJS y debido a como maneja el contexto dentro de los plugins sea claro el alcance de este.

Para empezar con la creación de un proyecto vamos a usar a Fastify para que nos cree la estructura del proyecto pero primero debemos crear la carpeta en la cual el proyecto va estar

mkdir fastify-server

Despues de haber creado la carpeta nos metemos en ella y ejecutamos el siguiente comando

npm init fastify

Como resultado obtendremos una serie de carpetas y archivos que representan la estructura del proyecto. En la estructura podemos encontrar dos carpetas muy importantes que son plugins y routes, que como sus nombres indican aglomeraran los plugins y rutas de la aplicación. También tenemos la carpeta de pruebas (Fastify instala y usa por defecto Tap) y no menos importante nuestro punto de entrada, el archivo app.js.

. ├── app.js ├── data.js ├── package-lock.json ├── package.json ├── plugins │ ├── README.md │ ├── sensible.js │ └── support.js ├── routes │ ├── README.md │ ├── example │ │ └── index.js │ └── root.js └── test ├── helper.js ├── plugins │ └── support.test.js └── routes ├── example.test.js └── root.test.js

Si te estas preguntando que es data.js. Es el archivo que vamos a crear a continuación, este archivo va hacer de nuestra base de datos, en el vamos a guardar la data para este proyecto y se ve de la siguiente manera

Ahora el siguiente paso seria crear nuestra primera ruta pero antes de empezar con las rutas quiero explicar como funciona Fastify y su manejo del context.

Nos vamos a mover al archivo principal app.js, aquí encontramos lo siguiente

Voy a tratar de desglosar lo que encontramos en el archivo. Primero, se esta exportanto una funcion asincrona que recibe dos parametros, fastify y opts, el primero es la instancia de la aplicacion y el segundo, como el nombre lo indica, son las opciones que se le pudiesen pasar. Esta configuración es conocida como un plugin en Fastify.

Para ser mas claro y enfático, para crear un plugin solo debes crear una function que reciba como primer parámetro la instancia de la aplicación y el segundo parámetro, las opciones que pueda recibir, has simple como suena, eso es un plugin.

Nota: Yo utilizo funciones asíncronas pero en realidad no tiene que serlo, puedes manejarlo en callback-based si es tu preferencia.

module.exports = async function (fastify, opts) {}

Lo segundo que podemos observar, es que dentro de este plugin estamos usando la instancia de Fastify para registrar otro plugin, en este caso uno llamado fastify-autoload, este plugin permite cargar varios archivos/plugins que se encuentren agrupados en una carpeta, recibe como segundo argumento un objeto con dos propiedades, dir y options, el primero hace referencia a la ubicación ( path ) de la carpeta que queremos cargar y el segundo a las opciones que queramos pasar.

Por defecto esta cargando los archivos que se encuentren en la carpetas plugins y routes. Si tú quieres tener plugins que estén activos en el contexto global de la aplicación debes registrarlos en este punto.

Si quieres leer un poco mas sobre el tema, te recomiendo estas lecturas que se encuetran en la documentación oficial de Fastify. Fastify Register y Plugins Guide.

Empecemos con lo bueno, En la carpeta routes encontramos un archivo llamado root.js, en el vamos a importar el archivo data que hace referencia a nuestra DB. Dentro del plugin principal vamos a definir la ruta ‘/’ de tipo GET, que seria nuestra ruta principal donde recibiremos la información contenida en data.

Como puedes ver es muy sencillo, con la instancia definimos el método de la ruta, en este caso de tipo GET pero también puede ser POST, PUT, etc. Esta función recibe dos parámetros, el primero la ruta, de tipo string, y el segundo una función asíncrona que a su vez recibe dos parámetros, request y reply. Si estas familiarizado con ExpressJS, estos hacen referencia a los objetos req y res con un diferente y separado API.

Si quieres saber mas sobre ellos, te recomiendo "Fastify: Request" and "Fastify: Reply".

Dentro de la misma carpeta vas a encontrar otra carpeta con el nombre example y dentro un archivo index.js. Fastify toma el nombre de la carpeta como el de la ruta, es decir, si la carpeta se llama edit, va a existir una ruta llamada igual ‘/edit’. Si has trabajo con NextJS, te vas a sentir como en casa ( por si no lo sabias, NextJS usa a Fastify under the hook).

Teniendo lo anterior en cuenta, vamos a cambiar el nombre de la carpeta para que se ajuste a nuestro proposito. Cambia el nombre a create y abre el archivo en su interior y cambia el código de la siguiente manera.

Vamos a desglosar el código. Primero creamos una ruta de tipo POST, ésta ruta tiene como path ‘/’ porque el nombre de la carpeta define el nombre de la ruta, es decir, vamos a tener esta ruta ‘/create’ cuando corramos el proyecto. El segundo parámetro que recibe es opcional, y en el se definen las opciones de la ruta. En este caso estoy definiendo el schema de la ruta, especificamente su body. Con esto se busca generar que Fastify realice validaciones a la data que entra y sale de la ruta. Si quieres saber más acerca de esto visita JSON-schema.

Como tercer parámetro, pasamos una función asíncrona que recibe dos parámetros, request y reply, en el body de la función vamos a colocar nuestra lógica de como la ruta debe manejar nuestra petición.

No debería explicar esto porque es muy simple pero por si alguien no lo entiende, la explicación es la siguiente.

Del objeto request extraemos el body que contiene la información que el usuario envió. A esa data, que en este caso es un todo, le agregamos la propiedad id y luego agregamos ese todo a la lista de todos y le devolvemos esa lista actualizada al usuario.

Cosas a tener en cuenta. Por defecto Fastify soporta application/json request, si necesitas manejar otros formatos puedes usar fastify-multipart para soportar multipart/formdata request y fastify-formbody para soportar application/x-www-form-urlencoded request.

Ahora solo queda correr el proyecto, para esto puedes usar cualquiera de estos dos comandos

npm run start or npm run dev

Espero hayas podido aprender algo de esto y si ya lo sabias ¡felicidades! vas bien encaminado.

Disculpa si se hizo muy largo pero cuando pensé en escribir sobre este tema no lo vi tan extenso ( y eso que aquí hay muchos temas que no he tocado haha ).

Te dejo para que completes el CRUD del proyecto, así refuerzas 😜