如何使用jOOQ使用自定义SGBD类型

Question

我想知道如何利用PostgresSQL最新版本中可以找到的new range types。

我可以找到有关如何使用自定义Java类型管理普通列的jOOQ文档，但是我找不到如何将自定义类型列用于自定义Java类型。在jOOQ中是否有文档或一段现有代码我可以查看并尝试贡献？

Answer 1

从jOOQ 3.6开始，没有明确支持这些RANGE类型。路线图上现在有一项功能请求（#2968）。

自定义转换器：

但是，您可以使用jOOQ 3.5 custom data type Binding自行实施支持。您基本上需要的是Converter，如下所示：

public class Int4RangeConverter implements Converter<Object, Range<Integer>> {
    private static final Pattern PATTERN = Pattern.compile("\\[(.*?),(.*?)\\)");

    @Override
    public Range<Integer> from(Object t) {
        if (t == null)
            return null;

        Matcher m = PATTERN.matcher("" + t);
        if (m.find())
            return Tuple.range(
                Integer.valueOf(m.group(1)), 
                Integer.valueOf(m.group(2)));

        throw new IllegalArgumentException("Unsupported range : " + t);
    }

    @Override
    public Object to(Range<Integer> u) {
        return u == null ? null : "[" + u.v1 + "," + u.v2 + ")";
    }

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

    @SuppressWarnings({ "unchecked", "rawtypes" })
    @Override
    public Class<Range<Integer>> toType() {
        return (Class) Range.class;
    }
}

以上转换器使用jOOL的org.jooq.lambda.tuple.Range类型，但您可以实现自己的类型，或者如果您愿意，只需使用int[]。

自定义绑定

Converter现在可以在Binding中使用，如下所示：

public class PostgresInt4RangeBinding implements Binding<Object, Range<Integer>> {

    @Override
    public Converter<Object, Range<Integer>> converter() {
        return new Int4RangeConverter();
    }

    @Override
    public void sql(BindingSQLContext<Range<Integer>> ctx) throws SQLException {
        ctx.render()
           .visit(DSL.val(ctx.convert(converter()).value()))
           .sql("::int4range");
    }

    // ...
}

More information about how to use custom data type bindings can be found in the manual。理想情况下，您将此绑定应用于生成的代码。

在SQL中使用Range类型：

使用它很简单。插入：

DSL.using(configuration)
   .insertInto(T_EXOTIC_TYPES)
   .columns(T_EXOTIC_TYPES.ID, T_EXOTIC_TYPES.RANGE_INT4)
   .values(1, range(1, 5))
   .execute();

选择：

assertEquals(range(1, 5), DSL.using(configuration).fetchValue(
    select(T_EXOTIC_TYPES.RANGE_INT4)
    .from(T_EXOTIC_TYPES)
    .where(rangeOverlaps(T_EXOTIC_TYPES.RANGE_INT4, range(0, 2))))
);

使用rangeOverlaps()的以下定义：

private static <T extends Comparable<T>> Condition rangeOverlaps(
    Field<Range<T>> f1, Range<T> f2) {
    return DSL.condition("range_overlaps({0}, {1})", f1, val(f2, f1.getDataType()));
}