Skip to content

15. Anhänge

15.1. Das DBMS MySQL mit Laragon

In den Kapiteln 10 und 11 dieses Dokuments wird das DBMS MySQL 8 verwendet. Am einfachsten installiert man es unter Windows, indem man Laragon installiert, eine portable Entwicklungsumgebung, die MySQL, den grafischen Client HeidiSQL, ein vorkonfiguriertes Terminal, Apache und PHP enthält. Der Autor verwendet sie auch für seine PHP-Kurse.

15.1.1. Installation

Laragon kann von https://laragon.org heruntergeladen werden. Die Installation verläuft wie üblich; Sie können den vorgeschlagenen Installationsordner ([C:\laragon]) beibehalten. Laragon stellt MySQL 8 bereit (die genaue Version hängt von der Laragon-Version ab), mit einem Administratorkonto [root], das kein Passwort hat, und einem Server, der auf dem lokalen Rechner auf Port 3306 lauscht. Von dieser Konfiguration gehen die Beispiele des Dokuments aus; die JDBC-URLs haben dabei die Form:

jdbc:mysql://localhost:3306/dbarticles

mit dem Benutzernamen [root] und einem leeren Passwort. Wurde MySQL anders installiert, mit einem Passwort für [root], müssen Sie die Beispiele entsprechend anpassen ([.properties]-Dateien oder Konstanten am Anfang der Programme).

Für ein System ohne Laragon können Sie MySQL Community Server auch von https://dev.mysql.com/downloads/mysql/ installieren, oder das quelloffene Derivat MariaDB verwenden. Die Beispiele wurden jedoch nur mit MySQL 8 getestet: Die Skripte in Kapitel 10 verwenden eine MySQL-8-spezifische Kollation ([utf8mb4_0900_ai_ci]), und mit MariaDB müssten sie ebenso angepasst werden wie der JDBC-Treiber (MariaDB stellt einen eigenen bereit).

15.1.2. MySQL starten und beenden

Das Hauptfenster von Laragon enthält eine Schaltfläche „Start All“ , die die Server (Apache und MySQL) startet, und eine Schaltfläche „Stop“, die sie beendet. MySQL ist kein Windows-Dienst, der beim Systemstart läuft: Es läuft nur, wenn es über Laragon gestartet wurde, sodass es keine Ressourcen verbraucht, wenn es nicht benötigt wird. Über das Laragon-Menü (Rechtsklick im Fenster) können Sie außerdem nur MySQL starten und dessen Version auswählen.

Wenn MySQL nicht läuft, schlagen die Programme in den Kapiteln 10 und 11 mit einer Exception des JDBC-Treibers fehl, die anzeigt, dass keine Verbindung hergestellt werden konnte ([CommunicationsException]: „Communications link failure“): Dies ist bei einem Fehler das Erste, was Sie prüfen sollten.

15.1.3. Der Kommandozeilenclient

Die Schaltfläche Terminal in Laragon öffnet ein Terminal, in dem die Laragon-Befehle verfügbar sind, einschließlich des MySQL-Kommandozeilenclients ([mysql]). Um sich mit dem Server zu verbinden, verwenden Sie:

> mysql -u root

Geben Sie dann SQL-Befehle ein, die mit einem Semikolon enden ([show databases;], [use dbarticles;], [select * from articles;]), und [exit] zum Beenden. Der Client kann auch ein SQL-Skript ausführen, was Kapitel 10 nutzt, um seine Datenbanken zu erstellen:

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

Die Skripte erstellen ihre Datenbank bei jeder Ausführung vollständig neu: Sie können sie erneut ausführen, um die Daten nach Tests in den Ausgangszustand zurückzusetzen.

15.1.4. Der grafische Client HeidiSQL

Die Laragon-Schaltfläche Database startet den grafischen Client HeidiSQL. Beim ersten Start bietet HeidiSQL eine bereits konfigurierte Verbindungssitzung für den Laragon-Server MySQL an (Host [127.0.0.1], Benutzer [root], leeres Passwort, Port 3306); öffnen Sie sie einfach. Sie sehen:

  • links die Baumansicht der Datenbanken des Servers und ihrer Tabellen;
  • rechts Registerkarten mit der Struktur einer Tabelle, ihren Daten (die direkt bearbeitet werden können) und einem Feld zur Eingabe von SQL-Abfragen (die Registerkarte „Query“), die mit [F9] ausgeführt werden.

Um eine Datenbank mit einem Skript aus Kapitel 10 zu erstellen, öffnen Sie das Skript (über das Menü „File“ mit dem Befehl zum Laden einer SQL-Datei) in einer Abfrage-Registerkarte und führen es dann aus ([F9]). Sie können eine Datenbank, einen Benutzer und Benutzerberechtigungen auch über die Menüs von HeidiSQL erstellen (Rechtsklick auf die Verbindung / „Create New“ / „Database“; Menü „Tools“ / „User Manager“), aber die SQL-Skripte haben den Vorteil, reproduzierbar und wiederholt ausführbar zu sein.

IDEs können sich ebenfalls mit einer Datenbank verbinden: IntelliJ IDEA über das Fenster „Database“, VS Code über eine Erweiterung wie „SQLTools“ oder „MySQL“.

15.1.5. Die Datenbanken in diesem Dokument

Die Kapitel 10 und 11 verwenden die folgenden Datenbanken, die sich alle auf dem lokalen MySQL-Server befinden:

Datenbank
Kapitel
Erstellung
[dbarticles]
10
Skript [10-jdbc/sql/dbarticles.sql]: Tabelle [articles] aus den JDBC-Beispielen
[dbtaxes]
10
Skript [10-jdbc/sql/dbtaxes.sql]: die Tabelle [brackets] aus Version 6 der Anwendung [Tax] und der Benutzer [admtaxes]
[hbfirst], [hbarticles], [hbshop], [hbclients], [hbconcurrency]
11
von den Programmen selbst erstellt (Option [createDatabaseIfNotExist=true] der JDBC-URL; Tabellen, die von Hibernate oder durch versionierte Skripte erstellt werden)
[hbtaxes]
11
Erstellt und befüllt vom Programm [CreateDatabase] in Version 7 der Anwendung [Tax]

Nach Abschluss der Tests kann eine Datenbank mit dem SQL-Befehl [drop database name;], im Client [mysql] oder in HeidiSQL gelöscht werden.

15.2. Verwendete Maven-Abhängigkeiten

Die folgende Tabelle fasst die Bibliotheken zusammen, die von den Maven-Projekten in diesem Dokument verwendet werden, zusammen mit den Versionen, mit denen die Beispiele getestet wurden. Sie werden beim ersten Build eines Projekts automatisch vom Befehl [mvn] (oder vom Befehl der IDE) aus Maven Central heruntergeladen, zusammen mit den Bibliotheken, von denen sie abhängen: Zu diesem Zeitpunkt ist daher ein Internetzugang erforderlich.

Bibliothek (groupId:artifactId)
Version
Kapitel
[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] (MySQL-JDBC-Treiber)
9.7.0
10, 11
[com.zaxxer:HikariCP] (Connection-Pool)
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] und [spring-boot-starter-webmvc] (Spring Boot)
4.1.1
13

Die verwendeten Maven-Plugins sind [maven-compiler-plugin] 3.15.0, [maven-surefire-plugin] 3.5.6 (Testausführung), [exec-maven-plugin] 3.5.1 ([mvn exec:java]) und [spring-boot-maven-plugin] 4.1.1 ([mvn spring-boot:run]). Die Projekte der Anwendung [Tax] für die Kapitel 10 bis 13 hängen außerdem von den Modulen [examples.tax:tax-dao], [tax-business] und [tax-ui] (Version 5.0) ab, die mit dem Befehl [mvn install] im Ordner [06-architectures/TaxV5] (Kapitel 6) im lokalen Repository installiert sein müssen.