jdbi

| | | |

Die Jdbi-Bibliothek bietet bequemen, idiomatischen Zugriff auf relationale Datenbanken in Java und anderen JVM-Technologien wie Kotlin, Clojure oder Scala.

Jdbi basiert auf JDBC. Wenn Ihre Datenbank über einen JDBC-Treiber verfügt, können Sie Jdbi damit verwenden.

• Entwicklerhandbuch
• Javadoc
• Benutzerforen
• Mailingliste
• Stapelüberlauf

Schauen Sie sich auch die Codebeispiele im Beispielmodul an.

Danksagungen und Finanzierung

• Jdbi ist Empfänger des Spotify FOSS 2023 Fund
• Jdbi wird von Tidelift unterstützt

Voraussetzungen

Für die Ausführung von Jdbi ist Java 11 oder höher erforderlich.

Wir führen CI-Tests gegen Java 11, 17 und 21 durch.

Kompatibilität mit älteren Java-Versionen

Java 8, 9 und 10 werden von jeder Jdbi-Version vor 3.40.0 unterstützt.

Gebäude

Zum Erstellen von Jdbi ist eine JDK-Version 17 oder höher erforderlich. Wir erzwingen das neueste LTS (derzeit Java 21) für Releases.

Jdbi ist „Batterien inklusive“ und nutzt den Apache Maven Wrapper. Wenn eine externe Maven-Installation verwendet wird, ist Apache Maven 3.9 oder höher erforderlich. Für die Verwendung der make -Ziele ist GNU Make erforderlich.

Alle Build-Aufgaben sind als make Ziele organisiert.

Erstellen Sie den Code und installieren Sie ihn im lokalen Repository:

$ make install

Wenn Sie make oder make help ausführen, werden alle verfügbaren Build-Ziele mit einer kurzen Erklärung angezeigt. Für einige der Ziele sind Projektmitgliedschaftsrechte erforderlich. Das Dokument CONTRIBUTING.md enthält eine Liste aller unterstützten Ziele.

Um Befehlszeilenparameter zu den Maven-Ausführungen aus dem Makefile hinzuzufügen, legen Sie die Variable MAVEN_ARGS fest:

% MAVEN_ARGS= " -B -fae " make install

Testen

Durch das Ausführen von make tests werden alle Unit- und Integrationstests ausgeführt.

Einige Tests verwenden Postgres- und H2-Datenbanken (die Tests starten bei Bedarf temporäre Datenbankserver). Die meisten modernen Betriebssysteme (Windows, MacOS, Linux) und Hostarchitekturen (x86_64, aarch64) sollten funktionieren.

Docker-Anforderungen

Für einen vollständigen Release-Build muss Docker oder eine Docker-kompatible Umgebung verfügbar sein. Eine kleine Anzahl von Tests verwendet Testcontainer, die wiederum Docker erfordern.

make install-nodocker überspringt die Tests beim lokalen Erstellen und Installieren von Jdbi. make tests-nodocker überspringt die Tests, wenn nur Tests ausgeführt werden.

Unterstützte Konfigurationen sind

• Docker Desktop unter MacOS
• docker-ce unter Linux
• podman 3 oder besser auf Linux und MacOS

Andere Docker-Installationen wie Colima funktionieren möglicherweise, sind jedoch ungetestet und werden nicht unterstützt.

Für Podman unter Linux muss der Podman-Socket aktiviert sein (siehe https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests) für Details. SELinux stört manchmal Testcontainer, wenn SELinux aktiv ist; Stellen Sie sicher, dass eine Ausnahme konfiguriert ist.

Für podman unter MacOS ist es notwendig, die Umgebungsvariable DOCKER_HOST korrekt zu setzen.

Mitwirken

Bitte lesen Sie CONTRIBUTING.md, um Anweisungen zum Einrichten Ihrer Entwicklungsumgebung für die Erstellung von Jdbi zu erhalten.

Versionierung

Jdbi verwendet SemVer, um seine öffentliche API zu versionieren.

Lizenz

Dieses Projekt ist unter der Apache 2.0-Lizenz lizenziert.

Projektmitglieder

• Brian McCallister (@brianm) – Projektgründer
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

Besonderer Dank

• Alex Harin (@aharin) – Kotlin-Plugins.
• Ali Shakiba (@shakiba) – JPA-Plugin
• @alwins0n – Vavr-Plugin.
• Fred Deschenes (@FredDeschenes) – Kotlin hat Erweiterungen für Jdbi -Funktionen deaktiviert. @BindFields , @BindMethods Anmerkungen.