README.md

Explorador Literario

Índice

1. Descripción del Proyecto
2. Capturas
3. Tecnologías Utilizadas
4. Requisitos
5. Configuración de Variables de Entorno
   • Variables necesarias
   • Ejemplo de configuración
6. Crear la base de datos
7. Autor
8. Insignia Explorador Literario

Descripción del Proyecto

Explorador Literario es una aplicación de consola diseñada para interactuar con una base de datos de libros y autores. La aplicación obtiene información sobre libros y autores desde la API Gutendex, permitiendo almacenar y gestionar libros y autores en la base de datos.

El menú principal, visible en las capturas, permite realizar diversas operaciones como registrar, buscar y listar libros y autores, entre otras funciones.

Capturas

Tecnologías Utilizadas

• Spring Boot: Para crear la aplicación de consola.
• PostgreSQL: Base de datos para almacenar libros y autores.
• JPA: Para interactuar con la base de datos.
• Jackson: Para la conversión de datos de la API.
• Maven: Gestor de dependencias.
• API Gutendex: Para obtener información sobre libros y autores.

Requisitos

• Java 17 o superior.
• PostgreSQL como sistema de base de datos.
• Conexión a Internet para acceder a la API Gutendex.

Configuración de Variables de Entorno

Para que la aplicación funcione correctamente, es necesario configurar las siguientes variables de entorno en tu sistema operativo. Estas variables se utilizan para establecer la conexión con la base de datos PostgreSQL y definir ciertos parámetros importantes para el funcionamiento de la aplicación.

Variables necesarias

• DB_HOST: Dirección o nombre del host donde se encuentra la base de datos PostgreSQL (por ejemplo, localhost o una dirección IP).
• DB_USER: Nombre de usuario que tiene permisos para acceder a la base de datos.
• DB_PASSWORD: Contraseña asociada al usuario de la base de datos.

Ejemplo de configuración

Debes agregar las siguientes variables de entorno a tu sistema, reemplazando los valores según tu configuración:

spring.datasource.url=jdbc:postgresql://${DB_HOST}/explorador_literario
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASSWORD}
spring.datasource.driver-class-name=org.postgresql.Driver
hibernate.dialect=org.hibernate.dialect.HSQLDialect
spring.jpa.hibernate.ddl-auto=update

Crear la base de datos

La aplicación espera que exista una base de datos llamada explorador_literario. Debes crear esta base de datos en tu instancia de PostgreSQL antes de ejecutar la aplicación.

1. Accede a PostgreSQL usando tu cliente preferido, como la terminal o una herramienta gráfica (por ejemplo, pgAdmin).

2. Ejecuta el siguiente comando SQL para crear la base de datos:

  CREATE DATABASE explorador_literario;

Autor

Desarrollado por Alfonso Manuel Vidrio Lizaola.

• LinkedIn: Alfonso Manuel Vidrio Lizaola

Insignia Explorador Literario