Construindo uma API com Java/Spring/Hibernate: criando o projeto

Nos últimos meses, tive a oportunidade de trabalhar com design de código nas stacks Java/Kotlin + Spring + Hibernate. Como forma de revisitar essa experiência e compartilhar um pouco do que aprendi, farei algumas postagens sobre diferentes aspectos da construção de APIs usando essas tecnologias. A ideia não é criar um tutorial completo, mas um guia para quem está começando e deseja praticar.

Objetivo

Criar um projeto Java/Spring e abri-lo na IDE. Este é o primeiro passo para botar a mão no código e começar a escrever uma aplicação.

Requisitos

• Ter o JDK instalado na máquina. Existem muitos tutoriais disponíveis para auxiliar neste ponto. Um que segui e me ajudou bastante foi este vídeo do DevSuperior.
• Ter uma IDE instalada. Atualmente, uso o IntelliJ.

Criando a aplicação

Usar um framework é uma decisão que envolve vantagens e desvantagens. Essas questões não serão tratadas em detalhes aqui, exceto por um ponto: criar um projeto em Spring é bastante facilitado pela ferramenta spring intializr.

Este site permite (1) definir a ferramenta de build/gestão de dependência, a linguagem que será usada no projeto e a versão do Spring Boot; (2) definir os metadados do projeto (junto com a versão Java); e (3) adicionar as dependências desejadas - dependências essas que podem ser complementadas em um momento posterior, manualmente. Além de gerar o projeto base, (4) é possível explorar como será construída a estrutura do projeto e compartilhar a configuração via URL.

Um ponto que notei após acompanhar diversos tutoriais é que o site do initializr constantemente passa por atualizações. Por isso, a versão que você está vendo não necessariamente é a mesma do print acima, que serve apenas como referência das principais seções.

ERRATA: se você notar, adicionei tanto a dependência H2 Database quanto a PostgreSQL Driver na geração do projeto. Uma boa prática é utilizar as duas juntas em um cenário de TDD/testes automatizados, onde o banco em memória roda os testes e o Postgres é utilizado para desenvolvimento. Para facilitar as coisas, e não gerar erros de configuração nos próximos passos, recomendo que você escolha apenas um tipo de banco apenas para começar.

Ao clicar em Generate, um arquivo .zip contendo o projeto será baixado para a pasta de downloads do seu computador.

Abrindo o projeto na IDE

O próximo passo é extrair o conteúdo deste arquivo para uma pasta de sua preferência. Isso feito, abra o IntelliJ, vá até o menu File > Open e selecione a pasta onde o projeto se encontra.

Pronto! O projeto está aberto na IDE e pronto para iniciar os trabalhos.

Obs: pode ser que ao abrir o IntelliJ apareça um pop-up, ao invés da tela do programa aberta como no print acima. Não tem problema, a partir do pop-up também é possível abrir projetos existentes.

Conclusão

A ideia desse artigo foi criar um novo projeto e deixá-lo pronto na IDE para começar a codar. Existem diversos detalhes envolvidos na definição da stack e das ferramentas que serão utilizadas no projeto (qual ferramenta de build, quais dependências, etc). Me parece que são bons temas para futuros artigos. Confesso que não tenho uma série de temas definidos para escrever na sequência sobre a criação de uma API. Por enquanto, existem várias ideias que estão no radar.

Espero que este artigo tenha ajudado! Se tiver comentários, dúvidas ou sugestões, me envia uma mensagem. Vai ser bem massa trocar uma ideia. Por enquanto, meus contatos estão no perfil do GitHub.

Até mais!