Luca Ferrari：使用PL/Java返回SETOF RECORD
内容提要
本文介绍用PL/Java实现返回SETOF RECORD的函数：实现ResultSetProvider接口的assignRowValues和close方法逐行填充结果集，编写返回ResultSetProvider的PL/Java函数，PostgreSQL将其包装为RETURNS SETOF RECORD；函数可传参动态控制行数，SQL中按列定义调用查询，结果集用完后自动关闭。
延伸解读
行号从0开始：PL/Java与SQL的差异
在assignRowValues方法中，传入的row参数从0开始计数，这与Java数组习惯一致，但不同于SQL中常见的从1开始。示例中当row > maxRows时返回false结束结果集，因此实际生成的行数比maxRows多一行（例如maxRows=20时生成0到20共21行）。调用时需注意这一差异，避免行数不符合预期。
动态控制行数：参数传递与默认值处理
通过为PL/Java函数添加int参数，可以在SQL调用时动态指定要生成的行数。示例中当传入参数小于等于0时，函数内部将其重置为5，确保至少生成5行。这种设计提供了灵活性，但调用者需注意参数的有效范围，避免传入非正数导致意外结果。
结果集自动关闭与日志观察
当assignRowValues返回false后，PL/Java会自动调用close方法关闭结果集，无需手动干预。示例中通过日志可以看到“Closing resultset”消息，这有助于调试和确认资源释放。在实际使用中，可以依赖这一机制管理资源，但也要注意在close中执行必要的清理操作。
Q&A
PL/Java 中如何实现一个返回 SETOF RECORD 的函数？
需要实现 ResultSetProvider 接口，提供 assignRowValues 和 close 方法，然后编写一个返回 ResultSetProvider 的 PL/Java 函数，PostgreSQL 会自动将其包装为 RETURNS SETOF RECORD。
ResultSetProvider 接口的 assignRowValues 方法有什么作用？
assignRowValues 为结果集中的每一行调用，用于填充当前行的数据。它接收 ResultSet 和当前行号（从0开始），返回 true 表示添加了新行，返回 false 表示结果集完成。
如何在 PL/Java 中动态控制返回的行数？
在 PL/Java 函数中添加一个整数参数，将其传递给 ResultSetProvider 的构造函数，从而在运行时决定生成的行数。例如，函数 rs_producer_pljava(int howManyRows) 可以动态设置行数。
在 SQL 中如何调用返回 SETOF RECORD 的 PL/Java 函数？
使用 SELECT 语句，并在 FROM 子句中调用函数，同时通过 AS 子句定义返回的列名和类型。例如：SELECT j.* FROM rs_producer_pljava() AS j(t text, r int, m int, d date);
PL/Java 的 ResultSetProvider 中的 close 方法何时被调用？
close 方法在结果集被关闭时调用，通常是在 assignRowValues 返回 false 表示结果集完成后，或者结果集被显式关闭时。
使用 PL/Java 返回 SETOF RECORD 有什么优势？
PL/Java 允许轻松实现结果集提供者，可以基于已有代码生成行数据，并且能够动态控制行数，与 SQL 查询无缝集成。
