Skip to content

15. Apêndices

15.1. O SGBD MySQL com o Laragon

Os Capítulos 10 e 11 deste documento usam o SGBD MySQL 8. A maneira mais fácil de instalá-lo no Windows é instalar o Laragon, um ambiente de desenvolvimento portátil que inclui o MySQL, o cliente gráfico HeidiSQL, um terminal configurado, o Apache e o PHP. O autor também o utiliza em seus cursos de PHP.

15.1.1. Instalação

O Laragon pode ser baixado em https://laragon.org. O processo de instalação é padrão; você pode manter a pasta de instalação sugerida ([C:\laragon]). O Laragon fornece o MySQL 8 (a versão exata depende da versão do Laragon), com uma conta de administrador [root] que não tem senha e um servidor escutando na porta 3306 na máquina local. Essa é a configuração presumida pelos exemplos do documento, nos quais as URLs JDBC têm a forma:

jdbc:mysql://localhost:3306/dbarticles

com o nome de usuário [root] e uma senha vazia. Se o MySQL foi instalado de outra forma, com uma senha para [root], você deve atualizar os exemplos de acordo (arquivos [.properties] ou constantes no início dos programas).

Em um sistema sem o Laragon, você também pode instalar o MySQL Community Server a partir de https://dev.mysql.com/downloads/mysql/, ou de seu derivado de código aberto, o MariaDB. No entanto, os exemplos foram testados apenas com o MySQL 8: os scripts do Capítulo 10 usam um collation específico do MySQL 8 ([utf8mb4_0900_ai_ci]), e com o MariaDB seria necessário adaptá-lo, assim como o driver JDBC (o MariaDB fornece o seu próprio).

15.1.2. Iniciando e parando o MySQL

A janela principal do Laragon inclui um botão “Start All” que inicia os servidores (Apache e MySQL) e um botão “Stop” que os interrompe. O MySQL não é um serviço do Windows executado na inicialização do sistema: ele só roda quando iniciado pelo Laragon, o que evita que consuma recursos quando não está em uso. O menu do Laragon (clique com o botão direito na janela) também permite iniciar apenas o MySQL e selecionar sua versão.

Quando o MySQL não está em execução, os programas dos Capítulos 10 e 11 falham com uma exceção do driver JDBC indicando que não foi possível estabelecer uma conexão ([CommunicationsException]: “Communications link failure”): essa é a primeira coisa a verificar em caso de erro.

15.1.3. O cliente de linha de comando

O botão Terminal do Laragon abre um terminal no qual os comandos do Laragon estão disponíveis, incluindo o cliente de linha de comando do MySQL ([mysql]). Para se conectar ao servidor, use:

> mysql -u root

em seguida, digite comandos SQL terminados por ponto e vírgula ([show databases;], [use dbarticles;], [select * from articles;]) e [exit] para sair. O cliente também pode executar um script SQL, que é o que o Capítulo 10 faz para criar seus bancos de dados:

1
2
3
> cd java-oct-2026\10-jdbc\sql
> mysql -u root < dbarticles.sql
> mysql -u root < dbtaxes.sql

Os scripts recriam completamente seu banco de dados a cada execução: você pode executá-los novamente para restaurar os dados ao estado inicial após os testes.

15.1.4. O cliente gráfico HeidiSQL

O botão Database do Laragon inicia o cliente gráfico HeidiSQL. Na primeira execução, o HeidiSQL oferece uma sessão de conexão já configurada para o servidor MySQL do Laragon (host [127.0.0.1], usuário [root], senha em branco, porta 3306); basta abri-la. Você verá:

  • à esquerda, a árvore dos bancos de dados do servidor e de suas tabelas;
  • à direita, abas que mostram a estrutura de uma tabela, seus dados (que podem ser editados diretamente) e um campo para digitar consultas SQL (a aba “Query”), que são executadas com [F9].

Para criar um banco de dados usando um script do Capítulo 10, abra o script (pelo menu “File”, usando o comando para carregar um arquivo SQL) em uma aba de consulta e execute-o ([F9]). Você também pode criar um banco de dados, um usuário e permissões de usuário pelos menus do HeidiSQL (clique com o botão direito na conexão / “Create New” / "Database"; menu "Tools" / "User Manager"), mas os scripts SQL têm a vantagem de serem reproduzíveis e de poderem ser executados novamente.

As IDEs também podem se conectar a um banco de dados: o IntelliJ IDEA por meio de sua janela “Database”, o VS Code por meio de uma extensão como “SQLTools” ou “MySQL”.

15.1.5. Os bancos de dados deste documento

Os Capítulos 10 e 11 usam os bancos de dados a seguir, todos localizados no servidor MySQL local:

Banco de dados
Capítulo
Criação
[dbarticles]
10
Script [10-jdbc/sql/dbarticles.sql]: tabela [articles] dos exemplos de JDBC
[dbtaxes]
10
script [10-jdbc/sql/dbtaxes.sql]: a tabela [brackets] da versão 6 da aplicação [Tax] e o usuário [admtaxes]
[hbfirst], [hbarticles], [hbshop], [hbclients], [hbconcurrency]
11
criados pelos próprios programas (opção [createDatabaseIfNotExist=true] da URL JDBC; tabelas criadas pelo Hibernate ou por scripts versionados)
[hbtaxes]
11
Criado e populado pelo programa [CreateDatabase] na versão 7 da aplicação [Tax]

Concluídos os testes, um banco de dados pode ser excluído com o comando SQL [drop database name;], no cliente [mysql] ou no HeidiSQL.

15.2. Dependências Maven utilizadas

A tabela a seguir resume as bibliotecas usadas pelos projetos Maven deste documento, com as versões nas quais os exemplos foram testados. Elas são baixadas automaticamente do Maven Central pelo comando [mvn] (ou pelo comando da IDE) quando um projeto é compilado pela primeira vez, junto com as bibliotecas das quais dependem: portanto, é necessário acesso à Internet nesse momento.

Biblioteca (groupId:artifactId)
Versão
Capítulos
[tools.jackson.core:jackson-databind] (Jackson 3)
3.1.5
5, 6, 12, 13
[org.junit.jupiter:junit-jupiter] (JUnit 6)
6.0.3
6, 10
[org.springframework:spring-context] (Spring Framework)
7.0.9
6, 10, 11, 12
[org.springframework:spring-orm]
7.0.9
11
[com.mysql:mysql-connector-j] (driver JDBC do MySQL)
9.7.0
10, 11
[com.zaxxer:HikariCP] (pool de conexões)
7.0.2
10, 11
[ch.qos.logback:logback-classic] (logging)
1.5.38
10, 11
[org.hibernate.orm:hibernate-core] (Hibernate ORM)
7.4.5.Final
11
[org.eclipse.angus:angus-mail] (Jakarta Mail)
2.0.3
12
[org.springframework.boot:spring-boot-starter-parent] e [spring-boot-starter-webmvc] (Spring Boot)
4.1.1
13

Os plugins Maven utilizados são [maven-compiler-plugin] 3.15.0, [maven-surefire-plugin] 3.5.6 (execução de testes), [exec-maven-plugin] 3.5.1 ([mvn exec:java]) e [spring-boot-maven-plugin] 4.1.1 ([mvn spring-boot:run]). Os projetos da aplicação [Tax] dos Capítulos 10 a 13 também dependem dos módulos [examples.tax:tax-dao], [tax-business] e [tax-ui] (versão 5.0), que devem ser instalados no repositório local com o comando [mvn install] executado na [06-architectures/TaxV5] pasta (Capítulo 6).