README.md

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.

• Developer Guide and API Docs
• Mailing List

Prerequisites

Jdbi 3 requires Java 8.

We've done some light testing with Java 9, and would appreciate reports of any problems!

Builds

Jdbi is built with Maven:

$ mvn clean install

The tests use real Postgres, H2, and Oracle databases.

For Postgres and H2, you do not need to install anything--the tests will spin up temporary database servers as needed.

By default, the build skips over jdbi3-oracle12. Oracle keeps their JDBC drivers in a password-protected Maven repository, so some additional setup is required before jdbi3-oracle12 can build. CONTRIBUTING.md contains instructions to help set up your environment to build jdbi3-oracle12.

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)

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.