Consulta de CEP

Criar um software em Java que realize a consulta de CEP e retorne informações sobre a localização é uma excelente maneira de aprender mais sobre APIs e integração de serviços em aplicações Java. Este guia passo a passo vai te mostrar como criar um programa que realiza a consulta de CEPs e fornece informações sobre a cidade, estado e endereço relacionado.

Configuração do Ambiente de Desenvolvimento

Antes de começar, certifique-se de ter o Java Development Kit (JDK) instalado e um IDE, como o Eclipse ou IntelliJ IDEA, para facilitar o desenvolvimento. Caso ainda não tenha instalado o JDK, faça o download no site oficial da Oracle e configure a variável de ambiente JAVA_HOME no seu sistema.

Escolha e Integração da API

Para consultar CEPs, utilizaremos uma API externa, como a ViaCEP, que é gratuita e fácil de usar. A API permite que façamos requisições HTTP e recebamos informações em formato JSON. Certifique-se de familiarizar-se com a documentação da API para entender os parâmetros e endpoints disponíveis.

Criando o Projeto Java

No seu IDE, crie um novo projeto Java e adicione uma classe principal, por exemplo, ConsultaCEP. Dentro dessa classe, você precisará configurar o método main e criar um método para realizar a consulta ao CEP. O Java possui bibliotecas nativas, como java.net.HttpURLConnection, que ajudam na execução de requisições HTTP.

Código para Consulta de CEP

Aqui está um exemplo de como o código Java poderia ser estruturado:

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;

public class ConsultaCEP {

    public static void main(String[] args) {
        String cep = "01001000"; // CEP de exemplo
        String resposta = consultarCEP(cep);

        if (resposta != null) {
            System.out.println(resposta);
        } else {
            System.out.println("CEP não encontrado.");
        }
    }

    public static String consultarCEP(String cep) {
        String urlString = "https://viacep.com.br/ws/" + cep + "/json/";

        try {
            URL url = new URL(urlString);
            HttpURLConnection conexao = (HttpURLConnection) url.openConnection();
            conexao.setRequestMethod("GET");
            BufferedReader in = new BufferedReader(new InputStreamReader(conexao.getInputStream()));
            String inputLine;
            StringBuilder conteudo = new StringBuilder();

            while ((inputLine = in.readLine()) != null) {
                conteudo.append(inputLine);
            }

            in.close();
            JSONObject json = new JSONObject(conteudo.toString());
            return json.toString(2);

        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

Esse código realiza uma requisição GET para a API ViaCEP, recupera as informações do CEP em JSON e as exibe no console.

Tratando Exceções e Validação de Entrada

Para garantir que seu software esteja bem estruturado, adicione validações para verificar se o CEP possui o formato correto e trate possíveis exceções, como falhas de conexão ou CEPs inexistentes. Isso melhora a robustez e a usabilidade do programa.

Conclusão

Seguindo esses passos, você terá um software simples, mas funcional, para consulta de CEP em Java. Esse projeto é uma excelente oportunidade para praticar a integração com APIs e a manipulação de JSON em Java, habilidades essenciais para desenvolvedores modernos.

Experimente ajustar e expandir esse código para adicionar novas funcionalidades, como salvar históricos de consultas ou integrar com uma interface gráfica para facilitar o uso.