ivanaac / conversordemoneda-alura-challenge

Challenge Back End ONE - Alura /Oracle . Conversor de Moneda

CHALLENGE CONVERSOR DE MONEDA

DESCRIPCIÓN

El Conversor de Monedas es una aplicación Java diseñada para realizar conversiones de diferentes monedas utilizando tasas de cambio actuales. Además, permite mantener un historial de conversiones realizadas y guardar este historial en archivos JSON y de texto.

CARACTERÍSTICAS

Esta aplicación te permite:

• Realizar la conversión de monedas entre diferentes pares de divisas.
• Ingresar pares de divisas personalizados.
• Visualizar el "Historial de conversiones".
• Guardar el "Historial de conversiones" en archivos JSON y de texto.

REQUISITOS PARA SU USO

Debes contar con:

• Java 17 o superior.
• Librerías externas:
• Gson para manejo de archivos JSON.
• HttpClient para solicitudes HTTP.
• JsonParser para parseo de respuestas JSON.
• Una clave Api de ExchangeRate-Api, puedes obtenerla de forma gratuita en www.exchangerate-api.com .

EJECUCIÓN DEL PROGRAMA

Para usar el Conversor debes:

1. Copiar el repositorio o descargar los archivos fuente del programa.
2. Asegúrate de tener las librerías necesarias en tu entorno de desarrollo. Puedes añadirlas a tu proyecto mediante un gestor de dependencias o agregarlas manualmente
3. Después, abre el archivo de la clase "Solicitud" en tu IDE de Java.
   En apiKey debes reemplazar “Aquí va tu clave” con la clave API que has generado en ExchangeRate-Api.
4. Finalmente, abre el archivo de la clase "Principal" y ejecútalo.

INTERACTUANDO CON LA APLICACIÓN

1-Convertir moneda

El programa presenta el siguiente menú interactivo:

Para seleccionar las opciones debes ingresar el número correspondiente y seguir las instrucciones.

Las opciones del 1 al 6 tienen divisas predeterminadas, si seleccionas una de ellas obtendrás un resultado similar a estos:

Con la opción 7 puedes utilizar divisas que no se encuentran entre las predeterminadas.
Ingresa las divisas y la cantidad a convertir cuando la aplicación lo solicite.
Cuentas con la posibilidad de escribir las divisas en mayúsculas o minúsculas.

Aquí tiene algunas divisas para probar:

• AUD - Australian Dollar - Australia
• CRC - Costa Rican Colon - Costa Rica
• CUP - Cuban Peso - Cuba
• HNL - Honduran Lempira - Honduras
• JPY - Japanese Yen - Japan
• KRW - South Korean Won - South Korea

Si deseas hacer pruebas con otras monedas, puedes encontrar más códigos en la página www.exchangerate-api.com , en la sección Supported Currencies .

¿Qué ocurre si ingresas una moneda que no se encuentre en el listado de la API?

En ese caso, obtendrás el siguiente mensaje:

2-Mostrar el Historial de Conversiones

En caso de que quieras ver nuevamente las conversiones que has realizado, entonces selecciona la opción 8, de ésta manera podrás observar los cambios de moneda que has realizado.

Si no realizaste ninguna conversión, recibirás otro mensaje.

3-Guardar el Historial de Conversiones

Con ésta opción puedes guardar el historial en dos archivos, uno en formato .json y otro en formato .txt.
Ambos se guardan dentro de la carpeta donde copiaste el repositorio con los archivos fuente.

4-Opción inválida

¿Qué sucede si elijes una opción que no es valida? Saldrá un mensaje que te permitirá volver a ingresar otra opción.

5-Salir de la aplicacíon

Cuando decidas salir de la aplicacion, solo debes seleccionar la opción 10.