jdbi

| | | |

La biblioteca Jdbi proporciona acceso cómodo e idiomático a bases de datos relacionales en Java y otras tecnologías JVM como Kotlin, Clojure o Scala.

Jdbi está construido sobre JDBC. Si su base de datos tiene un controlador JDBC, puede usar Jdbi con él.

• Guía para desarrolladores
• javadoc
• Foros de usuarios
• Lista de correo
• Desbordamiento de pila

Consulte también los ejemplos de código en el módulo Ejemplos.

Agradecimientos y Financiamiento

• Jdbi recibe el Fondo Spotify FOSS 2023
• Jdbi cuenta con el apoyo de Tidelift

Requisitos previos

Jdbi requiere Java 11 o superior para ejecutarse.

Realizamos pruebas de CI contra Java 11, 17 y 21.

Compatibilidad con versiones anteriores de Java

Java 8, 9 y 10 son compatibles con cualquier versión de Jdbi anterior a la 3.40.0 .

Edificio

Jdbi requiere un JDK versión 17 o superior para compilarse. Aplicamos el último LTS (actualmente Java 21) para las versiones.

Jdbi tiene "baterías incluidas" y utiliza Apache Maven Wrapper. Si se utiliza una instalación externa de Maven, se requiere Apache Maven 3.9 o posterior. El uso de objetivos make requiere GNU make.

Todas las tareas de construcción están organizadas como objetivos make .

Construya el código e instálelo en el repositorio local:

$ make install

Al ejecutar make o make help se muestran todos los objetivos de compilación disponibles con una breve explicación. Algunos de los objetivos requerirán privilegios de membresía del proyecto. El documento CONTRIBUTING.md contiene una lista de todos los objetivos admitidos.

Para agregar parámetros de línea de comando a las ejecuciones de Maven desde Makefile, configure la variable MAVEN_ARGS :

% MAVEN_ARGS= " -B -fae " make install

Pruebas

Al ejecutar make tests se ejecutan todas las pruebas unitarias y de integración.

Algunas pruebas utilizan bases de datos Postgres y H2 (las pruebas activarán servidores de bases de datos temporales según sea necesario). La mayoría de los sistemas operativos modernos (Windows, MacOS, Linux) y arquitectura de host (x86_64, aarch64) deberían funcionar.

Requisitos de Docker

Para una versión completa, debe estar disponible Docker o un entorno compatible con Docker. Una pequeña cantidad de pruebas utilizan contenedores de prueba que a su vez requieren Docker.

make install-nodocker omite las pruebas al compilar e instalar Jdbi localmente. make tests-nodocker omite las pruebas cuando solo las ejecuta.

Las configuraciones admitidas son

• Escritorio Docker en MacOS
• Docker-ce en Linux
• podman 3 o superior en Linux y MacOS

Otras instalaciones de Docker, como Colima, pueden funcionar, pero no están probadas ni son compatibles.

Para podman en Linux, el socket podman debe estar activado (consulte https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests) para obtener más detalles. SELinux a veces interfiere con los contenedores de prueba si SELinux está activo; asegúrese de que haya una excepción configurada.

Para podman en MacOS, es necesario configurar correctamente la variable de entorno DOCKER_HOST .

Contribuyendo

Lea CONTRIBUTING.md para obtener instrucciones sobre cómo configurar su entorno de desarrollo para construir Jdbi.

Versionado

Jdbi usa SemVer para versionar su API pública.

Licencia

Este proyecto está bajo la licencia Apache 2.0.

Miembros del proyecto

• Brian McCallister (@brianm) - Fundador del proyecto
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

agradecimiento especial

• Alex Harin (@aharin) - Complementos de Kotlin.
• Ali Shakiba (@shakiba) - Complemento JPA
• @alwins0n : complemento Vavr.
• Fred Deschenes (@FredDeschenes) : extensiones no marcadas de Kotlin para funciones Jdbi . @BindFields , anotaciones @BindMethods .