Documentação do Projeto Tabela FIPE

Descrição do Projeto

O projeto Tabela FIPE é uma aplicação Java desenvolvida com Spring Boot (sem módulo web) que consome a API da Tabela FIPE. Ele permite buscar informações sobre veículos, como marcas, modelos e anos, utilizando recursos modernos da linguagem como Streams para filtrar os resultados.

Estrutura do Projeto

/fipe
│
├── .idea/                       # Configurações do IntelliJ IDEA
├── .mvn/                        # Configurações do Maven Wrapper
├── src/                         # Código fonte da aplicação
│   └── main/
│       └── java/br/com/alura/fipe
│           ├── main              # Classes principais
│           │   ├── FipeApplication.java
│           │   └── Main.java
│           │
│           ├── models            # Modelos da aplicação
│           │   ├── Anos.java
│           │   ├── DadosVeiculo.java
│           │   ├── Modelos.java
│           │   └── Veiculo.java
│           │
│           └── service           # Serviços de consumo e conversão de dados
│               ├── ConsumoApi.java
│               ├── ConverteDados.java
│               └── IConverteDados.java
    

Principais Classes

• FipeApplication: Classe principal que inicializa o projeto Spring Boot.
• Main: Classe responsável por exibir o menu no console, interagir com o usuário e coordenar as chamadas para a API da Tabela FIPE.
• ConsumoApi: Serviço responsável por realizar requisições HTTP para a API da FIPE.
• ConverteDados: Classe responsável por converter os dados JSON retornados pela API em objetos Java.
• IConverteDados: Interface que define os métodos de conversão de dados.
• Veiculo: Record que representa uma marca da FIPE (código e nome).
• Modelos: Record que representa modelos de uma marca específica.
• Anos: Record que representa os anos de fabricação disponíveis para um modelo.
• DadosVeiculo: Classe que contém os detalhes completos de um veículo (valor, marca, modelo, ano, etc.).

Funcionalidades

• Listagem de Marcas: O usuário pode listar as marcas de carros ou motos disponíveis na Tabela FIPE.
• Busca de Modelos: A aplicação permite buscar modelos filtrando pelo nome digitado.
• Busca por Ano: Após escolher a marca e o modelo, o usuário pode selecionar o ano de fabricação.
• Detalhes do Veículo: Exibe informações detalhadas de um veículo, como valor e especificações.
• Filtros com Streams: O código utiliza Streams para buscar marcas e modelos de forma eficiente.

Como Executar o Projeto

1. Clone o repositório:

   git clone https://github.com/seu_usuario/Tabela-Fipe-Java-com-Spring.git
   cd Tabela-Fipe-Java-com-Spring
               

2. Compile e execute o projeto:

   Utilize Maven para compilar:

   mvn clean install
   mvn spring-boot:run
               

   Ou execute diretamente pela sua IDE (IntelliJ IDEA, Eclipse, VS Code).

3. Interaja pelo console:

   A aplicação exibirá um menu no terminal para que você selecione:

   • 1 - Carros
   • 2 - Motos

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.

Observação

O projeto utiliza a API pública da Tabela FIPE, disponível em: https://deividfortuna.github.io/fipe/. Certifique-se de estar conectado à internet ao executar as consultas.