首页 / Enterprise / JDBC 与 jOOQ
Enterprise 中级

JDBC 与 jOOQ

用 jOOQ 类型安全的流畅 SQL DSL 替代原始 JDBC 字符串 SQL。

代码对比
✕ 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 流畅性

DSL 读起来像 SQL，但具有 Java 的类型安全性。

🔧

数据库模式感知

从实际数据库模式生成，始终与真实列对齐。

旧方式
原始 JDBC
现代方式
jOOQ SQL DSL
自 JDK
11
难度
中级
JDK 支持
JDBC 与 jOOQ
可用

jOOQ 开源版支持所有主要开源数据库；商业版支持专有数据库

工作原理

jOOQ（Java Object Oriented Querying）从数据库生成 Java 代码，提供类型安全的 SQL 构建。列名是生成的 Java 常量，因此拼写错误在编译时而非运行时捕获。

相关文档
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 ⬡