🚀 Como criar um novo projeto Spring Boot

📋 Pré-requisitos ## 🎯 Parte 1: Configurar Spring Initializr ## O que é Spring Initializr? ## Passo a Passo ## 1.1 Acessar o Spring Initializr ## 1.2 Configurar o Projeto ## 1.3 Adicionar Dependências ## 1.4 Gerar o Projeto ## 1.5 Descompactar o Projeto ## 🏗️ Parte 2: Criar Estrutura de Pacotes ## O que são pacotes? ## Passo a Passo ## 2.1 Importar no IntelliJ IDEA ## 2.2 Entender a Estrutura Atual ## 2.3 Criar os Pacotes ## ⚙️ Parte 3: Configurar application.yml ## Por que configurar? ## Passo a Passo ## 3.1 Converter .properties para .yml ## 3.2 Adicionar Configurações Básicas ## 🚀 Parte 4: Executar a Aplicação ## Momento da Verdade ## Passo a Passo ## 4.1 Executar pelo IntelliJ ## 4.2 Verificar se Funcionou ## 4.3 Testar no Navegador ## ✅ Critérios de Aceite - Checklist Final ## Configurar Spring Initializr ## Criar Estrutura de Pacotes ## Configurar application.yml ## Executar Aplicação ## 🐛 Problemas Comuns e Soluções ## Erro: "Java version mismatch" ## Erro: "Port 8080 already in use" ## Dependências não baixam ## IntelliJ não reconhece código Kotlin ## 🎓 Conceitos Importantes para Entender ## O que é Spring Boot? ## O que é API REST? ## O que é Gradle? ## 💡 Dicas ## 🎉 Parabéns Para: Desenvolvedor Backend Júnior Iniciante Objetivo: Criar o projeto Spring Boot + Kotlin do serviço de faturas Tempo estimado: 2-3 horas Nível de dificuldade: ⭐⭐ Iniciante-Intermediário Antes de começar, verifique se você tem instalado: É uma ferramenta web que gera automaticamente a estrutura inicial de um projeto Spring Boot. Pense nele como um "criador de projetos automático" que já configura tudo para você começar a programar rapidamente. Preencha os campos EXATAMENTE como descrito abaixo: Na seção Dependencies (lado direito), clique em "ADD DEPENDENCIES" e adicione: Spring Boot Actuator (opcional, mas recomendado) Agora você tem a estrutura básica do projeto! 🎉 Pacotes são pastas que organizam o código. É como organizar documentos em gavetas: cada tipo de arquivo vai em uma gaveta específica. ⏱️ Dica: Primeira vez pode demorar 5-10 minutos baixando bibliotecas. É normal! Depois de abrir, você verá algo assim: O que cada pasta significa: Vamos criar 4 pacotes para organizar nosso código seguindo o padrão de "arquitetura em camadas": Por que essa estrutura? Essa separação é chamada de Separation of Concerns - cada camada tem uma responsabilidade específica! O arquivo de configuração define como sua aplicação se comporta: em que porta roda, nome da aplicação, configurações de banco, etc. O Spring Initializr cria um arquivo application.properties, mas vamos usar .yml que é mais organizado. Abra o arquivo application.yml e adicione: O que cada configuração faz: Vamos subir a aplicação pela primeira vez. 😊 Observe o console (painel inferior do IntelliJ). Você deve ver: ✅ Se você viu isso, PARABÉNS! Sua aplicação está rodando! 🎉 Isso está CORRETO! 😎 A página de erro aparece porque ainda não criamos nenhum endpoint. O importante é que a aplicação está respondendo! Marque cada item que você completou: Causa: Versão errada do Java configurada Solução: Causa: Outra aplicação já está usando a porta 8080 Solução: Causa: Problema de rede ou cache do Gradle Solução: Causa: Plugin Kotlin não instalado Solução: É um framework (conjunto de ferramentas) que facilita criar aplicações Java/Kotlin. Ele já vem com muita coisa pronta, então você foca na lógica do seu negócio. Analogia: É como comprar um carro pronto ao invés de construir cada peça do zero. É uma forma de aplicações conversarem entre si usando HTTP (mesmo protocolo do navegador). Você cria "endpoints" (URLs) que recebem e envolvam dados. É uma ferramenta que: Analogia: É como um assistente que busca todas as ferramentas que você precisa e organiza tudo. Não copie e cole código sem entender! Leia cada linha, tente compreender. Se não entender algo, pergunte! Erros são normais Você vai ver MUITAS mensagens de erro. Aprenda a lê-las com calma. Geralmente a última linha diz o problema. Documente suas dúvidas Anote o que não entendeu para perguntar depois. Isso mostra proatividade! Commits frequentes Quando algo funcionar, salve no Git. É como criar pontos de restore de um jogo. Se você chegou até aqui e sua aplicação está rodando, você acabou de: ✅ Criar seu primeiro projeto Spring Boot ✅ Entender estrutura de pacotes ✅ Configurar uma aplicação ✅ Executar um servidor web Isso é MUITA coisa para um dia de trabalho! 🚀 Lembre-se: Todo desenvolvedor sênior já esteve no seu lugar. A diferença é que eles persistiram e continuaram aprendendo. Você está no caminho certo! 💪 Templates let you quickly answer FAQs or store snippets for re-use. Are you sure you want to hide this comment? It will become hidden in your post, but will still be visible via the comment's permalink. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse CODE_BLOCK: cd ~/Documentos/projetos/ unzip invoice-service.zip cd invoice-service Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: cd ~/Documentos/projetos/ unzip invoice-service.zip cd invoice-service CODE_BLOCK: cd ~/Documentos/projetos/ unzip invoice-service.zip cd invoice-service CODE_BLOCK: invoice-service/ ├── src/ │ ├── main/ │ │ ├── kotlin/ │ │ │ └── com/ │ │ │ └── invoice/ │ │ │ └── InvoiceServiceApplication.kt │ │ └── resources/ │ │ └── application.properties │ └── test/ ├── build.gradle.kts └── settings.gradle.kts Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: invoice-service/ ├── src/ │ ├── main/ │ │ ├── kotlin/ │ │ │ └── com/ │ │ │ └── invoice/ │ │ │ └── InvoiceServiceApplication.kt │ │ └── resources/ │ │ └── application.properties │ └── test/ ├── build.gradle.kts └── settings.gradle.kts CODE_BLOCK: invoice-service/ ├── src/ │ ├── main/ │ │ ├── kotlin/ │ │ │ └── com/ │ │ │ └── invoice/ │ │ │ └── InvoiceServiceApplication.kt │ │ └── resources/ │ │ └── application.properties │ └── test/ ├── build.gradle.kts └── settings.gradle.kts CODE_BLOCK: src/main/kotlin/com/invoice/ ├── controller/ (endpoints da API) ├── service/ (lógica de negócio) ├── model/ (classes de dados) ├── repository/ (acesso a dados) └── InvoiceServiceApplication.kt Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: src/main/kotlin/com/invoice/ ├── controller/ (endpoints da API) ├── service/ (lógica de negócio) ├── model/ (classes de dados) ├── repository/ (acesso a dados) └── InvoiceServiceApplication.kt CODE_BLOCK: src/main/kotlin/com/invoice/ ├── controller/ (endpoints da API) ├── service/ (lógica de negócio) ├── model/ (classes de dados) ├── repository/ (acesso a dados) └── InvoiceServiceApplication.kt CODE_BLOCK: server: port: 8080 spring: application: name: invoice-service logging: level: com.invoice: DEBUG Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: server: port: 8080 spring: application: name: invoice-service logging: level: com.invoice: DEBUG CODE_BLOCK: server: port: 8080 spring: application: name: invoice-service logging: level: com.invoice: DEBUG CODE_BLOCK: package com.invoice import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication @SpringBootApplication class InvoiceServiceApplication fun main(args: Array<String>) { runApplication<InvoiceServiceApplication>(*args) } Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: package com.invoice import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication @SpringBootApplication class InvoiceServiceApplication fun main(args: Array<String>) { runApplication<InvoiceServiceApplication>(*args) } CODE_BLOCK: package com.invoice import org.springframework.boot.autoconfigure.SpringBootApplication import org.springframework.boot.runApplication @SpringBootApplication class InvoiceServiceApplication fun main(args: Array<String>) { runApplication<InvoiceServiceApplication>(*args) } CODE_BLOCK: . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v3.2.x) ... Started InvoiceServiceApplication in 2.345 seconds Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v3.2.x) ... Started InvoiceServiceApplication in 2.345 seconds CODE_BLOCK: . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v3.2.x) ... Started InvoiceServiceApplication in 2.345 seconds CODE_BLOCK: ./gradlew clean build --refresh-dependencies Enter fullscreen mode Exit fullscreen mode CODE_BLOCK: ./gradlew clean build --refresh-dependencies CODE_BLOCK: ./gradlew clean build --refresh-dependencies - Java 17 ou superior - Execute no terminal: java -version - IntelliJ IDEA (Community) - Download aqui - Git - Execute: git --version - Abra seu navegador - Acesse: https://start.spring.io/ - Você verá uma página com vários campos de configuração - Spring Web O que faz: Permite criar APIs REST (endpoints HTTP) Por que precisa: Vamos criar endpoints para gerenciar faturas - O que faz: Permite criar APIs REST (endpoints HTTP) - Por que precisa: Vamos criar endpoints para gerenciar faturas - Spring DevTools O que faz: Reinicia automaticamente a aplicação quando você salva o código Por que precisa: Agiliza o desenvolvimento, você não precisa parar e iniciar manualmente - O que faz: Reinicia automaticamente a aplicação quando você salva o código - Por que precisa: Agiliza o desenvolvimento, você não precisa parar e iniciar manualmente - Spring Boot Actuator (opcional, mas recomendado) O que faz: Fornece endpoints de monitoramento (/health, /metrics) Por que precisa: Útil para verificar se a aplicação está rodando - O que faz: Fornece endpoints de monitoramento (/health, /metrics) - Por que precisa: Útil para verificar se a aplicação está rodando - O que faz: Permite criar APIs REST (endpoints HTTP) - Por que precisa: Vamos criar endpoints para gerenciar faturas - O que faz: Reinicia automaticamente a aplicação quando você salva o código - Por que precisa: Agiliza o desenvolvimento, você não precisa parar e iniciar manualmente - O que faz: Fornece endpoints de monitoramento (/health, /metrics) - Por que precisa: Útil para verificar se a aplicação está rodando - Clique no botão GENERATE (no final da página) - Um arquivo .zip será baixado automaticamente - Salve em uma pasta que você lembre (ex: ~/Documentos/projetos/) - Abra o IntelliJ IDEA - Clique em File → Open - Navegue até a pasta invoice-service e selecione-a - Clique em OK - Aguarde o IntelliJ baixar as dependências (veja a barra de progresso no canto inferior) - src/main/kotlin/ - Onde fica seu código fonte - src/main/resources/ - Arquivos de configuração - src/test/ - Onde ficam os testes - build.gradle.kts - Configurações do projeto e dependências - No IntelliJ, navegue até: src/main/kotlin/com/invoice/ - Clique com botão direito em invoice → New → Package - Digite: controller e pressione Enter - Repita os passos 2-3 para criar: service model repository - Controller: Recebe as requisições HTTP (ex: POST /invoices) - Service: Contém as regras de negócio (ex: calcular juros) - Model: Define estruturas de dados (ex: classe Invoice) - Repository: Conversa com banco de dados - Localize: src/main/resources/application.properties - Clique com botão direito → Refactor → Rename - Renomeie para: application.yml - server.port: 8080 - A aplicação rodará em http://localhost:8080 - spring.application.name - Nome da aplicação (útil em logs) - logging.level - Mostra logs detalhados do seu código (útil para debug) - Abra o arquivo InvoiceServiceApplication.kt - Você verá um código assim: - Clique no ícone ▶️ verde ao lado de fun main - Selecione Run 'InvoiceServiceApplication' - Abra seu navegador - Acesse: http://localhost:8080 - Você verá uma página de erro "Whitelabel Error Page" - [ ] Projeto gerado com Java 17+ - [ ] Linguagem: Kotlin - [ ] Dependências: Spring Web e Spring DevTools - [ ] Projeto baixado e descompactado - [ ] Projeto importado no IntelliJ - [ ] Pacote controller criado - [ ] Pacote service criado - [ ] Pacote model criado - [ ] Pacote repository criado - [ ] Arquivo .properties renomeado para .yml - [ ] Porta configurada: 8080 - [ ] Nome da aplicação definido - [ ] Nível de log configurado - [ ] Aplicação compila sem erros - [ ] Console mostra "Started InvoiceServiceApplication" - [ ] http://localhost:8080 retorna página de erro do Spring (esperado!) - No IntelliJ: File → Project Structure → Project - Configure SDK para Java 17 - Em Language Level, selecione 17 - Sealed types, always-strict floating-point... - No terminal: lsof -i :8080 (veja qual processo está usando) - Mate o processo ou mude a porta no application.yml para 8081 - No terminal, dentro da pasta do projeto: - File → Settings → Plugins - Procure por "Kotlin" - Clique em Install - Reinicie o IntelliJ - POST /invoices - Cria uma nova fatura - GET /invoices/123 - Busca a fatura de ID 123 - Baixa bibliotecas (dependências) que seu projeto precisa - Compila seu código - Empacota tudo em um arquivo .jar executável