15. Apéndices
15.1. El SGBD MySQL con Laragon
Los Capítulos 10 y 11 de este documento utilizan el SGBD MySQL 8. La forma más sencilla de instalarlo en Windows es instalar Laragon, un entorno de desarrollo portátil que incluye MySQL, el cliente gráfico HeidiSQL, una terminal configurada, Apache y PHP. El autor también lo utiliza en sus cursos de PHP.
15.1.1. Instalación
Laragon se puede descargar desde https://laragon.org. La instalación es estándar; puede utilizar la carpeta de instalación sugerida ([C:\laragon]). Laragon proporciona MySQL 8 (la versión exacta depende de la versión de Laragon), con una cuenta de administrador [root] que no tiene contraseña y un servidor que escucha en el puerto 3306 de la máquina local. Esta es la configuración que suponen los ejemplos del documento, donde la URL JDBC tiene la forma:
con el nombre de usuario [root] y una contraseña vacía. Si MySQL se instaló de otra manera, con una contraseña para [root], deberá actualizar los ejemplos en consecuencia (archivos [.properties] o constantes al inicio de los programas).
En un sistema sin Laragon, también puede instalar MySQL Community Server desde https://dev.mysql.com/downloads/mysql/, o su derivado de código abierto, MariaDB. Sin embargo, los ejemplos solo se han probado con MySQL 8: los scripts del Capítulo 10 usan una colación específica de MySQL 8 ([utf8mb4_0900_ai_ci]), y con MariaDB habría que adaptarlos, al igual que el controlador JDBC (MariaDB proporciona el suyo).
15.1.2. Inicio y detención de MySQL
La ventana principal de Laragon incluye un botón “Start All” que inicia los servidores (Apache y MySQL) y un botón “Stop” que los detiene. MySQL no es un servicio de Windows que se ejecute al iniciar el sistema: solo se ejecuta cuando se inicia desde Laragon, lo que evita que consuma recursos cuando no se utiliza. El menú de Laragon (clic derecho en la ventana) también permite iniciar solo MySQL y elegir su versión.
Cuando MySQL no se está ejecutando, los programas de los Capítulos 10 y 11 fallan con una excepción del controlador JDBC que indica que no se pudo establecer ninguna conexión ([CommunicationsException]: “Communications link failure”): es lo primero que se debe verificar en caso de error.
15.1.3. El cliente de línea de comandos
El botón Terminal de Laragon abre una terminal donde se puede acceder a los comandos de Laragon, entre ellos el cliente de línea de comandos de MySQL ([mysql]). Para conectarse al servidor, utilice:
Luego ingrese los comandos SQL, cada uno terminado con un punto y coma ([show databases;], [use dbarticles;], [select * from articles;]) y [exit] para salir. El cliente también puede ejecutar un script SQL, que es lo que hace el Capítulo 10 para crear sus bases de datos:
Los scripts recrean por completo su base de datos cada vez que se ejecutan: puede volver a ejecutarlos para restablecer los datos a su estado inicial después de las pruebas.
15.1.4. El cliente gráfico HeidiSQL
El botón Database de Laragon abre el cliente gráfico HeidiSQL. En el primer inicio, HeidiSQL ofrece una sesión de conexión ya configurada para el servidor MySQL de Laragon (host [127.0.0.1], usuario [root], contraseña en blanco, puerto 3306); basta con abrirla. Verá:
- a la izquierda, la vista de árbol de las bases de datos del servidor y sus tablas;
- a la derecha, pestañas que muestran la estructura de una tabla, sus datos (que se pueden editar directamente) y un campo para ingresar consultas SQL (la pestaña “Query”), que se ejecutan con [F9].
Para crear una base de datos mediante un script del Capítulo 10, abra el script (desde el menú “File”, con el comando para cargar un archivo: SQL) en una pestaña de consulta y luego ejecútelo ([F9]). También puede crear una base de datos, un usuario y permisos de usuario mediante los menús de HeidiSQL (clic derecho en la conexión / “Create New” / "Database"; menú "Tools" / "User Manager"), pero los scripts SQL tienen la ventaja de ser reproducibles y de poder volver a ejecutarse.
IntelliJ IDEA también puede conectarse a una base de datos mediante su ventana “Database”: allí se pueden ver las tablas y sus datos, y ejecutar consultas SQL sin salir del IDE.
15.1.5. Bases de datos de este documento
Los Capítulos 10 y 11 utilizan las siguientes bases de datos, todas ubicadas en el servidor MySQL local:
Base de datos | Capítulo | Creación |
[dbarticles] | 10 | Script [10-jdbc/sql/dbarticles.sql]: tabla [articles] de los ejemplos de JDBC |
[dbtaxes] | 10 | script [10-jdbc/sql/dbtaxes.sql]: la tabla [brackets] de la versión 6 de la aplicación [Tax] y el usuario [admtaxes] |
[hbfirst], [hbarticles], [hbshop], [hbclients], [hbconcurrency] | 11 | creadas por los propios programas (opción [createDatabaseIfNotExist=true] de la URL JDBC; tablas creadas por Hibernate o por scripts versionados) |
[hbtaxes] | 11 | creada y poblada por el programa [CreateDatabase.kt] en la versión 7 de la aplicación [Tax] |
Una vez finalizadas las pruebas, se puede eliminar una base de datos con el comando SQL [drop database name;], en el cliente [mysql] o en HeidiSQL.
15.2. Dependencias utilizadas por los proyectos de Gradle
La siguiente tabla resume las bibliotecas declaradas por los proyectos de Gradle del documento (archivos [build.gradle.kts]), junto con sus versiones. Gradle (o IntelliJ IDEA) las descarga automáticamente desde Maven Central durante la primera compilación de un proyecto, junto con las bibliotecas de las que dependen: por lo tanto, se requiere acceso a Internet en ese momento.
Biblioteca (grupo:artefacto) | Versión | Capítulos |
[org.jetbrains.kotlin:kotlin-stdlib], [kotlin-reflect], [kotlin-test] (agregadas o con versión definida por el complemento de Kotlin) | 2.4.20 | todos ([kotlin-test]: 6, 10; [kotlin-reflect]: 13) |
[org.jetbrains.kotlinx:kotlinx-coroutines-core] (corrutinas) | 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] (controlador JDBC de MySQL) | 9.7.0 | 10, 11 |
[com.zaxxer:HikariCP] (grupo de conexiones) | 7.0.2 | 10, 11 |
[ch.qos.logback:logback-classic] (registro de eventos) | 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, versión determinada por su convención de nomenclatura) | 4.1.1 | 13 |
Los complementos de Gradle utilizados son [org.jetbrains.kotlin.jvm] ([kotlin("jvm")]), [org.jetbrains.kotlin.plugin.spring], y [org.jetbrains.kotlin.plugin.jpa] / [org.jetbrains.kotlin.plugin.allopen] (complementos del compilador para Spring e Hibernate), todos en la versión 2.4.20, el complemento de Gradle [application] ([gradlew run]), el complemento [org.springframework.boot] 4.1.1 ([gradlew bootRun]) y, en el archivo [settings.gradle.kts] de cada compilación, el complemento [org.gradle.toolchains.foojay-resolver-convention] 1.0.0, que descarga JDK 25 si no está instalado (Capítulo 2). El wrapper de cada proyecto utiliza Gradle 9.8.0. Los proyectos de la aplicación [Tax] de los Capítulos 10 a 13 también dependen de los subproyectos [examples.tax:tax-dao], [tax-business] y [tax-ui] (versión 5.0) del Capítulo 6: gracias a la compilación compuesta ([includeBuild("../06-architectures")]), Gradle los compila por sí mismo a partir de su código fuente, sin necesidad de publicarlos previamente.