الرئيسية / Enterprise / JDBC مقابل jOOQ
Enterprise متوسط

JDBC مقابل jOOQ

استبدل SQL المبني على سلاسل JDBC الخام بـ jOOQ DSL السائل الآمن من حيث النوع.

مقارنة الكود
✕ Raw JDBC 
String sql = "SELECT id, name, email FROM users "
           + "WHERE department = ? AND salary > ?";
try (Connection con = ds.getConnection();
     PreparedStatement ps =
             con.prepareStatement(sql)) {
    ps.setString(1, department);
    ps.setBigDecimal(2, minSalary);
    ResultSet rs = ps.executeQuery();
    List<User> result = new ArrayList<>();
    while (rs.next()) {
        result.add(new User(
            rs.getLong("id"),
            rs.getString("name"),
            rs.getString("email")));
    }
    return result;
}
✓ jOOQ 
DSLContext dsl = DSL.using(ds, SQLDialect.POSTGRES);

return dsl
    .select(USERS.ID, USERS.NAME, USERS.EMAIL)
    .from(USERS)
    .where(USERS.DEPARTMENT.eq(department)
        .and(USERS.SALARY.gt(minSalary)))
    .fetchInto(User.class);
هل ترى مشكلة في هذا الكود؟ أخبرنا.
لماذا يتفوق الأسلوب الحديث
🔒

أعمدة آمنة من حيث النوع

أسماء الأعمدة ثوابت Java مُولَّدة — تصبح الأخطاء المطبعية وعدم تطابق الأنواع أخطاء مترجم بدلاً من فشل وقت التشغيل.

📖

إتقان SQL

jOOQ DSL يعكس بناء SQL عن كثب فتبقى JOINs المعقدة والاستعلامات الفرعية و CTEs مقروءة.

🛡️

محمي من الحقن بتصميمه

المعاملات دائماً مرتبطة بأمان — لا تسلسل سلاسل يعني لا خطر حقن SQL.

الأسلوب القديم
JDBC الخام
الأسلوب الحديث
jOOQ SQL DSL
منذ JDK
11
الصعوبة
متوسط
دعم JDK
JDBC مقابل jOOQ
متاح

إصدار jOOQ مفتوح المصدر يدعم جميع قواعد البيانات مفتوحة المصدر الرئيسية؛ قواعد البيانات التجارية الأقدم تتطلب ترخيصاً مدفوعاً

كيف يعمل

يولّد jOOQ (الاستعلام الكائني التوجّه في Java) كود Java من مخطط قاعدة بياناتك محوّلاً أسماء الجداول والأعمدة إلى ثوابت Java آمنة من حيث النوع. DSL السائل يعكس بناء SQL ليكون الاستعلامات مقروءة وقابلة للتركيب. جميع المعاملات مرتبطة تلقائياً مما يُزيل خطر حقن SQL. بخلاف JPA/JPQL يحتضن jOOQ SQL بالكامل.

توثيق ذو صلة
jOOQ — Getting Started ↗ jOOQ — DSL API Reference ↗
أنماط ذات صلة
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 متقدم

JDBC ResultSet Mapping vs 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();
}
مرر للرؤية الحديث ←
JDK 11+ →
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 ⬡