Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giseletoledo/currency-converter
OBJETIVO: Desenvolver um Conversor de Moedas que ofereça interação textual (via console) com os usuários, conversões de moedas em um menu. A taxa de conversão é obtida por meio da ExchangeRate API, garantindo dados precisos e em tempo real para uma experiência mais atualizada e eficaz.
https://github.com/giseletoledo/currency-converter
api exchange-api java oop records
Last synced: 3 days ago
JSON representation
OBJETIVO: Desenvolver um Conversor de Moedas que ofereça interação textual (via console) com os usuários, conversões de moedas em um menu. A taxa de conversão é obtida por meio da ExchangeRate API, garantindo dados precisos e em tempo real para uma experiência mais atualizada e eficaz.
- Host: GitHub
- URL: https://github.com/giseletoledo/currency-converter
- Owner: giseletoledo
- Created: 2024-11-02T21:53:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-02T22:30:17.000Z (3 months ago)
- Last Synced: 2024-11-20T17:41:17.360Z (2 months ago)
- Topics: api, exchange-api, java, oop, records
- Language: Java
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
Currency Conversion App
## Descrição
O Currency Conversion App é uma aplicação Java que permite aos usuários converter valores entre diferentes moedas.
O aplicativo utiliza a [ExchangeRate API](https://www.exchangerate-api.com/docs/overview) para obter as taxas de câmbio mais recentes e oferece um histórico de conversões realizadas.
## Funcionalidades
Conversão de valores entre diferentes moedas.
Exibição de moedas disponíveis.
Histórico das últimas conversões realizadas.
Registros de logs para rastrear as conversões.
## Pré-requisitos
Java 21 - Java Development Kit (JDK): Certifique-se de ter o JDK instalado em seu sistema. Você pode baixar a versão mais recente do site oficial do Java.
Maven (opcional, se você não tiver o Maven instalado, siga as instruções abaixo para compilar e executar o projeto manualmente).
Clone o repositório.
## Dependências do Projeto
O projeto utiliza as seguintes dependências:
xml
```
21
21
UTF-8
com.google.code.gson
gson
2.10.1
```
## Configuração da API Key
Para utilizar a API de conversão de moedas, você precisará de uma chave de API da ExchangeRate-API. Siga os passos abaixo para configurar sua chave de API:
1. Crie uma conta: Acesse ExchangeRate-API e crie uma conta gratuita.
2. Obtenha sua API Key: Após a criação da conta, você receberá uma chave de API que será utilizada para autenticação em suas requisições.
3. Configurar o arquivo de propriedades:
4. Navegue até a pasta src/main/resources no seu projeto.
5. Crie um arquivo chamado config.properties (se ele não existir).
6. Adicione a seguinte linha ao arquivo, substituindo YOUR_API_KEY pela sua chave de API obtida:
```
API_KEY=YOUR_API_KEY
```
## Como Usar
1. Ao iniciar o aplicativo, você verá um menu com opções.
2. Escolha uma opção:
3. Converter Moeda: Digite os códigos das moedas de origem e destino, bem como o valor a ser convertido.
4. Ver Histórico de Conversões: Exibe o histórico das conversões realizadas.
5. Sair: Encerra o aplicativo.
Siga as instruções fornecidas na tela para realizar as conversões.
### Exemplo de Uso
```
Escolha uma opção:
1. Converter Moeda
2. Converter Valor Específico
3. Ver Histórico de Conversões
0. Sair
Códigos de moeda disponíveis: [USD, EUR, BRL, ...]
Digite o código da moeda de origem: USD
Digite o código da moeda de destino: EUR
Digite o valor a ser convertido: 100
Conversão realizada: O valor de 100 USD em EUR é 85.50
```