Capítulo 1

Introdução
Fala, mergulhador!

Meu nome é Thiago Faria, sou fundador e instrutor da AlgaWorks.

Neste workbook eu vou te ajudar a preparar o seu ambiente de

desenvolvimento para que você consiga acompanhar o curso
Intensivão Spring REST, que vai acontecer de 18 a 25 de março de
2024.

Vamos lá?

2
Capítulo 2

Instalando o JDK
Para desenvolver aplicações de back-end com Java, precisamos do
Kit de Desenvolvimento Java (JDK) instalado.

Eu recomendo que você instale o OpenJDK, que é uma

implementação open source da plataforma Java SE.

Nós vamos usar o Java 21, que é a última versão LTS (Long-Term
Support, ou seja, versões que possuem suporte de longo prazo) neste
momento.

2.1. Windows
Vamos usar a distribuição Temurin, o OpenJDK da Adoptium (antigo
AdoptOpenJDK), que fornece os binários do OpenJDK de forma
gratuita e confiável para uso em produção. Você pode usar outra
distribuição, se quiser.

Faça download do arquivo de instalação (extensão .msi) do OpenJDK

3
 21 em https://adoptium.net/.

Execute o arquivo para iniciar o processo de instalação e siga os

passos (basicamente, clique em Next várias vezes).

Quando chegar na parte de Custom Setup, adicione a feature para

definir a variável JAVA_HOME, como na imagem abaixo:

Continue clicando em Next até concluir o processo de instalação.

Quando a instalação estiver concluída, abra o Prompt de Comando

4
e digite os comandos abaixo, para verificar se foi instalado
corretamente:

$ java -version
$ javac -version

Você deve ver a versão do JDK instalado.

2.2. macOS e Linux

Usaremos o SDKMAN! para instalar o JDK no macOS ou Linux.

O SDKMan! é uma ferramenta para gerenciar instalações de diversos

SDKs em sistemas baseados em Unix, como Linux, macOS e até
mesmo Windows (usando WSL ou outras alternativas, porém é um
pouco mais complexo).

O legal de usar esta ferramenta é que, a partir de um comando,

nós podemos instalar, desinstalar ou trocar a versão do JDK que

5
 queremos usar.

Se você estiver usando Ubuntu, antes de instalar o SDKMAN!, abra o

terminal e digite os comandos abaixo, para atualizar a lista de pacotes
disponívels pela ferramenta de gerenciamento de pacotes (APT) e
instalar algumas dependências, caso você ainda não tenha:

$ apt update
$ apt install curl zip unzip --yes

Feito isso, no macOS ou Linux, digite o comando abaixo para iniciar

a instalação da ferramenta:

$ curl -s "https://get.sdkman.io" | bash

Quando a execução for finalizada com sucesso, digite o comando

para habilitar a ferramenta no terminal que já está aberto:

$ source "$HOME/.sdkman/bin/sdkman-init.sh"

Pronto! Agora é só usar o SDKMAN! para instalar o JDK.

Vamos usar a distribuição Temurin, o OpenJDK da Adoptium (antigo

AdoptOpenJDK), que fornece os binários do OpenJDK de forma
gratuita e confiável para uso em produção. Você pode usar outra
distribuição, se quiser.

Digite o comando abaixo para instalar o JDK 21 da Adoptium

(Temurin):

6
$ sdk install java 21.0.2-tem

Aguarde a instalação ser concluída. Quando finalizar, verifique se a

versão correta foi instalada com os comandos abaixo:

$ java -version
$ javac -version

7
 Capítulo 3

Instalando o IntelliJ
IDEA
O IntelliJ IDEA é uma IDE para desenvolvimento de projetos Java,
considerada por quem usa como a melhor IDE do mundo.

Nós vamos usar o IntelliJ IDEA Community, que é uma distribuição

gratuita e muito boa.

Para desenvolver projetos com Spring você não precisa ficar preso ao
IntelliJ IDEA. Qualquer outra IDE que suporte trabalhar com projetos
Maven deve funcionar, mas minha recomendação é que você use a
mesma IDE que eu vou usar para acompanhar as aulas.

A instalação do IntelliJ IDEA é bem simples. Faça download do

arquivo de instalação de acordo com o seu sistema operacional em
https://www.jetbrains.com/idea/.

8
Quando o download for concluído, execute o arquivo e faça a
instalação conforme já está acostumado a fazer usando o seu sistema
operacional. Não tem qualquer segredo!

9
 Capítulo 4

Instalando o Postman
O Postman é uma aplicação que nos ajuda a enviar requisições HTTP
para a nossa aplicação back-end (a API), para que possamos testá-la.

Acesse o site https://www.getpostman.com/downloads/ e baixe o

instalador de acordo com o seu sistema operacional.

A instalação do Postman é super simples em todos os sistemas

10
operacionais.

No Windows, execute o instalador. No Linux ou macOS,

descompacte o arquivo .zip ou .tar.gz e inicie a aplicação executando
o arquivo Postman.

Ao iniciar o programa pela primeira vez, faça o cadastro de uma conta

ou faça o seu login, para desbloquear todas as funções gratuitas do
Postman.

Feito isso, você terá acesso ao workspace do Postman, onde usaremos

para fazer requisições e testar nossos Web Services RESTful.

11
12
Capítulo 5

Instalando o MySQL
Server
O MySQL Server é o banco de dados open source mais popular do
mundo. Vamos instalar o MySQL Community Server.

Teoricamente, você poderia usar qualquer outro banco de dados

relacional para acompanhar o curso, como PostgreSQL, Oracle
Database, SQL Server, etc.

Mas a minha recomendação é que você use o MySQL Server pelo

menos até concluir todas as aulas, para evitar distrações.

5.1. Windows
Acesse https://dev.mysql.com/downloads/windows/installer/8.0.html
e faça download do arquivo de instalação completo (extensão .msi).

13
 Execute o arquivo baixado e siga todas as etapas do assistente de
instalação com atenção.

Na etapa Choosing a Setup Type, selecione a opção Custom e depois

clique em Next. Essa opção permite que a gente defina o que
queremos instalar, para evitar a inclusão de programas ou
documentações desnecessárias.

Queremos instalar apenas o MySQL Server e MySQL Workbench

(que é uma ferramenta para gerenciar o banco de dados).

14
Na etapa Select Products, encontre e mova os seguintes produtos do
lado esquerdo para o lado direito:

• MySQL Server 8.0.x

• MySQL Workbench 8.0.x

Clique em Next logo em seguida.

Caso algum software requerido não seja encontrado, o assistente pode

tentar instalar para você.

Na etapa Check Requirements, clique no botão Execute.

15
 No meu caso (com Windows 10 novinho, sem praticamente nada
instalado), foi necessário instalar o Microsoft Visual C++.

Se este for o seu caso também, clique na caixa de seleção para

concordar com os termos e condições e depois clique no botão Install.

16
Quando a instalação do Microsoft Visual C++ for concluída, clique
no botão Close.

Continuamos na etapa Check Requirements, mas agora tudo indica

que já temos todos os programas obrigatórios instalados. Clique no
botão Next.

17
 Na etapa Installation, clique no botão Execute para iniciar a
instalação do MySQL Server e MySQL Workbench.

Agora vamos iniciar a configuração do MySQL Server. Na etapa

Product Configuration, clique no botão Next.

18
A primeira tela de configuração é a Type and Networking.

Aqui é possível configurar, por exemplo, a porta que o servidor

MySQL irá usar para receber conexões.

É muito importante que você fique atento a isso!

A porta padrão do MySQL é a 3306, porém se você já tiver algum

outro software instalado na sua máquina usando essa mesma porta,
você não conseguirá iniciar o MySQL Server.

Se este for o seu caso, altere para um outro número de porta, como
por exemplo 3307.

Anote esse número de porta, porque você vai precisar dele para
estabelecer conexão com o seu servidor MySQL.

Clique no botão Next.

Na etapa Authentication Method, não altere nada e apenas clique no

19
 botão Next.

Nesta etapa (Accounts and Roles) você deve configurar uma senha
para o usuário root, que é o administrador do servidor de banco de
dados.

Digite uma senha no campo MySQL Root Password e confirme no

campo Repeat Password.

Anote esta senha! Você vai precisar dela sempre que precisar se
conectar com o banco de dados.

Clique no botão Next quando concluir.

20
Na etapa Windows Service, você vai configurar o serviço do Windows
para iniciar o servidor MySQL sempre que o seu sistema operacional
for inicializado.

Não altere nada e apenas clique no botão Next.

21
 Estamos quase finalizando!

Na etapa Apply Configuration, clique no botão Next para que todas as

configurações sejam aplicadas.

Muito bem! Ainda em Apply Configuration, ao concluir a aplicação

das configurações, apenas clique em Finish.

22
Voltamos para Product Configuration, indicando que a configuração
está finalizada. Clique em Next.

Maravilha! A instalação e configuração do MySQL Server e MySQL

Workbench está concluída. Clique no botão Finish.

23
 5.2. macOS
Abra o terminal e instale o Homebrew (um gerenciador de pacotes
para Mac), caso ainda não tenha instalado:

$ /bin/bash -c \
"$(curl -fsSL 'https://raw.githubusercontent.com/Homebrew'\
'/install/HEAD/install.sh')"

Execute o comando abaixo para instalar o MySQL Server:

$ brew install mysql

Para iniciar o serviço do MySQL Server, execute:

24
$ brew services start mysql

5.3. Ubuntu (Linux)

Abra o terminal e digite os comandos:

$ sudo apt update

$ sudo apt install mysql-server --yes

Pronto, o MySQL Server está instalado! Agora você precisa

configurar uma senha para o usuário administrador (root).

Estabeleça uma conexão com o MySQL Server usando o client com

o comando abaixo:

$ sudo mysql

No prompt mysql>, digite os comandos abaixo:

alter user 'root'@'localhost' identified

with caching_sha2_password by 'suasenha';

grant all on *.* to 'root'@'localhost';

flush privileges;

Substitua “suasenha” pela senha que você desejar e anote em algum

local. Você vai precisar dela sempre que quiser estabelecer uma
conexão com o servidor MySQL.

25
 Aperte as teclas Ctrl+D para encerrar o cliente do MySQL.

Agora, teste a conexão usando o client do MySQL com a nova

senha configurada. Digite o comando abaixo no terminal e faça a
autenticação:

$ mysql -u root -p

Docker: Alternativa para qualquer sistema

5.4.
operacional
Docker é uma plataforma para desenvolver e rodar aplicações
isoladas em containers de forma muito simples e rápida.

Se você já usa Docker, esta é a forma mais simples de ter o MySQL

Server instalado e executando na sua máquina.

Abra o terminal e digite o comando abaixo para criar um novo

container do servidor de banco de dados na porta 3306 e sem
nenhuma senha para o usuário root:

$ docker container run -d --publish 3306:3306 \

--env MYSQL_ALLOW_EMPTY_PASSWORD=yes --name mysql8 mysql:8.0

Quando quiser parar o container, execute:

$ docker container stop mysql8

26
Para colocá-lo rodando novamente, execute:

$ docker container start mysql8

27
 Capítulo 6

Instalando o MySQL
Workbench
O MySQL Workbench é uma ferramenta para DBAs e
desenvolvedores que usam o banco de dados MySQL Server.

Vamos usá-la neste curso, mas você pode usar qualquer outra
ferramenta de sua preferência, desde que ela tenha suporte à versão
do MySQL Server que você está usando.

Se você usa Windows, pode ser que você já tenha instalado o MySQL
Workbench junto com o MySQL Server. Se esse for o caso, seu
ambiente já está pronto. Não precisa baixar e instalar o Workbench
novamente.

Caso ainda não tenha instalado, acesse https://dev.mysql.com/

downloads/workbench/ e faça download do arquivo de instalação
para o seu sistema operacional.

28
6.1. macOS
Dê um duplo clique no arquivo DMG baixado (extensão .dmg) e
depois mova a aplicação MySQLWorkbench para a pasta
Applications.

29
 Pronto! Para iniciar o MySQL Workbench, abra o Launchpad,
localize e clique na aplicação MySQLWorkbench.

6.2. Ubuntu (Linux)

Dê um duplo clique no arquivo baixado (extensão .deb) e depois
clique no botão Install para executar o processo de instalação.

Para iniciar o MySQL Workbench, abra o menu Show Applications,

localize e clique na aplicação MySQL Workbench.

30
 Testando a conexão com o MySQL
6.3.
Server
Agora vamos conferir se conseguimos estabelecer uma conexão com
o MySQL Server usando o MySQL Workbench.

Este teste é importante, porque se não funcionar, provavelmente a

aplicação que vamos desenvolver neste curso em Java também não
conseguirá se conectar.

Abra o MySQL Workbench e clique na única conexão pré-

cadastrada.

Se tudo der certo e a conexão for estabelecida com sucesso, você vai

31
 ver a tela de administração do banco de dados.

Caso apareça uma mensagem de erro dizendo Access denied for user,
não precisa se desesperar. Provavelmente você definiu uma senha na
instalação do MySQL Server e informou outra agora.

Neste caso, clique com o botão direito do mouse na conexão e depois

em Edit Connection.

32
Na tela Manage Server Connections, clique no botão Store in Vault
para configurar a senha correta ou Clear para limpar a senha
configurada no MySQL Workbench.

Aliás, nesta mesma tela você consegue alterar a porta da conexão

também. Caso você tenha instalado o MySQL Server em uma porta
diferente, não esqueça de alterar o número no campo Port também.

Caso não tenha aparecido uma conexão padrão (local) para você ao
iniciar o MySQL Workbench, clique no ícone de + ao lado de MySQL
Connections, para adicionar uma nova conexão.

33
 Preencha o campo Connection Name com qualquer nome, apenas
para identificar esta conexão, Hostname com 127.0.0.1 (que indica o
endereço local do seu computador), Port com o número da porta do
servidor (3306 é a porta padrão), Username com o nome de usuário
(por exemplo, root) e Password com a senha que você forneceu na
instalação do MySQL Server (ou não informe nada, se o usuário ficou
sem senha).

34
Capítulo 7

Conclusão
Pronto!

Agora você está preparado para mergulhar comigo nas aulas do

Intensivão.

Fique ligado no grupo de alunos do WhatsApp, porque eu posso

publicar novos conteúdos de aquecimento a qualquer momento.

E claro, não esqueça que a primeira aula do Intensivão será publicada

no dia 18 de março e o curso ficará disponível só por uma semana. É
melhor anotar na sua agenda!

Um abraço e até logo. 🤿

35