jdbi

- - - -

ไลบรารี Jdbi ให้การเข้าถึงฐานข้อมูลเชิงสัมพันธ์ที่สะดวกและเป็นสำนวนใน Java และเทคโนโลยี JVM อื่น ๆ เช่น Kotlin, Clojure หรือ Scala

Jdbi ถูกสร้างขึ้นบน JDBC หากฐานข้อมูลของคุณมีไดรเวอร์ JDBC คุณสามารถใช้ Jdbi กับมันได้

• คู่มือนักพัฒนา
• จาวาด็อก
• ฟอรั่มผู้ใช้
• รายชื่อผู้รับจดหมาย
• กองล้น

ตรวจสอบตัวอย่างโค้ดในโมดูลตัวอย่างด้วย

รับทราบและเงินทุน

• 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) ควรใช้งานได้

ข้อกำหนดของนักเทียบท่า

สำหรับเวอร์ชันเต็ม ต้องมีสภาพแวดล้อมที่เข้ากันได้กับนักเทียบท่าหรือนักเทียบท่า การทดสอบจำนวนเล็กน้อยใช้ testcontainers ซึ่งต้องใช้นักเทียบท่า

make install-nodocker ข้ามการทดสอบเมื่อสร้างและติดตั้ง Jdbi ในเครื่อง make tests-nodocker ข้ามการทดสอบเมื่อมีการรันการทดสอบเท่านั้น

การกำหนดค่าที่รองรับคือ

• นักเทียบท่าเดสก์ท็อปบน MacOS
• docker-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

สมาชิกโครงการ

• Brian McCallister (@brianm) - ผู้ก่อตั้งโครงการ
• สตีเว่น ชแลนสเกอร์ (@stevenschlansker)
• เฮนนิ่ง ชมีเดอเฮาเซ่น (@hgschmie)
• อาร์เทม ปริโกดา (@artam)

ขอขอบคุณเป็นพิเศษ

• Alex Harin (@aharin) - ปลั๊กอิน Kotlin
• Ali Shakiba (@shakiba) - ปลั๊กอิน JPA
• @alwins0n - ปลั๊กอิน Vavr
• Fred Deschenes (@FredDeschenes) - Kotlin ไม่ได้ตรวจสอบส่วนขยายสำหรับฟังก์ชัน Jdbi @BindFields คำอธิบายประกอบ @BindMethods