🌐 Java-HttpClient-ViaCEP

Este repositório contém um projeto de demonstração simples em Java, focado no consumo da API pública ViaCEP utilizando o cliente HTTP padrão da linguagem.

O objetivo principal é demonstrar a correta implementação de requisições HTTP GET síncronas usando o `java.net.http.HttpClient` (disponível a partir do Java 11) e o tratamento básico de exceções.

---

🛠️ Tecnologias e Recursos

• Linguagem: Java (Requer versão 11 ou superior).
• Gerenciamento de Dependências: Realizei Manualmente.
• Cliente HTTP: java.net.http.HttpClient (API nativa).
• Serialização JSON: Google GSON.
• API Consumida: ViaCEP.
• Ambiente: Aplicação de Linha de Comando (CLI).

---

📦 Dependências Externas (Configuração Manual)

Este projeto requer a biblioteca Google Gson para funcionar, pois ela é utilizada nas classes ConsultaCep.java e GeradorDeArquivo.java.

Como Adicionar o GSON ao Projeto:

Como o projeto não utiliza uma ferramenta de build, a dependência deve ser adicionada manualmente ao Classpath da sua IDE:

1. Baixe o JAR: Visite o repositório Maven Central (ou o site oficial do GSON) e baixe o arquivo .jar da versão mais recente e estável do Gson (ex: gson-2.10.1.jar).
2. Adicione ao Classpath: Na sua IDE (IntelliJ IDEA, Eclipse, etc.), configure o projeto para incluir o arquivo .jar baixado no Classpath.

---

✨ Funcionalidades

• Solicita um número de CEP ao usuário.
• Realiza uma requisição HTTP síncrona para a ViaCEP.
• Converte a resposta JSON em um objeto Java (Endereco).
• Imprime o objeto formatado no console.
• Salva o endereço consultado em um arquivo JSON local (Ex: 01001000.json).

🚀 Como Compilar e Executar

Para rodar o projeto após configurar o GSON, siga estes passos:

1. Compilação

Assumindo que você está no diretório raiz do projeto (onde estão as pastas src/ e o JAR do GSON já foi adicionado ao Classpath via linha de comando ou IDE), o comando de compilação será:

# Este comando compila todas as classes no diretório src
javac -cp <caminho/para/gson.jar> src/*.java

Observação: Se estiver usando uma IDE, a compilação é automática.

2. Execução

A execução deve ser feita a partir da classe principal (Principal.java):

# Este comando executa a classe Principal com o JAR do GSON no Classpath
java -cp <caminho/para/gson.jar>:src Principal

Nota: Substitua <caminho/para/gson.jar> pelo caminho real do arquivo que você baixou.

Exemplo de Interação:

Digite um número de CEP para consulta: 01001000
Endereco[cep=01001-000, logradouro=Praça da Sé, complemento=lado ímpar, bairro=Sé, localidade=São Paulo, uf=SP]

---

📄 Licença

Este projeto está sob a MIT License.