Crear una Api con NodeJS, Express y MySQL

En esta publicación vamos a crear una Api con NodeJS, Express y MySQL.

También utilizaremos Bcrypt, Cors, Dotenv, JsonWebToken, Jest y Supertest, pero esto en la siguientes publicaciones de la lista.

Para poder ejecutar un backend en NodeJS, necesitamos instalar NodeJS en nuestro sistema operativo, si ya lo tenemos instalado, podemos continuar con la publicación. Si no lo tenemos instalado podemos descargarlo e instalarlo entrando en el siguiente link.

Ahora, vamos a crear una base de datos en MySQL y crearemos la tabla documentos.

Vamos a crear un nuevo proyecto, para esto, vamos a abrir un terminal y pondremos el siguiente comando:

Ahora, vamos a instalar los siguientes paquetes:

Vamos a instalar Nodemon, Express, MySQL y Node Input Validator.

Para poder utilizar Nodemon en cualquier proyecto, lo instalaremos globalmente.

Añadiremos el siguiente comando dentro de scripts, el cual utilizaremos para encender localmente el backend con NodeJS.

Esto nos dejará un package.json parecido al siguiente:

Vamos a empezar creando un nuevo archivo, server.js en el cual importaremos express, y más adelante los controladores y las rutas.

En este archivo, pondremos la configuración de NodeJS y Express:

Ahora, vamos a crear el archivo db.js dentro de la carpeta config.

Requeriremos y configuraremos la conexión a la base de datos de MySQL. Iniciaremos la conexión, y la exportaremos para que sea accesible desde otros modulos.

Vamos a instalar Module Alias para poder escribir rutas más amigables y así poder importar los modulos más facilmente.

Ejemplo: require('@controllers/document.controller.js');

Una vez instalado, vamos a añadir al final del package.json, las rutas de las carpetas donde se encuentran los controladores, modelos, rutas y archivos de configuración.

Por último, para poder utilizar los alias que hemos añadido previamente, vamos a importar la librería module-alias al comienzo del archivo principal, en nuestro caso Server.js.

Ahora, vamos a crear el modelo para la tabla de Documentos. En este modelo, crearemos un método para cada una de las consultas, get, post, put, delete...

Estos métodos los ejecutaremos desde el controlador, dependiendo de la ruta que reciba express. Para esto, exportaremos el modelo.

También, vamos a crear un validador de Documentos, para que no se puedan añadir documentos sin título a la base de datos. Este, lo exportaremos para poder utilizarlo en el controlador de documentos.

Ahora es el momento de crear el controlador, este, dependiendo de la ruta de express, ejecutará un método u otro, el cual ejecutará el método correspondiente del modelo, realizando la conexión a la base de datos para, leer, crear, actualizar o eliminar documentos.

Exportaremos el controlador, para poder importarlo en document.routes.js y así poder asignar los métodos del controlador a las rutas.

Para terminar, crearemos el archivo de rutas, para empezar, importaremos el controlador para poder ejecutar los métodos de esté, y crearemos las rutas, asignandole el método del controlador correspondiente.

Exportaremos las rutas para poder importarlas y añadirlas a nodejs en el archivo server.js.

Por último, vamos a actualizar el archivo server.js, importando el archivo de rutas y diciendole a nodejs que las utilice.

Ahora, ya podemos comprobar que todo funciona, para esto podemos utilizar Postman.