Consulta-Cep 📫

Projeto em Java para consultar e armazenar dados de endereços brasileiros a partir de códigos postais (CEP), utilizando a API pública ViaCEP. 🇧🇷

---

Descrição 📝

Este programa realiza buscas de endereços por CEP, obtendo os dados diretamente da API ViaCEP e armazenando os resultados em um arquivo JSON para consulta posterior.

• Cep.java: classe que representa os dados retornados pela API, modelando o endereço em formato de registro.
• principalComApi.java: classe principal que realiza a interação com o usuário, busca os CEPs na API, armazena as respostas em uma lista e grava os dados em um arquivo JSON (Cps.txt).

---

Funcionalidades ⚙️

• Solicita ao usuário um ou mais CEPs para consulta.
• Faz requisições HTTP à API ViaCEP para obter os dados do endereço correspondente.
• Armazena os resultados em uma lista interna.
• Salva os dados consultados em arquivo JSON para uso futuro.

---

Requisitos 📚

• JDK 11 ou superior instalado no sistema.
• Biblioteca Gson para manipulação de JSON.
  • Download Gson 📥
  • Incluir o .jar do Gson no classpath do projeto.

---

Como executar ▶️

1. Clone ou baixe o repositório.

2. Certifique-se de que o JDK 11+ esteja instalado e configurado corretamente.

3. Baixe a biblioteca Gson e adicione ao seu projeto.

4. Compile os arquivos .java no terminal:

javac -cp gson-<versão>.jar Cep.java principalComApi.java

Execute o programa:

java -cp .;gson-<versão>.jar principalComApi

Nota: No Linux ou macOS, substitua o ponto e vírgula ; por dois pontos : no classpath, assim:

java -cp .:gson-<versão>.jar principalComApi

---

Uso da aplicação ✍️

Insira os CEPs quando solicitado, no formato exemplo: 01001-000 Após digitar cada CEP, pressione Enter.

Para finalizar a inserção, basta seguir a instrução do programa: geralmente, deixe o campo vazio e pressione Enter.

---

Arquivo de saída 💾

Os dados consultados serão salvos no arquivo Cps.txt na raiz do projeto, no formato JSON.

Você poderá reutilizar ou analisar esses dados posteriormente utilizando qualquer ferramenta compatível com JSON.

---

Observações ⚠️

O funcionamento do programa depende da disponibilidade da API ViaCEP.

Caso a API não retorne dados para um CEP informado, o programa exibe uma mensagem de erro informando o problema.

É imprescindível incluir a biblioteca Gson para manipulação correta dos dados JSON.

---

Referências 🔗

API ViaCEP: https://viacep.com.br/

Biblioteca Gson: https://github.com/google/gson