الرئيسية / Enterprise / تعيين JDBC ResultSet مقابل JPA Criteria API
Enterprise متقدم

تعيين JDBC ResultSet مقابل JPA Criteria API

استبدل تعيين JDBC ResultSet اليدوي بـ JPA Criteria API الآمن من حيث النوع للاستعلامات الديناميكية.

مقارنة الكود
✕ Java EE 
String sql = "SELECT * FROM users"
    + " WHERE status = ? AND age > ?";
try (Connection con = ds.getConnection();
     PreparedStatement ps =
             con.prepareStatement(sql)) {
    ps.setString(1, status);
    ps.setInt(2, minAge);
    ResultSet rs = ps.executeQuery();
    List<User> users = new ArrayList<>();
    while (rs.next()) {
        User u = new User();
        u.setId(rs.getLong("id"));
        u.setName(rs.getString("name"));
        u.setAge(rs.getInt("age"));
        users.add(u);
    }
}
✓ Jakarta EE 8+ 
@PersistenceContext
EntityManager em;

public List<User> findActiveAboveAge(
        String status, int minAge) {
    var cb = em.getCriteriaBuilder();
    var cq =
        cb.createQuery(User.class);
    var root = cq.from(User.class);
    cq.select(root).where(
        cb.equal(root.get("status"), status),
        cb.greaterThan(root.get("age"), minAge));
    return em.createQuery(cq).getResultList();
}
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🔒

استعلامات آمنة من حيث النوع

يكشف مُنشئ Criteria أسماء الحقول وعدم تطابق الأنواع وقت الترجمة.

🗺️

تعيين تلقائي

يُعيّن JPA صفوف النتائج إلى كائنات الكيان — لا استخراج عمود بعمود يدوي.

🧩

شروط قابلة للتركيب

تتركّب جمل where الديناميكية بشكل نظيف بـ and() و or() وكائنات Predicate قابلة لإعادة الاستخدام.

الأسلوب القديم
JDBC ResultSet
الأسلوب الحديث
JPA Criteria API
منذ JDK
11
الصعوبة
متقدم
دعم JDK
تعيين JDBC ResultSet مقابل JPA Criteria API
متاح

متاح على نطاق واسع منذ Jakarta EE 8 / Java 11

كيف يعمل

يتطلب JDBC الخام بناء سلاسل SQL وضبط المعاملات بالمؤشر وتعيين كل عمود ResultSet يدوياً — وهي عملية عرضة للأخطاء وتفشل بصمت عند تغيير الأعمدة. تبني JPA Criteria API الاستعلامات برمجياً باستخدام نمط منشئ آمن من حيث النوع. تُتحقَّق أسماء الأعمدة مقابل نموذج الكيان والتعيين تلقائي والاستعلامات الديناميكية المعقدة تتركّب بشكل نظيف دون تسلسل سلاسل.

توثيق ذو صلة
Jakarta Persistence Specification ↗ Jakarta Persistence 3.1 — Criteria API ↗
أنماط ذات صلة
Enterprise متوسط

JDBC versus JPA

Java EE
String sql = "SELECT * FROM users WHERE id = ?";
try (Connection con = dataSource.getConnection();
     PreparedStatement ps =
             con.prepareStatement(sql)) {
    ps.setLong(1, id);
    ResultSet rs = ps.executeQuery();
    if (rs.next()) {
        User u = new User();
        u.setId(rs.getLong("id"));
        u.setName(rs.getString("name"));
    }
}
Jakarta EE 8+
@PersistenceContext
EntityManager em;

public User findUser(Long id) {
    return em.find(User.class, id);
}

public List<User> findByName(String name) {
    return em.createQuery(
        "SELECT u FROM User u WHERE u.name = :name",
        User.class)
        .setParameter("name", name)
        .getResultList();
}
مرر للرؤية الحديث ←
JDK 11+ →
Enterprise متوسط

JPA versus Jakarta Data

Jakarta EE 8+
@PersistenceContext
EntityManager em;

public User findById(Long id) {
    return em.find(User.class, id);
}

public List<User> findByName(String name) {
    return em.createQuery(
        "SELECT u FROM User u WHERE u.name = :name",
        User.class)
        .setParameter("name", name)
        .getResultList();
}

public void save(User user) {
    em.persist(user);
}
Jakarta EE 11+
@Repository
public interface Users extends CrudRepository<User, Long> {
    List<User> findByName(String name);
}
مرر للرؤية الحديث ←
JDK 21+ →
Enterprise متوسط

Manual JPA Transaction vs Declarative @Transactional

Java EE
@PersistenceContext
EntityManager em;

public void transferFunds(Long from, Long to,
                          BigDecimal amount) {
    EntityTransaction tx = em.getTransaction();
    tx.begin();
    try {
        Account src = em.find(Account.class, from);
        Account dst = em.find(Account.class, to);
        src.debit(amount);
        dst.credit(amount);
        tx.commit();
    } catch (Exception e) {
        tx.rollback();
        throw e;
    }
}
Jakarta EE 8+
@ApplicationScoped
public class AccountService {
    @PersistenceContext
    EntityManager em;

    @Transactional
    public void transferFunds(Long from, Long to,
                              BigDecimal amount) {
        var src = em.find(Account.class, from);
        var dst = em.find(Account.class, to);
        src.debit(amount);
        dst.credit(amount);
    }
}
مرر للرؤية الحديث ←
JDK 11+ →
مشاركة 𝕏 🦋 in ⬡