jdbi

| | | |

Library Jdbi menyediakan akses idiomatis dan nyaman ke database relasional di Java dan teknologi JVM lainnya seperti Kotlin, Clojure, atau Scala.

Jdbi dibangun di atas JDBC. Jika database Anda memiliki driver JDBC, Anda dapat menggunakan Jdbi dengannya.

• Panduan Pengembang
• Javadoc
• Forum pengguna
• milis
• Tumpukan Melimpah

Lihat juga contoh kode di modul Contoh.

Ucapan Terima Kasih dan Pendanaan

• Jdbi adalah penerima Dana Spotify FOSS 2023
• Jdbi didukung oleh Tidelift

Prasyarat

Jdbi membutuhkan Java 11 atau lebih baik untuk dijalankan.

Kami menjalankan tes CI terhadap Java 11, 17 dan 21.

Kompatibilitas dengan versi Java yang lebih lama

Java 8, 9 dan 10 didukung oleh versi Jdbi apa pun sebelum 3.40.0 .

Bangunan

Jdbi memerlukan JDK versi 17 atau lebih baik untuk dibuat. Kami menerapkan LTS terbaru (saat ini Java 21) untuk rilis.

Jdbi "termasuk baterai" dan menggunakan Apache Maven Wrapper. Jika instalasi Maven eksternal digunakan, diperlukan Apache Maven 3.9 atau lebih baru. Menggunakan target make memerlukan GNU make.

Semua tugas pembangunan diatur sebagai target make .

Buat kode dan instal ke repositori lokal:

$ make install

Menjalankan make atau make help menampilkan semua target build yang tersedia dengan penjelasan singkat. Beberapa tujuan memerlukan hak keanggotaan proyek. Dokumen CONTRIBUTING.md berisi daftar semua target yang didukung.

Untuk menambahkan parameter baris perintah ke eksekusi pakar dari Makefile, atur variabel MAVEN_ARGS :

% MAVEN_ARGS= " -B -fae " make install

Pengujian

Menjalankan make tests akan menjalankan semua pengujian unit dan integrasi.

Beberapa pengujian menggunakan database Postgres dan H2 (pengujian akan menjalankan server database sementara sesuai kebutuhan). Sebagian besar OS modern (Windows, MacOS, Linux) dan arsitektur host (x86_64, aarch64) seharusnya berfungsi.

Persyaratan buruh pelabuhan

Untuk versi rilis penuh, buruh pelabuhan atau lingkungan yang kompatibel dengan buruh pelabuhan harus tersedia. Sejumlah kecil pengujian menggunakan testcontainer yang pada gilirannya memerlukan buruh pelabuhan.

make install-nodocker melewatkan tes saat membangun dan menginstal Jdbi secara lokal. make tests-nodocker melewatkan tes ketika hanya menjalankan tes.

Konfigurasi yang didukung adalah

• Docker Desktop di MacOS
• buruh pelabuhan-ce di Linux
• podman 3 atau lebih baik di Linux dan MacOS

Instalasi buruh pelabuhan lain seperti Colima mungkin berfungsi tetapi belum teruji dan tidak didukung.

Untuk podman di Linux, soket podman harus diaktifkan (lihat https://stackoverflow.com/questions/71549856/testcontainers-with-podman-in-java-tests) untuk detailnya. SELinux terkadang mengganggu testcontainer jika SELinux aktif; pastikan ada pengecualian yang dikonfigurasi.

Untuk podman di MacOS, variabel lingkungan DOCKER_HOST perlu disetel dengan benar.

Berkontribusi

Silakan baca CONTRIBUTING.md untuk instruksi menyiapkan lingkungan pengembangan Anda untuk membangun Jdbi.

Pembuatan versi

Jdbi menggunakan SemVer untuk membuat versi API publiknya.

Lisensi

Proyek ini dilisensikan di bawah lisensi Apache 2.0.

Anggota Proyek

• Brian McCallister (@brianm) - Pendiri Proyek
• Steven Schlansker (@stevenschlansker)
• Henning Schmiedehausen (@hgschmie)
• Artem Prigoda (@arteam)

Terima kasih khusus

• Alex Harin (@aharin) - Plugin Kotlin.
• Ali Shakiba (@shakiba) - Plugin JPA
• @ alwins0n - Plugin Vavr.
• Fred Deschenes (@FredDeschenes) - Kotlin tidak mencentang ekstensi untuk fungsi Jdbi . @BindFields , @BindMethods anotasi.