jdbi

| | | |

La bibliothèque Jdbi offre un accès pratique et idiomatique aux bases de données relationnelles en Java et à d'autres technologies JVM telles que Kotlin, Clojure ou Scala.

Jdbi est construit sur JDBC. Si votre base de données dispose d'un pilote JDBC, vous pouvez utiliser Jdbi avec celui-ci.

• Guide du développeur
• Javadoc
• Forums d'utilisateurs
• Liste de diffusion
• Débordement de pile

Consultez également les exemples de code dans le module Exemples.

Remerciements et financement

• Jdbi est récipiendaire du Fonds Spotify FOSS 2023
• Jdbi est supporté par Tidelift

Conditions préalables

Jdbi nécessite Java 11 ou supérieur pour fonctionner.

Nous effectuons des tests CI sur Java 11, 17 et 21.

Compatibilité avec les anciennes versions de Java

Java 8, 9 et 10 sont pris en charge par toute version de Jdbi antérieure à 3.40.0 .

Bâtiment

Jdbi nécessite une version 17 ou supérieure du JDK pour être construit. Nous appliquons la dernière LTS (actuellement Java 21) pour les versions.

Jdbi est "piles incluses" et utilise Apache Maven Wrapper. Si une installation Maven externe est utilisée, Apache Maven 3.9 ou version ultérieure est requis. L'utilisation des cibles make nécessite GNU make.

Toutes les tâches de construction sont organisées sous forme de cibles make .

Créez le code et installez-le dans le référentiel local :

$ make install

L'exécution de make ou make help affiche toutes les cibles de build disponibles avec une brève explication. Certains des objectifs nécessiteront des privilèges d’adhésion au projet. Le document CONTRIBUTING.md contient une liste de toutes les cibles prises en charge.

Pour ajouter des paramètres de ligne de commande aux exécutions maven à partir du Makefile, définissez la variable MAVEN_ARGS :

% MAVEN_ARGS= " -B -fae " make install

Essai

L’exécution de make tests exécute tous les tests unitaires et d’intégration.

Certains tests utilisent des bases de données Postgres et H2 (les tests feront tourner des serveurs de bases de données temporaires si nécessaire). La plupart des systèmes d'exploitation modernes (Windows, MacOS, Linux) et des architectures hôtes (x86_64, aarch64) devraient fonctionner.

Exigences de Docker

Pour une version complète, Docker ou un environnement compatible Docker doit être disponible. Un petit nombre de tests utilisent des conteneurs de test qui nécessitent à leur tour Docker.

make install-nodocker ignore les tests lors de la construction et de l'installation de Jdbi localement. make tests-nodocker ignore les tests lors de l'exécution uniquement de tests.

Les configurations prises en charge sont

• Docker Bureau sur MacOS
• docker-ce sous Linux
• podman 3 ou supérieur sous Linux et MacOS

D'autres installations Docker telles que Colima peuvent fonctionner mais ne sont ni testées ni prises en charge.

Pour podman sous Linux, le socket podman doit être activé (voir https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests) pour plus de détails. SELinux interfère parfois avec les conteneurs de test si SELinux est actif ; assurez-vous qu'une exception est configurée.

Pour podman sur MacOS, il est nécessaire de paramétrer correctement la variable d'environnement DOCKER_HOST .

Contribuer

Veuillez lire CONTRIBUTING.md pour obtenir des instructions sur la configuration de votre environnement de développement pour créer Jdbi.

Gestion des versions

Jdbi utilise SemVer pour versionner son API publique.

Licence

Ce projet est sous licence Apache 2.0.

Membres du projet

• Brian McCallister (@brianm) - Fondateur du projet
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

Remerciements spéciaux

• Alex Harin (@aharin) – Plugins Kotlin.
• Ali Shakiba (@shakiba) - Plugin JPA
• @alwins0n - Plugin Vavr.
• Fred Deschenes (@FredDeschenes) - Extensions Kotlin non cochées pour les fonctions Jdbi . @BindFields , @BindMethods annotations.