| | | |

Библиотека Jdbi предоставляет удобный, идиоматический доступ к реляционным базам данных на Java и других технологиях JVM, таких как Kotlin, Clojure или Scala.

Jdbi основан на JDBC. Если ваша база данных имеет драйвер JDBC, вы можете использовать Jdbi вместе с ней.

• Руководство разработчика
• Документация Javadoc
• Форумы пользователей
• Почтовый список рассылки
• Stack Overflow

Также обратите внимание на примеры кода в модуле Примеры.

Благодарности и финансирование

• Jdbi является получателем гранта Spotify FOSS 2023 года
• Jdbi поддерживается Tidelift

Предварительные условия

Jdbi требует Java версии 11 или выше для запуска.

Мы выполняем CI-тестирование против Java 11, 17 и 21.

Совместимость с более старыми версиями Java

Java 8, 9 и 10 поддерживаются любым Jdbi до версии 3.40.0.

Сборка

Jdbi требует JDK версии 17 или выше для сборки. Мы применяем последнюю LTS (в настоящее время Java 21) для выпусков.

Jdbi — это "все включено" и использует Apache Maven Wrapper. Если используется внешняя установка Maven, требуется Apache Maven 3.9 или новее. Использование целей make требует GNU make.

Все задачи сборки организованы как цели make.

Собирает код и устанавливает его в локальный репозиторий:

$ make install

Выполнение make или make help отображает все доступные цели сборки с коротким объяснением. Некоторые из этих целей могут потребовать привилегий членства проекта. Документ CONTRIBUTING.md содержит полный список всех поддерживаемых целей.

Чтобы добавить параметры командной строки к выполнению Maven из файла Makefile, установите переменную MAVEN_ARGS:

% MAVEN_ARGS="-B -fae" make install

Тестирование

Выполнение make tests запускает все юнит-тесты и интеграционные тесты.

Некоторые тесты используют базы данных Postgres и H2 (тесты будут запускать временные серверы баз данных при необходимости). Большинство современных ОС (Windows, MacOS, Linux) и архитектур хоста (x86_64, aarch64) должны работать.

Требования Docker

Для полной сборки выпуска Docker или совместимой среды Docker должна быть доступна. Небольшое количество тестов использует Testcontainers, что в свою очередь требует Docker.

make install-nodocker пропускает тесты при сборке и установке Jdbi локально. make tests-nodocker пропускает тесты при выполнении только тестов.

Поддерживаемые конфигурации:

• Docker Desktop на MacOS
• docker-ce на Linux
• podman 3 или новее на Linux и MacOS

Другие установки Docker, такие как Colima, могут работать, но не протестированы и не поддерживаются.

Для podman на Linux, сокет podman должен быть активирован (см. https://ru.stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests для подробностей). SELinux иногда мешает Testcontainers, если SELinux активен; убедитесь, что есть исключение, настроенное.

Для podman на MacOS, необходимо правильно установить переменную окружения DOCKER_HOST.

Вклад

Пожалуйста, прочитайте CONTRIBUTING.md для инструкций по настройке вашего окружения разработки для сборки Jdbi.

Версионирование

Jdbi использует SemVer для версионирования своей публичной API.

Лицензия

Этот проект лицензируется под лицензией Apache 2.0.

Участники проекта

• Brian McCallister (@brianm) - Основатель Проекта
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

Особая благодарность

• Alex Harin (@aharin) - плагины для Kotlin.
• Ali Shakiba (@shakiba) - плагин JPA.
• @alwins0n - плагин Vavr.
• Fred Deschenes (@FredDeschenes) - необработанные расширения Kotlin для функций Jdbi. Аннотации @BindFields, @BindMethods.