jdbi

| | | |

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

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

• Руководство разработчика
• Javadoc
• Пользовательские форумы
• Список рассылки
• Переполнение стека

Также ознакомьтесь с примерами кода в модуле «Примеры».

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

• 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. Если используется внешняя установка 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. Небольшое количество тестов используют тест-контейнеры, что, в свою очередь, требует докера.

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

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

• Docker Desktop на MacOS
• докер-ce в Linux
• podman 3 или более поздняя версия на Linux и MacOS

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

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

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

Содействие

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

Управление версиями

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

Лицензия

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

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

• Брайан Маккалистер (@brianm) — основатель проекта
• Стивен Шланскер (@stevenschlansker)
• Хеннинг Шмидехаузен (@hgschmie)
• Артем Пригода (@arteam)

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

• Алекс Харин (@aharin) — Плагины Kotlin.
• Али Шакиба (@shakiba) — плагин JPA
• @alwins0n — плагин Вавр.
• Фред Дешен (@FredDeschenes) — непроверенные расширения Kotlin для функций Jdbi . @BindFields , аннотации @BindMethods .