JPA Criteria API

واجهة برمجة تطبيقات معايير JPA

واجهة برمجة تطبيقات معايير JPA (Java Persistence API Criteria API) هي طريقة قوية ومرنة لبناء استعلامات لقواعد البيانات باستخدام كود Java بدلاً من لغة الاستعلامات الهيكلية (SQL) أو لغة الاستعلامات الموجهة للكائنات (JPQL). تعتبر هذه الواجهة جزءًا أساسيًا من مواصفات JPA، وتتيح للمطورين إنشاء استعلامات معقدة بطريقة آمنة من الأخطاء الإملائية وقابلة للصيانة بشكل كبير.

لماذا نستخدم واجهة برمجة تطبيقات المعايير؟

العديد من الأسباب تجعل واجهة برمجة تطبيقات المعايير خيارًا جذابًا:

السلامة من النوع (Type Safety): على عكس SQL و JPQL، تتحقق واجهة برمجة تطبيقات المعايير من أنواع البيانات في وقت الترجمة، مما يقلل من احتمالية حدوث أخطاء في وقت التشغيل.
قابلية الصيانة (Maintainability): الكود المكتوب باستخدام واجهة برمجة تطبيقات المعايير أسهل في القراءة والفهم والتعديل مقارنةً بـ SQL أو JPQL المعقدة.
التجريد (Abstraction): تخفي واجهة برمجة تطبيقات المعايير تفاصيل قاعدة البيانات الأساسية، مما يجعل الكود أكثر استقلالية عن قاعدة البيانات المستخدمة. هذا يسهل عملية الانتقال بين قواعد البيانات المختلفة دون الحاجة لتغيير الكود بشكل كبير.
الديناميكية (Dynamic Queries): تسمح بإنشاء استعلامات ديناميكية بناءً على مدخلات المستخدم أو شروط أخرى في وقت التشغيل.

المفاهيم الأساسية

تعتمد واجهة برمجة تطبيقات المعايير على بناء شجرة من الكائنات التي تمثل أجزاء الاستعلام. إليك بعض المفاهيم الأساسية:

Root (جذر): يمثل الكيان (Entity) أو الجدول الذي تبدأ منه الاستعلام.
CriteriaQuery (استعلام المعايير): يحدد نوع الاستعلام (SELECT، UPDATE، DELETE) والنتائج المتوقعة.
CriteriaBuilder (باني المعايير): يوفر طرقًا لإنشاء أجزاء الاستعلام، مثل الشروط (Predicates) والتعبيرات (Expressions).
Predicate (شرط): يمثل شرطًا في عبارة WHERE.
Expression (تعبير): يمثل جزءًا من الاستعلام، مثل حقل أو دالة.
Selection (اختيار): يحدد الحقول التي سيتم إرجاعها في الاستعلام.
Order (ترتيب): يحدد ترتيب النتائج.

مثال عملي

لنفترض أن لدينا كيانًا يسمى Product (منتج) بحقول مثل id (معرف)، name (اسم)، و price (سعر). نريد استرداد جميع المنتجات التي يزيد سعرها عن 50.

```java import javax.persistence.EntityManager; import javax.persistence.criteria.CriteriaBuilder; import javax.persistence.criteria.CriteriaQuery; import javax.persistence.criteria.Predicate; import javax.persistence.criteria.Root; import java.util.List;

public class ProductDAO {

   private final EntityManager entityManager;

   public ProductDAO(EntityManager entityManager) {
       this.entityManager = entityManager;
   }

   public List<Product> findProductsOverPrice(double price) {
       CriteriaBuilder cb = entityManager.getCriteriaBuilder();
       CriteriaQuery<Product> cq = cb.createQuery(Product.class);
       Root<Product> product = cq.from(Product.class);
       Predicate whereClause = cb.greaterThan(product.get("price"), price);
       cq.where(whereClause);
       return entityManager.createQuery(cq).getResultList();
   }

} ```

في هذا المثال:

1. نحصل على CriteriaBuilder من EntityManager. 2. ننشئ CriteriaQuery لتحديد نوع الاستعلام (Product). 3. نحصل على Root للكيان Product. 4. ننشئ Predicate باستخدام cb.greaterThan لمقارنة سعر المنتج بالقيمة المعطاة. 5. نضيف Predicate إلى عبارة WHERE في CriteriaQuery. 6. ننفيذ الاستعلام باستخدام entityManager.createQuery(cq).getResultList() للحصول على قائمة بالمنتجات التي تستوفي الشرط.

الاستعلامات الديناميكية

تتيح واجهة برمجة تطبيقات المعايير بناء استعلامات ديناميكية بسهولة. على سبيل المثال، يمكننا إضافة شروط إضافية إلى الاستعلام بناءً على مدخلات المستخدم.

```java // ... (الكود السابق) ...

public List<Product> findProducts(Double minPrice, String namePattern) {

   CriteriaBuilder cb = entityManager.getCriteriaBuilder();
   CriteriaQuery<Product> cq = cb.createQuery(Product.class);
   Root<Product> product = cq.from(Product.class);
   Predicate whereClause = cb.conjunction(); // نبدأ بشروط مركبة

   if (minPrice != null) {
       whereClause = cb.and(whereClause, cb.greaterThan(product.get("price"), minPrice));
   }

   if (namePattern != null && !namePattern.isEmpty()) {
       whereClause = cb.and(whereClause, cb.like(product.get("name"), "%" + namePattern + "%"));
   }

   cq.where(whereClause);
   return entityManager.createQuery(cq).getResultList();

} ```

في هذا المثال، نضيف شرطًا لسعر المنتج إذا تم توفيره، وشرطًا لنمط الاسم إذا تم توفيره. cb.conjunction يستخدم لدمج الشروط المتعددة.

الربط بـ JPA و Hibernate

تعتبر واجهة برمجة تطبيقات المعايير جزءًا من مواصفات JPA، لذلك فهي مدعومة من قبل جميع تطبيقات JPA، بما في ذلك Hibernate و EclipseLink و OpenJPA. عند استخدام Hibernate، يتم ترجمة الاستعلامات المكتوبة باستخدام واجهة برمجة تطبيقات المعايير إلى SQL بواسطة Hibernate.

ميزات متقدمة

Functions (الدوال): يمكن استخدام دوال قاعدة البيانات من خلال واجهة برمجة تطبيقات المعايير.
Subqueries (الاستعلامات الفرعية): يمكن تضمين استعلامات فرعية داخل الاستعلام الرئيسي.
Joins (الربط): يمكن ربط جداول متعددة ببعضها البعض.
Aggregations (التجميعات): يمكن إجراء عمليات تجميعية مثل COUNT و SUM و AVG.
Pagination (التقسيم): يمكن تقسيم النتائج إلى صفحات.

أفضل الممارسات

استخدم واجهة برمجة تطبيقات المعايير بدلاً من SQL أو JPQL كلما أمكن ذلك.
حافظ على بساطة الاستعلامات.
استخدم التعليقات لشرح الكود.
اختبر الاستعلامات بدقة.
تجنب استخدام LIKE مع بادئات عامة (مثل "%value")، حيث يمكن أن يؤدي ذلك إلى أداء ضعيف.

مواضيع ذات صلة

استراتيجيات التحليل الفني وحجم التداول

[[Category:**الفئة:واجهات برمجة التطبيقات (APIs)**]

ابدأ التداول الآن

سجل في IQ Option (الحد الأدنى للإيداع $10) افتح حساباً في Pocket Option (الحد الأدنى للإيداع $5)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin للحصول على: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات باتجاهات السوق ✓ مواد تعليمية للمبتدئين