Java如何调用返回记录集的Oracle函数_处理Function-Oracle-PHP中文网

Java调用Oracle返回REF CURSOR的函数必须用CallableStatement并注册Types.OTHER，否则抛Invalid column type异常；函数内禁用DML，否则触发ORA-14551；推荐12c+改用JSON字符串替代游标。

Oracle函数返回REF CURSOR时，Java必须用`CallableStatement`注册`Types.OTHER`

oracle的pl/sql函数若返回sys_refcursor（即记录集），java无法用preparedstatement处理——它只支持单值结果。必须用callablestatement调用，并显式注册out参数类型为types.other，否则会抛sqlexception: invalid column type。

常见错误是把函数当存储过程用executeUpdate()，或漏掉registerOutParameter。正确流程是：

SQL字符串形如{? = call my_pkg.get_data(?)} （问号顺序严格对应：第一个?是返回值，后续是IN参数）
调用cs.registerOutParameter(1, Types.OTHER)，索引从1开始
执行后用cs.getObject(1)拿到ResultSet对象，再强转

示例片段：

String sql = "{? = call pkg_data.get_users(?)}";
CallableStatement cs = conn.prepareCall(sql);
cs.registerOutParameter(1, Types.OTHER);
cs.setString(2, "ACTIVE");
cs.execute();
ResultSet rs = (ResultSet) cs.getObject(1); // 注意强转

函数体里不能有DML操作，否则JDBC调用会报`ORA-14551`

如果Oracle函数内部执行了INSERT/UPDATE/DELETE，哪怕加了PRAGMA AUTONOMOUS_TRANSACTION，JDBC仍可能触发ORA-14551: cannot perform a DML operation inside a query。这是因为JDBC默认以SELECT上下文调用函数，而Oracle禁止在纯查询中修改数据。

解决方法只有两个：

把函数改写为存储过程（PROCEDURE），用CallableStatement.execute()调用，不依赖返回值
彻底移除函数内的DML，把写操作拆到调用方Java代码里完成

别试图用SET TRANSACTION READ WRITE绕过——它对函数调用无效。

Oracle 12c+支持JSON_TABLE，Java可直接取JSON字符串避免REF CURSOR

如果Oracle版本≥12.1，且函数逻辑允许，更轻量的做法是让函数返回CLOB类型的JSON字符串（用JSON_OBJECT等构造），Java端用cs.getClob(1)读取后解析。这样避开REF CURSOR的驱动兼容性问题（尤其旧版ojdbc6对Types.OTHER支持不稳定）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

优势明显：

不用强转ResultSet，无类型擦除风险
JSON字段名、嵌套结构由SQL控制，Java侧更灵活
ojdbc7+对CLOB读取性能优于游标多次fetch

对应SQL示例：

FUNCTION get_users_json(p_status VARCHAR2) RETURN CLOB IS
  l_json CLOB;
BEGIN
  SELECT JSON_OBJECT(*) INTO l_json
  FROM users WHERE status = p_status;
  RETURN l_json;
END;

ojdbc驱动版本和连接属性影响REF CURSOR行为

ojdbc6默认关闭隐式游标关闭，可能导致连接池里连接被长时间占用；ojdbc8在implicitCachingEnabled=true时会自动close游标，但要求函数返回的游标未被Java显式close。容易踩的坑：

用完ResultSet后没调rs.close()，下一次调用同一连接会报ORA-01000: maximum open cursors exceeded
连接URL里漏配oracle.jdbc.autoCommitSpecCompliant=false，某些事务场景下游标提前失效
Web应用中，若函数返回大量数据，建议在CallableStatement上设setFetchSize(100)防内存溢出

真正麻烦的是跨不同Oracle小版本（比如11gR2 vs 19c）时，REF CURSOR的元数据获取方式有差异，rs.getMetaData().getColumnCount()可能返回0——这时得靠已知列名硬编码处理，没法完全动态。