3 - Criando projetos

Olá pessoal! Nesta terceira etapa do tutorial de criando APIs com Spring Boot, iremos criar nosso primeiro projeto:

1º Com o Visual Studio Code aberto, vamos abrir a paleta de comandos, para isso no menu superior procure por Ver -> Paleta de comandos, caso o Visual Studio esteja em inglês procure por: View -> Command Palette.

O próximo passo é digitarmos o termo Spring e selecionar a opção: Spring Initializr: Create a Maven Project..., a imagem abaixo mostra como deve estar seu Visual Studio Code agora:

2º Agora precisaremos especificar a versão do Spring Boot, neste tutorial utilizo a versão 2.6.3, aconselho fortemente a deixar selecionada a primeira opção da lista de versões, pois é a versão mais estável do Spring Boot:

3º Podemos selecionar o tipo de linguagem que queremos desenvolver utilizando nosso Spring, para isso podemos escolher entre: Java, Kotlin e Groovy, selecione a opção Java e vamos em frente:

4º Nosso próximo passo é especificar o agrupamento para o projeto. A criadora do Java (Sun Microsystems) implementou um padrão para facilitar a localização de arquivos em projetos Java, seguindo as boas práticas é utilizado o prefixo do domínio da empresa, vamos utilizar de exemplo o meu site: https://www.ralflima.com, sendo assim poderia criar um pacote com a nomenclatura: com.ralflima.

Podemos implementar o nome do pacote, informando as iniciais de cada país, exemplo:

• Brasil: br.com.ralflima
• México: mx.com.ralflima
• Japão: jp.co.ralflima

É o mesmo padrão utilizado para acessar um site de determinado país, em nosso projeto iremos colocar o nome: br.com.projeto, o nome do agrupamento não irá interferir em nosso projeto, sendo assim fique à vontade para criar agrupamento que quiser. Importante que cada ponto será criada uma pasta, sendo assim haverá a pasta: br, dentro dela haverá a pasta com e em seguida uma outra pasta chamada projeto, em caso de dúvidas, observe a imagem abaixo:

5º Neste passo iremos especificar o id do projeto, que basicamente é o nome dele. Utilizei o nome: api, fique à vontade em utilizar um outro nome caso desejar:

6º Precisamos especificar o topo de empacotamente para o projeto, iremos utilizar o Jar, abaixo deixarei uma breve explicação entre os tipos JAR e WAR:

• Jar: Contêm todas as classes base para trabalhar com a linguagem Java.
• War: Contêm as classes base para trabalhar com Java e suporte para manipular servlets e arquivos JSP.

7º Será necessário informar a versão do Java, aconselho fortemente utilizar a mesma versão instalada em seu computador. Neste tutorial estava com o JDK 17 instalado, sendo assim a versão escolhida para gerar o projeto também foi a 17, caso o projeto seja gerado em uma versão diferente do JDK, pode resultar em erros de compilação.

8º Nossa última etapa é selecionar as dependências, que servem para especificarmos as funcionalidades que nossa aplicação terá, selecione as seguintes:

• Spring Boot DevTools: Configuração base do Spring, além de atualizar o servidor automaticamente sempre que algum arquivo for alterado.
• Spring Web: Responsável por criar aplicações RESTful, utilizando o Spring MVC.

Quando selecionadas as duas dependências, clique na opção: Selected 2 dependencies., espere um pouco e depois abra o projeto criado.

A estrutura de projetos em Spring Boot são baseadas nos seguintes arquivos e pastas:

• .mvn: Nesta pasta teremos as configurações para o funcionamento do Maven. Vale lembrar que o Maven é um gerenciado de dependências, com ele podemos gerenciar diversos complementos que o Spring pode utilizar nos projetos, como: Spring Security, conexões com bancos de dados, utilização de JPA (ORM), estrutura para APIs, JWT para trabalhar com tokens, entre outras dependências.
• src: É nesta pasta que você irá desenvolver toda a estrutura do projeto, além do projeto, você pode realizar algumas configurações no arquivo application.properties, como: conexões com banco de dados, alterar a porta de funcionamento, habilitar log de ações, entre outras funcionalidades.
• mvnw e mvnw.cmd: São arquivos de configuração do Maven.
• pom.xml: É considerado o "cérebro" do nosso projeto, pois ele terá todo o "conhecimento" necessário para realizarmos diversas funcionalidades em nossos projetos, como: conexões com bancos de dados, configuração de servidor, segurança de aplicações, envio de e-mails, entre outras ações. É neste arquivo que iremos especificar todas as dependências que desejamos utilizar nos projetos.

Ficou com alguma dúvida? Se não conseguiu executar algum dos passos acima, assista o vídeo abaixo: