jdbi

| | | |

A biblioteca Jdbi fornece acesso idiomático e conveniente a bancos de dados relacionais em Java e outras tecnologias JVM, como Kotlin, Clojure ou Scala.

Jdbi é construído sobre JDBC. Se o seu banco de dados tiver um driver JDBC, você poderá usar Jdbi com ele.

• Guia do desenvolvedor
• Javadoc
• Fóruns de usuários
• Lista de discussão
• Estouro de pilha

Verifique também os exemplos de código no módulo Exemplos.

Agradecimentos e Financiamento

• Jdbi é beneficiário do Fundo Spotify FOSS 2023
• Jdbi é apoiado pelo Tidelift

Pré-requisitos

Jdbi requer Java 11 ou superior para funcionar.

Executamos testes de CI em Java 11, 17 e 21.

Compatibilidade com versões mais antigas do Java

Java 8, 9 e 10 são suportados por qualquer versão Jdbi anterior a 3.40.0 .

Prédio

Jdbi requer um JDK versão 17 ou superior para ser compilado. Aplicamos o LTS mais recente (atualmente Java 21) para lançamentos.

Jdbi vem com "baterias incluídas" e usa o Apache Maven Wrapper. Se uma instalação externa do Maven for usada, será necessário o Apache Maven 3.9 ou posterior. Usar os alvos make requer GNU make.

Todas as tarefas de construção são organizadas como alvos make .

Construa o código e instale-o no repositório local:

$ make install

Executar make ou make help exibe todos os alvos de construção disponíveis com uma breve explicação. Alguns dos objetivos exigirão privilégios de membro do projeto. O documento CONTRIBUTING.md contém uma lista de todos os destinos suportados.

Para adicionar parâmetros de linha de comando às execuções maven do Makefile, defina a variável MAVEN_ARGS :

% MAVEN_ARGS= " -B -fae " make install

Teste

A execução de make tests executa todos os testes de unidade e integração.

Alguns testes usam bancos de dados Postgres e H2 (os testes ativarão servidores de banco de dados temporários conforme necessário). A maioria dos sistemas operacionais modernos (Windows, MacOS, Linux) e arquitetura de host (x86_64, aarch64) devem funcionar.

Requisitos do Docker

Para uma versão completa, o docker ou um ambiente compatível com docker deve estar disponível. Um pequeno número de testes usa testcontainers que, por sua vez, requer docker.

make install-nodocker ignora os testes ao construir e instalar o Jdbi localmente. make tests-nodocker pula os testes apenas quando executa testes.

As configurações suportadas são

• Docker Desktop no MacOS
• docker-ce no Linux
• podman 3 ou melhor em Linux e MacOS

Outras instalações docker, como Colima, podem funcionar, mas não foram testadas e não são suportadas.

Para podman no Linux, o soquete podman deve ser ativado (consulte https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests) para obter detalhes. O SELinux às vezes interfere nos testcontainers se o SELinux estiver ativo; certifique-se de que haja uma exceção configurada.

Para podman no MacOS, é necessário definir a variável de ambiente DOCKER_HOST corretamente.

Contribuindo

Leia CONTRIBUTING.md para obter instruções sobre como configurar seu ambiente de desenvolvimento para construir Jdbi.

Versionamento

Jdbi usa SemVer para versionar sua API pública.

Licença

Este projeto está licenciado sob a licença Apache 2.0.

Membros do Projeto

• Brian McCallister (@brianm) – Fundador do Projeto
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

Agradecimentos especiais

• Alex Harin (@aharin) – Plug-ins Kotlin.
• Ali Shakiba (@shakiba) - plugin JPA
• @alwins0n - plugin Vavr.
• Fred Deschenes (@FredDeschenes) - Extensões Kotlin desmarcadas para funções Jdbi . @BindFields , anotações @BindMethods .