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. A instalação é padrão; você pode usar 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 da máquina local. Essa é a configuração presumida pelos exemplos do documento, em que a URL JDBC tem 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 o [root], é necessário atualizar os exemplos de acordo (arquivos [.properties] ou constantes no início dos programas).

Em um sistema sem o Laragon, também é possível instalar o MySQL Community Server a partir de https://dev.mysql.com/downloads/mysql/, ou o 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 uma collation específica do MySQL 8 ([utf8mb4_0900_ai_ci]), e com o MariaDB seria necessário adaptá-los, 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ó é executado 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 escolher a 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 em que os comandos do Laragon estão acessíveis, incluindo o cliente de linha de comando do MySQL ([mysql]). Para se conectar ao servidor, use:

> mysql -u root

Em seguida, digite os comandos SQL, cada um terminando com um 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 kotlin-oct-2026\10-jdbc\sql
> mysql -u root < dbarticles.sql
> mysql -u root < dbtaxes.sql

Os scripts recriam completamente o 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 visão em á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, em seguida, execute-o ([F9]). Também é possível criar um banco de dados, um usuário e permissões de usuário usando os 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.

O IntelliJ IDEA também pode se conectar a um banco de dados por meio de sua janela “Database”: nela você pode visualizar as tabelas e seus dados e executar consultas SQL sem sair da IDE.

15.1.5. Bancos de dados neste documento

Os Capítulos 10 e 11 usam os seguintes bancos de dados, 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.kt] na versão 7 da aplicação [Tax]

Depois de 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 usadas pelos projetos Gradle

A tabela a seguir resume as bibliotecas declaradas pelos projetos Gradle do documento (arquivos [build.gradle.kts]), junto com suas versões. Elas são baixadas automaticamente do Maven Central pelo Gradle (ou pelo IntelliJ IDEA) durante o primeiro build de um projeto, junto com as bibliotecas das quais dependem: é necessário, portanto, acesso à Internet nesse momento.

Biblioteca (group:artifact)
Versão
Capítulos
[org.jetbrains.kotlin:kotlin-stdlib], [kotlin-reflect], [kotlin-test] (adicionadas ou com versão definida pelo plugin do Kotlin)
2.4.20
todos ([kotlin-test]: 6, 10; [kotlin-reflect]: 13)
[org.jetbrains.kotlinx:kotlinx-coroutines-core] (corrotinas)
1.11.0
9, 10, 11, 12
[tools.jackson.core:jackson-databind] (Jackson 3)
3.1.5
5, 6, 12, 13
[org.junit:junit-bom], [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, 13
[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-webmvc] (Spring Boot, versão determinada por sua convenção de nomenclatura)
4.1.1
13

Os plugins Gradle usados são [org.jetbrains.kotlin.jvm] ([kotlin("jvm")]), [org.jetbrains.kotlin.plugin.spring] e [org.jetbrains.kotlin.plugin.jpa] / [org.jetbrains.kotlin.plugin.allopen] (plugins do compilador para Spring e Hibernate), todos na versão 2.4.20, o plugin Gradle [application] ([gradlew run]), o plugin [org.springframework.boot] 4.1.1 ([gradlew bootRun]) e, no arquivo [settings.gradle.kts] de cada build, o plugin [org.gradle.toolchains.foojay-resolver-convention] 1.0.0, que baixa o JDK 25 se ele não estiver instalado (Capítulo 2). O wrapper de cada projeto usa o Gradle 9.8.0. Os projetos da aplicação [Tax] dos Capítulos 10 a 13 também dependem dos subprojetos [examples.tax:tax-dao], [tax-business] e [tax-ui] (versão 5.0) do Capítulo 6: graças ao composite build ([includeBuild("../06-architectures")]), o Gradle os compila a partir do código-fonte, sem necessidade de publicá-los antes.