hibernate orm Download - hibernate orm Quellcode herunterladen

hibernate orm

JAVA-Quellcode

Hibernate ORM 6.6.3.

Herunterladen

Hibernate ORM ist eine leistungsstarke objekt-/relationale Mapping-Lösung für Java und erleichtert die Entwicklung von Persistenzlogik für Anwendungen, Bibliotheken und Frameworks.

Hibernate implementiert JPA, die Standard-API für Objekt-/relationale Persistenz in Java, bietet aber auch einen umfangreichen Satz an Funktionen und APIs, die über die Spezifikation hinausgehen.

Weitere Informationen finden Sie unter Hibernate.org.

Kontinuierliche Integration

Hibernate verwendet für seine CI-Anforderungen sowohl Jenkins- als auch GitHub-Aktionen. Sehen

Jenkins-Jobs
GitHub-Aktionen-Jobs

Aus Quellen bauen

Der Build erfordert mindestens Java 11 und höchstens Java 17.

Hibernate verwendet Gradle als Build-Tool. Wenn Sie Gradle noch nicht kennen, lesen Sie den Abschnitt „Gradle Primer“ weiter unten.

Mitwirkende sollten den Beitragsleitfaden lesen.

Sehen Sie sich die Anleitungen zum Einrichten von IntelliJ oder Eclipse als Entwicklungsumgebung an.

Gradle-Grundierung

Das Gradle-Build-Tool verfügt über eine erstaunliche Dokumentation. 2 insbesondere, die unverzichtbar sind:

Das Gradle-Benutzerhandbuch ist insofern ein typisches Benutzerhandbuch, als es einem thematischen Ansatz zur Beschreibung aller Funktionen von Gradle folgt.
Der Gradle DSL Guide ist einzigartig und eignet sich hervorragend, um sich schnell mit bestimmten Aspekten von Gradle vertraut zu machen.

Wir behandeln die Grundlagen, die Entwickler und Mitwirkende, die neu bei Gradle sind, wissen müssen, um schnell produktiv zu werden.

Notiz

Das Projekt definiert einen Gradle Wrapper. Der Rest des Abschnitts geht von der Ausführung durch den Wrapper aus.

Aufgaben ausführen

Gradle verwendet das Konzept von Build-Aufgaben (entspricht Ant-Zielen oder Maven-Phasen/-Zielen). Eine Liste der verfügbaren Aufgaben erhalten Sie über

 Gradle-Aufgaben

Um eine Aufgabe modulübergreifend auszuführen, führen Sie diese Aufgabe einfach aus dem Stammverzeichnis aus. Gradle besucht jedes Unterprojekt und führt diese Aufgabe aus, wenn das Unterprojekt dies definiert. Um eine Aufgabe in einem bestimmten Modul auszuführen, können Sie entweder:

cd in dieses Modulverzeichnis und führen Sie die Aufgabe aus
Benennen Sie den „Aufgabenpfad“. Um beispielsweise die Tests für das Modul „hibernate-core“ aus dem Stammverzeichnis auszuführen, könnten Sie gradle hibernate-core:test sagen

Gemeinsame Aufgaben

Zu den allgemeinen Aufgaben, die Sie möglicherweise beim Erstellen von Hibernate verwenden, gehören:

build – Assembliert (JARs) und testet dieses Projekt
kompilieren – Führt alle Kompilierungsaufgaben aus, einschließlich der Staging-Ressourcen sowohl vom Haupt- als auch vom Testserver
jar – Erstellt ein Jar-Archiv mit allen kompilierten Klassen
test – Führt die Tests aus
publizToMavenLocal – Installiert das Projekt-JAR in Ihrem lokalen Maven-Cache (auch bekannt als ~/.m2/repository). Beachten Sie, dass Gradle dies nie verwendet, es kann jedoch nützlich sein, um Ihren Build mit anderen lokalen Maven-basierten Builds zu testen.
clean – Bereinigt das Build-Verzeichnis

Tests und Datenbanken

Das Testen anhand einer bestimmten Datenbank kann auf zwei verschiedene Arten erfolgen:

Verwendung des „Matrix Testing Plugin“ für Gradle.

Kommt später…

Verwendung von „Profilen“

Der Hibernate-Build definiert mehrere Datenbanktest-„Profile“ in databases.gradle “. Diese Profile können namentlich mithilfe der db Build-Eigenschaft aktiviert werden, die entweder als JVM-System-Requisite ( -D ) oder als Gradle-Projekteigenschaft ( -P ) übergeben werden kann. Die folgenden Beispiele verwenden den Gradle-Projekteigenschaften-Ansatz.

 Gradle Clean Build -Pdb=pgsql

Um einen Test über Ihre IDE auszuführen, müssen Sie sicherstellen, dass die Eigenschaftserweiterungen stattfinden. Verwenden Sie den folgenden Befehl:

 Gradle Clean Compile -Pdb=pgsql

HINWEIS: Wenn Sie Tests mit einem JDBC-Treiber durchführen, der nicht über Maven Central verfügbar ist, stellen Sie sicher, dass Sie diese Treiber zu Ihrem lokalen Maven-Repo-Cache (~/.m2/repository) oder (besser) zu einem persönlichen Maven-Repo-Server hinzufügen

Ausführen datenbankspezifischer Tests aus der IDE mithilfe von „Profilen“

Sie können jeden Test für jede bestimmte Datenbank ausführen, die in einem databases.gradle -Profil konfiguriert ist.

Sie müssen lediglich den folgenden Befehl ausführen:

 ./gradlew setDataBase -Pdb=pgsql

oder Sie können die Shortcut-Version verwenden:

 ./gradlew sDB -Pdb=pgsql

Sie können dies über das Modul tun, das Sie testen möchten, oder über den Stammordner hibernate-orm .

Wählen Sie anschließend einfach einen beliebigen Test aus der IDE aus und führen Sie ihn wie gewohnt aus. Hibernate wählt die Datenbankkonfiguration aus der Datei hibernate.properties aus, die von der Gradle-Aufgabe setDataBase eingerichtet wurde.

Testdatenbanken lokal als Docker-Container starten

Sie müssen nicht alle Datenbanken lokal installieren, um sie testen zu können, falls Docker verfügbar ist. Mit dem Skript docker_db.sh können Sie eine vorkonfigurierte Datenbank starten, die zum Testen verwendet werden kann.

Sie müssen lediglich den folgenden Befehl ausführen:

 ./docker_db.sh postgresql

Wenn Sie das Argument weglassen, wird eine Liste möglicher Optionen ausgegeben.

Wenn die Datenbank ordnungsgemäß gestartet ist, können Sie Tests mit speziellen Profilen ausführen, die das Suffix _ci haben, z. B. pgsql_ci für PostgreSQL. Mithilfe der Systemeigenschaft dbHost können Sie die IP-Adresse Ihres Docker-Hosts konfigurieren.

Der Befehl zum Ausführen von Tests könnte wie folgt aussehen:

 ./gradlew test -Pdb=pgsql_ci "-DdbHost=192.168.99.100"

Die folgende Tabelle zeigt eine Liste von Befehlen für verschiedene Datenbanken, die lokal getestet werden können.

Datenbank	`docker_db.sh`	Gradle-Befehl
H2	-	`./gradlew test -Pdb=h2`
HSQLDB	-	`./gradlew test -Pdb=hsqldb`
Apache Derby	-	`./gradlew test -Pdb=derby`
MySQL	`./docker_db.sh mysql`	`./gradlew test -Pdb=mysql_ci`
MariaDB	`./docker_db.sh mariadb`	`./gradlew test -Pdb=mariadb_ci`
PostgreSQL	`./docker_db.sh postgresql`	`./gradlew test -Pdb=pgsql_ci`
EnterpriseDB	`./docker_db.sh edb`	`./gradlew test -Pdb=edb_ci`
Orakel	`./docker_db.sh oracle`	`./gradlew test -Pdb=oracle_ci`
DB2	`./docker_db.sh db2`	`./gradlew test -Pdb=db2_ci`
SQL-Server	`./docker_db.sh mssql`	`./gradlew test -Pdb=mssql_ci`
Sybase ASE (jTDS)	`./docker_db.sh sybase`	`./gradlew test -Pdb=sybase_ci`
Sybase ASE (jConnect)	`./docker_db.sh sybase`	`./gradlew test -Pdb=sybase_jconn_ci`
SAP HANA	`./docker_db.sh hana`	`./gradlew test -Pdb=hana_ci`
KakerlakeDB	`./docker_db.sh cockroachdb`	`./gradlew test -Pdb=cockroachdb`
TiDB	`./docker_db.sh tidb`	`./gradlew test -Pdb=tidb`
Informix	`./docker_db.sh informix`	`./gradlew test -Pdb=informix`