13. Apêndices
13.1. Instalação do JDK 21
O [JDK] ([Java Development Kit]) contém o compilador [javac] e a máquina virtual [java]. Há várias distribuições gratuitas; usamos o [Eclipse Temurin], do projeto [Adoptium], que pode ser baixado em adoptium.net: selecione a versão 21 (LTS) e, em seguida, o instalador para o seu sistema ([Windows] x64, [macOS], [Linux]).
No [Windows], o instalador [.msi] oferece a opção “Set JAVA_HOME variable” na tela de personalização; essa opção vem desativada por padrão — é preciso ativá-la. A variável de ambiente [JAVA_HOME] indica a localização do [JDK]; o Maven Wrapper a utiliza para localizar o [Java]. Você também pode usar o gerenciador de pacotes [winget]:
No [macOS], use o instalador [.pkg] da mesma página ou o gerenciador de pacotes [Homebrew] ([brew install --cask temurin@21]). No [Linux] ([Ubuntu], por exemplo), serve o pacote [openjdk-21-jdk] dos repositórios da distribuição:
Verifique a instalação em um novo console ([PowerShell], prompt de comando ou terminal):
que deve exibir um número de versão começando com 21 (por exemplo, [openjdk version "21.0.10"]). Um [JDK] mais recente (25, por exemplo) também funciona; um [JDK] mais antigo (17, por exemplo) produz o erro [release version 21 not supported] durante a compilação.
13.2. Maven e o Maven Wrapper
Não há nada a instalar: a pasta [examples] e a pasta do estudo de caso contêm, cada uma, o Maven Wrapper, os scripts [mvnw] ([Linux], [macOS]) e [mvnw.cmd] ([Windows]), junto com o arquivo [.mvn/wrapper/maven-wrapper.properties], que especifica a versão do [Maven] a ser usada (3.9.11). Na primeira execução, o script baixa essa versão do [Maven] e a armazena no diretório pessoal do usuário (pasta [.m2/wrapper]); as execuções seguintes a reutilizam. [Maven], por sua vez, baixa as bibliotecas do projeto do repositório Maven Central e as armazena na pasta [.m2/repository]. Portanto, é necessária uma conexão com a Internet durante a primeira compilação.
O Maven Wrapper requer o [Java]: ele usa o [JDK] especificado pela variável [JAVA_HOME]ou, na falta dela, o comando [java] encontrado no caminho ([PATH]). Para verificar se tudo está em ordem, compile todos os exemplos a partir da pasta [examples]:
([.\mvnw compile] no [Windows]). O comando termina com [BUILD SUCCESS].
Se preferir instalar o [Maven] por conta própria (maven.apache.org), o comando [mvn] substitui [mvnw] em todos os comandos do documento.
13.3. Instalação do Visual Studio Code
Baixe o [Visual Studio Code] em code.visualstudio.com. Adicione duas extensões (vá ao menu View > Extensions e pesquise pelos nomes delas):
- [Extension Pack for Java], da Microsoft: um conjunto de extensões que oferece realce de sintaxe, autocompletar código e relatório de erros para código [Java]; suporte a projetos [Maven] (painel Java Projects); o depurador e a compilação automática de cada arquivo salvo;
- [Spring Boot Extension Pack], da VMware (marketplace.visualstudio.com): autocompletar de propriedades para [application.properties], navegação entre beans e URLs dos controllers e o painel Spring Boot Dashboard, que lista as aplicações [Spring Boot] da pasta aberta e permite iniciar ou parar cada uma com um único clique.
Abra a pasta [examples] ou a pasta do estudo de caso (menu File / Open Folder); o terminal integrado (menu Terminal / New Terminal) permite executar comandos [mvnw] sem sair do editor. A tecla F5, na classe de inicialização de uma aplicação (aquela anotada com [@SpringBootApplication]), executa a aplicação sob o controle do depurador.
13.4. Instalação do MySQL com o Laragon
O [Laragon] (laragon.org) instala um servidor [MySQL] (ou [MariaDB]) pronto para uso, junto com a ferramenta de administração [HeidiSQL]. Após a instalação:
- o botão “Start All” inicia o servidor [MySQL] na porta 3306;
- o usuário [root] não tem senha: esses são os valores padrão das propriedades [spring.datasource.*] do Exemplo 28 e do estudo de caso;
- O botão Database abre o [HeidiSQL], onde o item de menu File / Run SQL file executa os scripts [dbpersons.sql] (Exemplo 28) e [dbrdvmedecins2.sql] (estudo de caso).
No [Linux] ou no [macOS], instale o [MySQL] ou o [MariaDB] usando o gerenciador de pacotes do sistema e execute os scripts com o cliente de linha de comando [mysql]. O driver [JDBC] do [MySQL] também funciona com o [MariaDB] sem nenhuma configuração: [Hibernate] apenas exibe o aviso [HHH000511] na inicialização, sem consequências (veja o Exemplo 28).
13.5. Instalação do curl
O [curl] vem incluído no [Windows] 10 e 11, no [macOS], e na maioria das distribuições [Linux]. No [PowerShell], é preciso digitar [curl.exe], e não [curl]: em versões mais antigas do [PowerShell], [curl] é um alias de outro comando ([Invoke-WebRequest]), que tem opções diferentes.