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:
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:
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:
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).