jooq 记录在获取数据时是否使用列索引？

Question

我正在调查一个问题，我们看到与 jooq 试图填充生成的 Record 类相关的奇怪异常，因为它使用 java.sql.ResultSet::getXXX(int)（基于列索引) 来获取数据。

我可以分享的堆栈跟踪部分如下所示：

Caused by: java.sql.SQLDataException: Value 'ABC' is outside of valid range for type java.lang.Byte
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:114)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:89)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:63)
    at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:73)
    at com.mysql.cj.jdbc.exceptions.SQLExceptionsMapping.translateException(SQLExceptionsMapping.java:92)
    at com.mysql.cj.jdbc.result.ResultSetImpl.getObject(ResultSetImpl.java:1423)
    at com.mysql.cj.jdbc.result.ResultSetImpl.getByte(ResultSetImpl.java:710)
    at com.zaxxer.hikari.pool.HikariProxyResultSet.getByte(HikariProxyResultSet.java)
    at org.jooq.tools.jdbc.DefaultResultSet.getByte(DefaultResultSet.java:124)
    at org.jooq.tools.jdbc.DefaultResultSet.getByte(DefaultResultSet.java:124)
    at org.jooq.impl.CursorImpl$CursorResultSet.getByte(CursorImpl.java:688)
    at org.jooq.impl.DefaultBinding$DefaultByteBinding.get0(DefaultBinding.java:1783)
    at org.jooq.impl.DefaultBinding$DefaultByteBinding.get0(DefaultBinding.java:1755)
    at org.jooq.impl.DefaultBinding$AbstractBinding.get(DefaultBinding.java:871)
    at org.jooq.impl.CursorImpl$CursorIterator$CursorRecordInitialiser.setValue(CursorImpl.java:1725)

这肯定是使用错误的列索引导致的列不匹配。

问题出现是因为我们在不断发展的架构上使用记录，因此基础表包含记录定义中不可用的列。

请注意，触发此操作的实际代码是：

jooq.insertInto(TABLE)
    .set(TABLE.COL, "ABC")
    .returning(TABLE.asterisk())
    .fetchOne();

这里让我有点害怕的是，如果它确实按设计使用列索引，那将使架构演变有些困难（如何从正在运行的应用程序中删除列）。

长话短说（对不起），问题是：jooq 是否在 jooq-generator 生成的记录中使用列索引，有没有办法使用列名代替？

我注意到的一件事是，当我比较https://www.jooq.org/doc/3.14/manual/code-generation/codegen-records/ 的文档时，显示的生成记录与生成器实际生成的记录不匹配。文档显示的方法如下：

// Every column generates a setter and a getter
@Override
public void setId(Integer value) {
    setValue(BOOK.ID, value);
}

但实际上生成的代码看起来像（取自jOOQ-examples）：

/**
 * Setter for <code>PUBLIC.BOOK.ID</code>.
 */
public void setId(Integer value) {
    set(0, value);
}

顺便说一句，我们使用的是 jooq 3.14.15。

Answer 1

好的，这是一个本地错误。真正导致问题的原因是我们的代码写成：

jooq.insertInto(TABLE)
    .set(TABLE.COL, "ABC")
    .returning(TABLE.asterisk())
    .fetchOne();

TABLE.asterisk() 搞砸了（因为在包含额外列的数据库上，它不会返回 jooq 所期望的）。幸运的是，删除它解决了问题，所以我们的代码现在看起来像：

jooq.insertInto(TABLE)
    .set(TABLE.COL, "ABC")
    .returning()
    .fetchOne();