jOOQ：用 Java 代码写 SQL，编译器帮你兜底

mofangcode820

317人浏览 · 2026-06-23 09:32:23

mofangcode820 · 2026-06-23 09:32:23 发布

文章目录

jOOQ：用 Java 代码写 SQL，编译器帮你兜底

jOOQ：用 Java 代码写 SQL，编译器帮你兜底

jOOQ 在 GitHub 上有 6,733 个 Star，做的事情说白了就一件：让你在 Java 里用类型安全的方式写 SQL。

不是 ORM，不是 Query Builder 的又一个变种。jOOQ 的思路是把 SQL 语言本身映射成一套 Java DSL，再配合代码生成器，把数据库的表结构变成 Java 类。写出来的 SQL 在编译期就能检查对错，表名拼错、字段类型不匹配，直接编不过。

它解决什么问题

用字符串拼 SQL 是 Java 开发者的老痛点。拼错一个字段名，运行时才报错；参数类型传反了，数据库默默做隐式转换，结果对不上号。MyBatis 靠 XML 约束缓解了一部分，但 SQL 本身仍然是游离在编译体系之外的字符串。

jOOQ 的做法是：先连上数据库读取 schema，然后生成对应的 Java 代码。表、列、索引、外键关系全部变成类和方法。你写查询的时候，IDE 能自动补全表名和字段名，改了数据库结构重新生成代码，编译期就能发现所有不兼容的地方。

核心能力

jOOQ 的主要功能分两块。

代码生成器：连接目标数据库，读取元数据，输出一批 Java 类。这些类对应你的表、视图、存储过程，字段类型和数据库保持一致。

DSL API：基于生成的代码构建 SQL 查询。支持 SELECT、INSERT、UPDATE、DELETE、JOIN、子查询、窗口函数等全套 SQL 语法。写出来的代码直接翻译成目标数据库的方言，MySQL、PostgreSQL、Oracle、SQL Server 都能跑。

一个典型的查询长这样：

List<Film> result = dsl.select(
        FILM.TITLE,
        multiset(
          select(FILM.actor().FIRST_NAME, FILM.actor().LAST_NAME)
          .from(FILM.actor())
        ).as("actors").convertFrom(r -> r.map(mapping(Actor::new))),
        multiset(
          select(FILM.category().NAME)
          .from(FILM.category())
        ).as("categories").convertFrom(r -> r.map(Record1::value1))
    )
    .from(FILM)
    .orderBy(FILM.TITLE)
    .fetch(mapping(Film::new));