在jOOQ中为MySQL自定义UUID类型的实现方案问询

1. 无需编写SQLDataType.BINARY代码副本，用自定义Binding即可实现 #

jOOQ支持通过**自定义数据类型绑定（Binding）**覆盖默认类型映射逻辑，你可以针对MySQL实现UUID与BINARY(16)的自动转换，同时保留MariaDB和H2的原生UUID支持，不用拆分代码。

示例Binding实现 #

import org.jooq.*;
import org.jooq.impl.DSL;
import java.sql.*;
import java.util.UUID;

public class MySQLUUIDBinaryBinding implements Binding<UUID, byte[]> {

    @Override
    public Converter<UUID, byte[]> converter() {
        return new Converter<>() {
            @Override
            public byte[] from(UUID uuid) {
                if (uuid == null) return null;
                byte[] bytes = new byte[16];
                long most = uuid.getMostSignificantBits();
                long least = uuid.getLeastSignificantBits();
                for (int i = 0; i < 8; i++) {
                    bytes[i] = (byte) (most >>> (8 * (7 - i)));
                    bytes[8 + i] = (byte) (least >>> (8 * (7 - i)));
                }
                return bytes;
            }

            @Override
            public UUID to(byte[] bytes) {
                if (bytes == null || bytes.length != 16) return null;
                long most = 0;
                long least = 0;
                for (int i = 0; i < 8; i++) {
                    most = (most << 8) | (bytes[i] & 0xFF);
                    least = (least << 8) | (bytes[8 + i] & 0xFF);
                }
                return new UUID(most, least);
            }

            @Override
            public Class<UUID> fromType() {
                return UUID.class;
            }

            @Override
            public Class<byte[]> toType() {
                return byte[].class;
            }
        };
    }

    @Override
    public void sql(BindingSQLContext<UUID> ctx) throws SQLException {
        if (ctx.configuration().dialect().family() == SQLDialect.MYSQL) {
            if (ctx.render().paramType() == ParamType.INLINED) {
                ctx.render().visit(DSL.val(ctx.convert(converter()).value())).sql("");
            } else {
                ctx.render().sql("UUID_TO_BIN(?)");
            }
        } else {
            ctx.render().visit(DSL.val(ctx.value()));
        }
    }

    @Override
    public void register(BindingRegisterContext<UUID> ctx) throws SQLException {
        ctx.statement().registerOutParameter(ctx.index(), Types.BINARY);
    }

    @Override
    public void set(BindingSetStatementContext<UUID> ctx) throws SQLException {
        ctx.statement().setBytes(ctx.index(), converter().from(ctx.value()));
    }

    @Override
    public void set(BindingSetSQLOutputContext<UUID> ctx) throws SQLException {
        ctx.output().writeBytes(converter().from(ctx.value()));
    }

    @Override
    public void get(BindingGetResultSetContext<UUID> ctx) throws SQLException {
        ctx.convert(converter()).value(ctx.resultSet().getBytes(ctx.index()));
    }

    @Override
    public void get(BindingGetStatementContext<UUID> ctx) throws SQLException {
        ctx.convert(converter()).value(ctx.statement().getBytes(ctx.index()));
    }

    @Override
    public void get(BindingGetSQLInputContext<UUID> ctx) throws SQLException {
        ctx.convert(converter()).value(ctx.input().readBytes());
    }
}

配置Binding的两种方式 #

• 代码生成时全局配置：在jOOQ代码生成器配置中指定该Binding，所有UUID类型列自动适配：

<!-- Maven代码生成器配置片段 -->
<generator>
  <database>
    <customTypes>
      <customType>
        <name>java.util.UUID</name>
        <binding>com.yourpackage.MySQLUUIDBinaryBinding</binding>
      </customType>
    </customTypes>
    <forcedTypes>
      <forcedType>
        <name>java.util.UUID</name>
        <includeTypes>UUID|BINARY\(16\)</includeTypes>
      </forcedType>
    </forcedTypes>
  </database>
</generator>

• 手动创建表时指定：在DSL语句中直接为列绑定该类型：

create.createTableIfNotExists("users")
    .column("user_uuid", SQLDataType.UUID.notNull().bind(new MySQLUUIDBinaryBinding()))
    .execute();

2. 关于BINARY(16) vs VARCHAR(36)的选择 #

10万条记录的量级，优先选择BINARY(16)，理由如下：

• 存储空间更优：BINARY(16)仅占16字节，VARCHAR(36)至少占37字节（含长度标识），单条记录节省21字节，10万条约节省2MB空间，索引磁盘占用也会大幅降低。
• 查询性能更好：固定长度的BINARY类型比可变长度VARCHAR更易被数据库优化，索引查找和排序效率更高。
• 维护成本可控：Binding是一次性实现，后续所有UUID列的CRUD操作都会自动适配转换逻辑，无需重复编写转换代码。

除非项目短期内无法投入时间实现Binding，否则不建议接受VARCHAR(36)方案。

内容的提问来源于stack exchange，提问作者helion3