الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

| | | |

توفر مكتبة Jdbi وصولاً مريحًا واصطلاحيًا إلى قواعد البيانات العلائقية في Java وتقنيات JVM الأخرى مثل Kotlin أو Clojure أو Scala.

تم بناء Jdbi على رأس JDBC. إذا كانت قاعدة بياناتك تحتوي على برنامج تشغيل JDBC، فيمكنك استخدام Jdbi معه.

  • دليل المطور
  • جافادوك
  • منتديات المستخدم
  • القائمة البريدية
  • تجاوز سعة المكدس

تحقق أيضًا من أمثلة التعليمات البرمجية في وحدة الأمثلة.

الشكر والتقدير والتمويل

  • Jdbi هو المستفيد من صندوق Spotify FOSS 2023
  • tidelift logo Jdbi مدعوم من Tidelift

المتطلبات الأساسية

يتطلب Jdbi تشغيل Java 11 أو أفضل.

نقوم بإجراء اختبارات CI ضد Java 11 و17 و21.

التوافق مع إصدارات جافا الأقدم

يتم دعم Java 8 و9 و10 بواسطة أي إصدار Jdbi قبل 3.40.0 .

مبنى

يتطلب Jdbi الإصدار 17 من JDK أو إصدارًا أفضل للإنشاء. نحن نفرض أحدث LTS (حاليًا Java 21) للإصدارات.

Jdbi "متضمن بالبطاريات" ويستخدم Apache Maven Wrapper. في حالة استخدام تثبيت Maven خارجي، يلزم توفر Apache Maven 3.9 أو إصدار أحدث. يتطلب استخدام أهداف make إنشاء GNU.

يتم تنظيم جميع مهام البناء كأهداف make .

قم ببناء الكود وتثبيته في المستودع المحلي: 

$ make install

يؤدي تشغيل make أو make help إلى عرض جميع أهداف البناء المتاحة مع شرح قصير. ستتطلب بعض الأهداف امتيازات عضوية المشروع. يحتوي مستند CONTRIBUTING.md على قائمة بجميع الأهداف المدعومة.

لإضافة معلمات سطر الأوامر إلى عمليات التنفيذ المخضرمة من Makefile، قم بتعيين المتغير MAVEN_ARGS : 

% MAVEN_ARGS= " -B -fae " make install

اختبار

يؤدي تشغيل make tests إلى تشغيل جميع اختبارات الوحدة والتكامل.

تستخدم بعض الاختبارات قواعد بيانات Postgres وH2 (ستعمل الاختبارات على تشغيل خوادم قواعد البيانات المؤقتة حسب الحاجة). يجب أن تعمل معظم أنظمة التشغيل الحديثة (Windows وMacOS وLinux) والبنية المضيفة (x86_64 وaarch64).

متطلبات عامل الميناء

للحصول على إصدار كامل، يجب أن تكون بيئة الإرساء أو البيئة المتوافقة مع الإرساء متاحة. يستخدم عدد صغير من الاختبارات حاويات الاختبار والتي تتطلب بدورها عامل إرساء.

make install-nodocker يتخطى الاختبارات عند إنشاء Jdbi وتثبيته محليًا. make tests-nodocker يتخطى الاختبارات عند تشغيل الاختبارات فقط.

التكوينات المدعومة هي

  • سطح المكتب Docker على نظام MacOS
  • عامل ميناء-ce على لينكس
  • 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 لإصدار واجهة برمجة التطبيقات العامة الخاصة به.

رخصة

هذا المشروع مرخص بموجب ترخيص Apache 2.0.

أعضاء المشروع

  • بريان ماكاليستر (@brianm) - مؤسس المشروع
  • ستيفن شلانسكر (@stevenschlansker)
  • هينينج شميدهاوزن (@hgschmie)
  • أرتيم بريجودا (@arteam)

شكر خاص

  • Alex Harin (@aharin) - ملحقات Kotlin.
  • علي شكيبة (@shakiba) - البرنامج المساعد JPA
  • @alwins0n - البرنامج المساعد Vavr.
  • Fred Deschenes (@FredDeschenes) - ملحقات Kotlin غير المحددة لوظائف Jdbi . @BindFields ، @BindMethods التعليقات التوضيحية.
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل