jOOQ代码生成器对表值函数的支持优化

在数据库开发中，表值函数(TVF)是一种特殊的函数类型，它能够返回一个结果集而不是单一值。jOOQ作为一个强大的Java数据库工具，近期对其代码生成器中表值函数的处理方式进行了重要改进。

原有实现的问题

在jOOQ之前的版本中，表值函数主要通过<tableValuedFunctions/>配置项来控制代码生成行为。当启用此选项时，jOOQ会为表值函数生成特殊的Table对象，允许开发者使用类似ctx.selectFrom(Routines.f(1, 2)).fetch()这样的便捷语法进行调用。

然而，这种实现存在一个明显的局限性：无法像处理普通存储过程那样利用默认参数值。对于有默认参数的函数，开发者必须显式提供所有参数值，无法省略那些有默认值的参数。

新解决方案

为了解决这个问题，jOOQ 3.21.0引入了两个新的配置选项来替代原有的<tableValuedFunctions/>：

1. <tableValuedFunctionsAsRoutines/>：控制是否生成常规的Routine对象，默认值为true
2. <tableValuedFunctionsAsTable/>：控制是否生成特殊的Table对象，默认值同样为true

这种分离的设计带来了更大的灵活性：

• 开发者现在可以同时获得两种调用方式
• 可以自由选择只生成其中一种形式
• 对于有默认参数的函数，可以使用Routine对象来省略参数

不同数据库的支持情况

需要注意的是，不同数据库对表值函数的支持存在差异：

仅支持Routine形式：

• H2数据库

仅支持Table形式：

• Firebird
• SQL Server

同时支持两种形式：

• Databricks
• HSQLDB
• Oracle
• PostgreSQL
• Snowflake

迁移建议

对于现有项目，建议逐步迁移到新的配置方式。虽然旧有的<tableValuedFunctions/>配置仍然可用，但未来版本可能会将其标记为废弃。

新的配置方式不仅解决了参数默认值的问题，还为开发者提供了更细粒度的控制能力，使得jOOQ在处理表值函数时更加灵活和强大。对于需要同时使用两种调用方式的场景，现在无需再通过多次运行代码生成器来实现了。