如何从 Java 存储过程将 JDBC ResultSet 作为 Ref Cursor 返回

日期：2003 年 3 月 3 日

在阅读此方法文档以后，您应该能够：

• 创建将 JDBC 结果集作为 REF CURSOR 返回的 Java 存储过程

• 创建 Java 存储过程的调用规范

简介

本文档演示如何从 Java 存储过程将 JDBC ResultSet 作为 REF CURSOR 返回。JDBC ResultSet 是一个表示数据库的数据表，通常通过执行查询数据库的语句产生该表。REF CURSOR 是 PL/SQL 中相应的类型。Java 存储过程的调用规范将 ResultSet 映射到 REF CURSOR。在 Oracle9i 之前，不可能从 Java 存储过程直接返回一个 ResultSet，因为没有定义表单 ResultSet->REF CURSOR 的映射。Oracle9i 增加了此映射，允许从函数返回 ResultSet 或将其作为 OUT 参数传到某个过程。但它仍不支持逆向映射 (REF CURSOR->ResultSet)，因此当前版本的数据库仍然不支持 IN 和 IN OUT 参数。

在本方法指南中，我们拥有两个 Java 存储过程。Java 存储过程 getEmployees() 将 SCOTT 模式中 EMP 表的所有列装入 ResultSet 中并将其返回。Java 存储过程 getDepartments(ResultSet[] rout) 将 ResultSet 对象作为 OUT 参数并将 DEPT 表的所有列装入此 ResultSet 对象中。

软件需求

• Oracle9i Database 版本 9.0.1 或更高版本。您可从 Oracle 技术网下载 Oracle9i 数据库。

• JDK1.2.x 或以上版本。可以从此处下载。

说明

首先必须创建 Java 存储过程。以下为代码段。单击此处查看完整的 java 代码。

在 Java 存储过程中，可获得默认的服务器端对数据库的连接。默认情况下，由服务器端 JDBC 驱动程序创建的语句产生不能转换为 REF CURSOR 的 ResultSet 对象。要将 ResultSet 作为 REF CURSOR 返回，必须以特殊方式创建 Statement 或 PreparedStatement，即必须在创建该语句之前对 Connection 调用 setCreateStatementAsRefCursur(true)。如果不能在创建 ResultSet 并将其作为 REF CURSOR 返回之前调用 setCreateStatementAsRefCursor(true)，则在执行 Java 存储过程时将会导致出现下列错误消息：

ORA-00932:inconsistent datatypes

一旦对此 Connection 对象调用了 setCreateStatementAsRefCursor(true)，由对此连接的查询返回的所有 ResultSet 可以转换为 REF CURSOR。

Java 存储过程列表 1

public static ResultSet getEmployees() {
.............
.............
// Obtain default connection
  Connection conn = new OracleDriver().defaultConnection();

// Create any subsequent statements as a REF CURSOR 
  ((OracleConnection)conn).setCreateStatementAsRefCursor(true);


// Create the statement
Statement stmt = conn.createStatement();

// Query all columns from the EMP table
ResultSet rset = stmt.executeQuery("select * from emp");

// Return the ResultSet (as a REF CURSOR)
  return rset;
...........
...........

public static void getDepartments( ResultSet[] rout ) {
............
............
// Obtain the default connection
  Connection conn = new OracleDriver().defaultConnection();


// Create any subsequent statements as a REF CURSOR
  ((OracleConnection)conn).setCreateStatementAsRefCursor(true);

// Create the statement
  Statement stmt = conn.createStatement();

// do a simple query
  ResultSet rset = stmt.executeQuery("select * from dept");

// return the ResultSet (as a REF CURSOR)
  rout[0] = rset;
...........
...........

上面的 Java 存储过程 getDepartments( ResultSet[] rout ) 查询 DEPT 表的所有行并在 OUT 参数中返回 ResultSet。

如要观看应用程序的运行，请将 Java 类加载到您数据库的 SCOTT 模式中。

>loadjava -thin -user scott/tiger@<hostname>:<port>:<SID> -resolve -verbose RefCursor.java

其中：

例如：

>loadjava -thin -user scott/tiger@insn104a.idc.oracle.com:1521:otn9idb -resolve -verbose RefCursor.java

然后创建 Java 存储过程的调用规范。连接到 SCOTT/TIGER 用户并在 SQL 提示符处执行以下代码

create or replace package refcurpkg is
type refcur_t is ref cursor;
end refcurpkg;
/


create or replace function getemps return refcurpkg.refcur_t is
language java name 'RefCursor.getEmployees() return java.sql.ResultSet'; 
/

create or replace procedure getdepts(cur OUT refcurpkg.refcur_t) is
language java name 'RefCursor.getDepartments(java.sql.ResultSet[])';
/

现在可以通过在 SQL 提示符处执行以下代码来测试 Java 存储过程

SQL>variable x refcursor
SQL>execute :x := getemps;
SQL>print x

此操作将打印 SCOTT 模式中 EMP 表的内容。

SQL>execute getdepts(:x);
SQL>print x

此操作将打印 SCOTT 模式中 DEPT 表的内容。

资源

• Java 存储过程示例可在/global/cn/sample_code/tech/java/jsp/index.html 处获得
• 关于开发 Java 存储过程的白皮书可在 /tech/java/jsp/pdf/stored_procs_in_java_twp.pdf 处获得

总结

本文说明了如何创建将 JDBC ResultSet 作为 REF CURSOR 返回的 Java 存储过程，以及如何为Java 存储过程编写调用规范。