如何配置jOOQ代码生成器生成Set<T>替代Array<T>？

数据库中ARRAY列具备Java Set的顺序无关语义，但jOOQ生成器默认生成Array<T>类型的POJO/Record字段，导致数组顺序不同时被判定为不相等。尝试自定义转换器时，Set<String>::class.java因泛型类型擦除无法编译，报错信息：

Only classes are allowed on the left hand side of a class literal

以下是几种可行的解决方案：

方法一：实现Converter接口并使用GenericType保留泛型信息 #

放弃继承AbstractConverter，直接实现jOOQ的Converter接口，通过GenericType捕获泛型类型参数，避免类型擦除问题：

import org.jooq.Converter
import org.jooq.GenericType

class ArrayToSetConverter : Converter<Array<String>, Set<String>> {
    override fun from(databaseObject: Array<String>?): Set<String>? {
        return databaseObject?.toSet()
    }

    override fun to(userObject: Set<String>?): Array<String>? {
        return userObject?.toTypedArray()
    }

    override fun fromType(): Type = Array<String>::class.java
    override fun toType(): Type = object : GenericType<Set<String>>() {}
}

方法二：使用AbstractConverter并添加unchecked类型转换 #

如果坚持使用AbstractConverter，可以将原始类型Set::class.java强制转换为Class<Set<String>>，并抑制unchecked转换警告：

import org.jooq.AbstractConverter

@Suppress("UNCHECKED_CAST")
class ArrayToSetConverter :
    AbstractConverter<Array<String>, Set<String>>(
        Array<String>::class.java,
        Set::class.java as Class<Set<String>>
    ) {
    override fun from(databaseObject: Array<String>?): Set<String>? {
        return databaseObject?.toSet()
    }

    override fun to(userObject: Set<String>?): Array<String>? {
        return userObject?.toTypedArray()
    }
}

方法三：通过jOOQ代码生成器配置直接生成Set类型字段 #

在jOOQ代码生成器配置中指定自定义类型映射，让生成的POJO/Record直接使用Set<String>类型，从根源解决问题：

XML配置示例 #

<configuration>
  <generator>
    <database>
      <customTypes>
        <customType>
          <name>java.util.Set&lt;String&gt;</name>
          <converter>com.yourpackage.ArrayToSetConverter</converter>
          <types>ARRAY</types>
        </customType>
      </customTypes>
      <forcedTypes>
        <forcedType>
          <name>java.util.Set&lt;String&gt;</name>
          <includeExpression>YOUR_ARRAY_COLUMN_NAME</includeExpression>
        </forcedType>
      </forcedTypes>
    </database>
  </generator>
</configuration>

注意事项 #

• 确保转换器的from和to方法处理null值，避免空指针异常
• 若数组元素为其他类型（如Integer），只需替换泛型参数即可
• 使用GenericType是jOOQ推荐的泛型类型转换方案，能更好地保留类型信息

相关未解决问题：Kotlin中jOOQ从String转List的转换器问题

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