danaxar/tbd-lab3

Laboratorio N°3 - Laboratorio de Taller de Base de Datos

Este repositorio contiene todos los archivos relacionados con el Laboratorio N°3 del Laboratorio de Taller de Base de Datos desarrollado por el grupo 1.

Integrantes del grupo 1

• Daniel Catalán
• Diego Ramírez
• Alan Donoso
• Jhoisan Allendes
• Diego Acuña

Descripción

El Laboratorio consiste en expandir lo realizado en el Laboratorio 1 y 2, ahora realizando consulta realizadas con Base de Datos No Relacionales (No SQL), utilizando MongoDB. Para ello, se realiza un Backend utilizando Java.

El repositorio incluye lo siguiente:

• Carpeta Backend: Contiene todos los archivos del Backend del proyecto y las clases de las entidades del modelo. Se distribuyen las clases en los paquetes Services, Repositories, Models y Controllers.
• Carpeta Database: Contiene el archivo .json para crear la Base de Datos, cargar los datos de prueba, cargar las emergencias, regiones, tareas y voluntarios en formato MongoDB.

Modelo Relacional a seguir para el Laboratorio N°3 (Mismo del Laboratorio 1 y 2)

• Link del Modelo

Requisitos y herramientas de desarrollo

Para ejecutar correctamente todo el proyecto, además de los archivos del repositorio se requieren las siguientes tecnologías:

• MongoDB Community Edition versión 6.0.
• MongoDB Compass versión 1.34.2.
• IntelliJ IDEA Ultimate versión 2022.2.1, aunque debería funcionar con cualquier versión.
• JDK Versión 11
• Postman versión 9.4

También, para el desarrollo del proyecto se utilizó:

• Visual Studio Code versión 1.74.1

Instrucciones de instalación

1. Clonar el repositorio: Esto proporcionará las carpetas principales para el proyecto de Laboratorio. Para clonarlo, se debe usar el siguiente comando en el directorio deseado:

git clone https://github.com/Danaxar/tbd-lab3.git

2. Ir al siguiente link e instalar MongoDB Community Edition y seguir las instrucciones del instalador.
3. Ir al siguiente link e instalar MongoDB Compass y seguir las instrucciones del instalador.
4. Instalar IntelliJ IDEA Ultimate: Ingresar al sitio web oficial de IntelliJ IDEA y seleccionar el instalador dependiendo del Sistema Operativo en uso:

• Para Windows, utilizar el siguiente link.
• Para Linux, utilizar el siguiente link.
• Para MacOs, utilizar el siguiente link.

5. Al abrir IntelliJ IDEA Ultimate, abrir un nuevo proyecto y seleccionar la carpeta Backend. Debemos esperar a que el proyecto se configure y se instalen los plugins necesarios.
6. Dentro de la carpeta src/main/resources escribir la siguiente configuración en el archivo llamado application.properties. Dentro del archivo, se debe incluir lo siguiente:

spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
spring.data.mongodb.database=TBD

7. Configurar el JDK: Al abrir una clase IntelliJ nos solicitará configurar un JDK. Debemos asegurarnos de seleccionar JDK versión 11. Si no tenemos JDK 11, IntelliJ nos proporciona una opción para instalarlo automáticamente.

8. Ir al siguiente link e instalar la última versión de Node.js, siguiendo las instrucciones de instalación.

9. Ir al siguiente link e instalar la última versión de Postman.

Con esto ya estamos listos con todo lo que es la instalación del proyecto y se puede continuar a las instrucciones de uso.

Instrucciones de uso

Carga de datos: Utilizar el archivo Dump llamado "import.json" desde MongoDB Compass:

Seleccionar la conexión a la base de datos

Crear una base de datos y una colección llamada voluntarios

Seleccionar añadir datos -> Importar un json

Seleccionar el archivo "import.json"

Confirmar

Y listo

👀: Utilizando IntelliJ IDEA Ultimate, asegurarse de que se detecte correctamente Spring Boot y Maven. Ejecutar la aplicación haciendo click en la opción "Run" dentro de IntelliJ IDEA.

¡Con esto ya tenemos el Backend listo para trabajar!

• Para probar el CRUD de una tabla, debemos colocar la ruta en Postman (Por ejemplo, http://127.0.0.1:8080/voluntarios). Luego seleccionar uno de los métodos a aplicar, dependiendo de si quieres crear, mostrar, editar o eliminar un elemento y lo mismo para los otros casos.