Antes do primeiro código: como organizar um projeto Java do zero

Leia. Curta. Comente. Compartilhe.

...

Criar um projeto Java do zero pode ser mais difícil do que continuar um projeto que já existe. Veja como organizar o fluxo, entender onde cada coisa deve ficar e só depois começar a codar.

...

JAVA

Você terminou alguns cursos de Java.

Já sabe criar classes, métodos, APIs, mexeu com Spring e até sabe o que é um Repository.

Aí chega o grande momento:

“Agora crie um projeto do zero.”

Você abre a IDE.

Cria o projeto.

Olha para aquela estrutura praticamente vazia e pensa:

“Legal... e agora eu começo por onde?”

Se isso acontece, talvez o problema não seja falta de conhecimento em Java.

Pode ser simplesmente falta de um mapa antes de começar a caminhada.

Não comece criando um monte de pastas

Quando você vê projetos maiores, é comum encontrar algo parecido com:

controller
service
repository
entity
dto
exception
config
security
...

A primeira vontade pode ser criar tudo igual.

Só que existe um problema:

Se você ainda não sabe por que aquela pasta existe, criá-la não vai ajudar muito.

É como comprar 15 caixas organizadoras antes de decidir o que você precisa guardar.

Primeiro entenda o projeto.

Antes da IDE, desenhe o caminho

Imagine que você quer criar uma API simples de pedidos.

Antes de escrever Java, pense:

O que precisa acontecer quando alguém criar um pedido?

Você pode desenhar:

Cliente
 ↓
Controller
 ↓
Service
 ↓
Repository
 ↓
Banco de Dados

Agora já temos um caminho.

O Controller recebe a requisição.

O Service cuida das regras e decisões da aplicação.

O Repository faz o acesso aos dados.

O Banco de Dados guarda as informações.

E a resposta depois faz o caminho de volta.

Parece simples, mas esse desenho evita muito:

“Será que coloco isso no Controller ou no Service?”

Pense em um restaurante

Imagine um cliente fazendo um pedido.

O cliente não entra na cozinha para conversar diretamente com o cozinheiro.

Existe um fluxo.

Cliente
 ↓
Garçom
 ↓
Cozinha
 ↓
Preparo

Na aplicação acontece algo parecido.

Cada parte possui uma responsabilidade.

Se todo mundo fizer tudo, daqui a pouco o garçom está fritando batata, o cozinheiro recebendo pagamento e ninguém sabe onde foi parar o pedido da mesa 7.

Organização não existe para deixar o projeto bonito. Existe para deixar claro quem faz o quê.

Faça um fluxo funcionar primeiro

Outra armadilha é querer começar o projeto já preparado para receber 3 milhões de usuários.

Calma.

Se você está criando uma API de pedidos, comece com algo pequeno:

POST /pedidos
    ↓
Controller
    ↓
Service
    ↓
Repository
    ↓
Banco

Faça esse caminho funcionar.

Depois você pode adicionar validações, DTOs, tratamento de erros, segurança e outras necessidades.

Primeiro faça uma rua funcionar. Depois pense em construir a cidade inteira.

E qual IDE usar?

Aqui entra muito mais preferência do que regra.

Você pode trabalhar com IntelliJ, Eclipse, VS Code ou outra ferramenta que faça sentido para você.

O importante é não depender da IDE para decidir a arquitetura.

A IDE ajuda você a escrever o código. O raciocínio sobre o projeto precisa acontecer antes.

Inclusive, papel e caneta podem resolver essa primeira parte muito bem.

Tecnologia de ponta:

papel + caneta + setinhas

Às vezes é tudo que você precisa para destravar.

3 dicas para começar seu próximo projeto

1. Escreva o que o sistema precisa fazer

Antes das classes, pense nas funcionalidades.

Por exemplo:

Criar pedido
Buscar pedido
Cancelar pedido
Atualizar pedido

Isso ajuda a enxergar o projeto antes de enxergar o código.

2. Desenhe pelo menos um fluxo

Escolha uma funcionalidade e acompanhe o caminho dela.

Quem recebe? Quem processa? Quem salva? Quem responde?

Se você consegue responder isso, a estrutura começa a aparecer naturalmente.

3. Não tente criar a arquitetura perfeita

Seu projeto vai mudar.

Você vai descobrir novas necessidades.

E provavelmente vai olhar para algum código depois e pensar:

“Quem foi que fez isso?”

Foi você.

Faz parte.

Organizar um projeto também é uma habilidade que melhora conforme você pratica.

Antes do primeiro código, entenda o caminho

Quando você começa um projeto do zero, não precisa saber imediatamente todas as classes, pastas e configurações que ele terá.

Comece com três perguntas:

O que meu sistema precisa fazer?

Qual caminho essa informação vai percorrer?

Quem deveria ser responsável por cada etapa?

Depois disso, abra sua IDE e comece pequeno.

Porque muitas vezes o que trava um projeto novo não é não saber programar.

É tentar escrever o código antes de entender para onde ele precisa ir.

>> Quando você começa um projeto Java do zero, também acha mais difícil decidir a estrutura do que escrever o código em si?

__

Indicação de livro

Clean Architecture

Autor: Robert C. Martin

É uma boa referência para começar a entender separação de responsabilidades e organização de software. Não precisa tentar aplicar tudo de uma vez. Vale ir lendo aos poucos e relacionando os conceitos com os projetos que você estiver construindo.