#1879: DatabaseDialect.kt

Verwendung von Kotlin-Features

• Enum-Klasse mit Eigenschaft: Jede Enum-Konstante trägt eine asString: String-Eigenschaft über den primären Konstruktor
• Begleitobjekt: Stellt statische Factory- und Utility-Methoden bereit, die über @JvmStatic von Java aus zugänglich sind
• JVM-Interoperabilität: Die Annotation @JvmStatic bei fromString() macht sie aus Java-Code als DatabaseDialect.fromString(...) aufrufbar, anstatt als DatabaseDialect.Companion.fromString(...)

Enum-Konstanten

Methoden des Begleitobjekts

fromString(asString: String): DatabaseDialect?

Sucht einen Dialekt anhand seines Hibernate-Klassennamens. Gibt null zurück, wenn keine Übereinstimmung gefunden wird – Aufrufer müssen den Null-Fall behandeln (typischerweise durch Standardeinstellung auf HSQL für die Entwicklung). Die Methode verwendet eine einfache If-Else-Kette anstelle einer Nachschlagetabelle, was für die geringe Anzahl unterstützter Dialekte angemessen ist.

getFlywayVendorName(databaseProductName: String): String

Ordnet einen JDBC-Treiber-Produktnamen dem Flyway-Vendor-Verzeichnisnamen zu. Dies ist entscheidend für die Flyway-Datenbankmigrations-Skriptfindung. Flyway organisiert Migrationsskripte in vendorspezifischen Verzeichnissen:

flyway/{modul}/migrate/postgresql/V1.1.0__RELEASE-RemoveMGC.sql
flyway/{modul}/migrate/hsqldb/V1.1.0__RELEASE-RemoveMGC.sql

Historischer Kontext: Auskommentierte Datenbanken

Die Datei enthält einen Kommentar, der zuvor in Betracht gezogene oder geplante Datenbankunterstützungen auflistet:

// Noch nicht unterstützt:
// MYSQL, ORACLE, MS_SQL_SERVER, DB2, INFORMIX, DERBY, UNBEKANNT;

Dies offenbart die Designabsicht, mehrere Datenbanken zu unterstützen – eine häufige Anforderung an Unternehmenssoftware. Die aktuelle Implementierung unterstützt nur PostgreSQL (für die Produktion) und HSQLDB (für eingebettete/Entwicklungsumgebungen), wobei die Architektur für Erweiterungen bereit ist.

Datenbankarchitektur in ProjectForge

Der DatabaseDialect-Enum ist Teil einer geschichteten Datenbankabstraktion:

1. Hibernate ORM: Objektrelationales Mapping – die asString-Eigenschaft stellt die Hibernate-Dialektklasse für hibernate.cfg.xml oder die Spring-Boot-Autokonfiguration bereit
2. Flyway: Datenbankmigrationsverwaltung – die Methode getFlywayVendorName() leitet zu vendorspezifischen SQL-Migrationsskripten weiter
3. Setup-Assistent: Der ProjectForge-Setup-Assistent (sowohl Swing- als auch Lanterna-GUIs) verwendet diesen Enum, um Administratoren Datenbankauswahlmöglichkeiten zu präsentieren und JDBC-Verbindungen zu konfigurieren

Designentscheidung: Warum Kotlin?

Diese Datei ist eine der früheren Kotlin-Dateien im Modul projectforge-common (neben anderen Utility-Klassen). Die Verwendung von Kotlin für diesen Enum bietet:

• Präzise Enum-Definition: Primärer Konstruktor mit Eigenschaft, im Vergleich zu ausführlichen Java-Enum-Konstruktoren
• Null-Sicherheit: Der Rückgabetyp DatabaseDialect? von fromString() zwingt Aufrufer, den Null-Fall zu behandeln
• String-Interpolation Sauberere String-Handhabung im Vergleich zur Java-String-Verkettung