The Jdbi library provides convenient, idiomatic access to relational databases in Java.
Jdbi is built on top of JDBC. If your database has a JDBC driver, you can use Jdbi with it.
Prerequisites
Jdbi 3 requires Java 8 or better to run. Jdbi 3 requires Java 11 or better to compile.
We run CI tests against Java 8, 11, 14, and 15. We recommend running the latest GA JDK.
At this point Java 8 is considered deprecated. While Jdbi does not (yet) have a specific date to drop support, please chart your path forward to a supported JDK!
NOTE: to run on Java 8, you may need to manage the caffeine
dependency back to the latest 2.x release. 3.x is necessary for newer JDKs but does not run on 8.
Builds
Jdbi is built with Maven:
$ mvn clean install
The tests use real Postgres and H2 databases.
You do not need to install anything--the tests will spin up temporary database servers as needed.
Contributing
Please read CONTRIBUTING.md for instructions to set up your development environment to build Jdbi.
Versioning
We use SemVer for versioning.
License
This project is licensed under the Apache 2.0 license.
Project Members
- Brian McCallister (@brianm) - Project Founder
- Steven Schlansker (@stevenschlansker)
- Henning Schmiedehausen (@hgschmie)
- Matthew Hall (@qualidafial)
- Artem Prigoda (@arteam)
- Marnick L'Eau (@TheRealMarnes)
Special Thanks
- Alex Harin (@aharin) - Kotlin plugins.
- Ali Shakiba (@shakiba) - JPA plugin
- @alwins0n - Vavr plugin.
- Fred Deschenes (@FredDeschenes) - Kotlin unchecked extensions for
Jdbi
functions.@BindFields
,@BindMethods
annotations.