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

本文档演示如何从 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 对象中。 在Java编程中，与数据库交互通常涉及使用JDBC（Java Database Connectivity）API。JDBC提供了一种标准的方式来访问各种数据库，包括SQL查询的执行、结果集（ResultSet）的处理等。ResultSet是JDBC中用于存储查询结果的一个接口，它表示从数据库中检索的数据集。而REF CURSOR则是PL/SQL（Oracle数据库的存储过程语言）中的一个概念，它相当于一个指向结果集的指针，可以在PL/SQL中动态打开和关闭。 在Oracle9i之前的版本，直接从Java存储过程返回ResultSet是不被支持的，因为缺乏ResultSet到REF CURSOR的映射机制。然而，Oracle9i引入了这种映射，使得Java存储过程能够返回ResultSet或作为OUT参数传递。尽管如此，从REF CURSOR到ResultSet的逆向映射仍然不被支持，这意味着在当前版本中，你无法将REF CURSOR作为IN或IN OUT参数传递给Java存储过程。 为了从Java存储过程返回一个ResultSet作为REF CURSOR，需要特别处理JDBC的Connection对象。在创建Statement或PreparedStatement之前，需要调用Connection的setCreateStatementAsRefCursor(true)方法。这将确保任何后续的查询都将返回可以转换为REF CURSOR的ResultSet。如果不进行这个设置，试图将ResultSet作为REF CURSOR返回会导致错误，例如"ORA-00932: inconsistent datatypes"。 以下是一个示例Java存储过程，展示了如何从数据库中获取EMP表的所有数据并以REF CURSOR的形式返回： ```java public static ResultSet getEmployees() { // 获取默认连接 Connection conn = new OracleDriver().defaultConnection(); // 设置创建Statement为REF CURSOR模式 ((OracleConnection)conn).setCreateStatementAsRefCursor(true); // 创建Statement Statement stmt = conn.createStatement(); // 执行查询 ResultSet rset = stmt.executeQuery("select * from emp"); // 返回ResultSet（作为REF CURSOR） return rset; } ``` 另一个例子展示了如何接收一个ResultSet OUT参数，并将DEPT表的数据填充到这个ResultSet中： ```java public static void getDepartments(ResultSet[] rout) { // 获取默认连接 Connection conn = new OracleDriver().defaultConnection(); // 创建PreparedStatement，因为可能需要绑定变量 PreparedStatement pstmt = conn.prepareStatement("select * from dept"); // 执行查询并将结果保存到ResultSet数组的第一个元素 ResultSet rset = pstmt.executeQuery(); rout[0] = rset; } ``` 在上述例子中，getDepartments()方法接收一个ResultSet类型的数组作为OUT参数。由于Java不直接支持REF CURSOR作为参数类型，我们使用数组来模拟这一行为。当存储过程执行完毕后，DEPT表的所有数据会被填充到rout数组的第一个元素中。 为了运行这些Java存储过程，你需要在数据库中注册它们，并且在PL/SQL环境中调用。这通常涉及到创建Java源代码、编译它、创建Java类和存储过程，然后在PL/SQL中执行这些存储过程。注意，这些操作需要具备相应的数据库权限。 总结来说，从Java存储过程返回JDBC ResultSet作为REF CURSOR，主要是为了解决Oracle数据库的特性和JDBC的兼容问题。通过Oracle9i引入的特性，开发者可以利用这种方法在PL/SQL和Java之间更灵活地交换数据。然而，这种方法有一些限制，如不支持REF CURSOR到ResultSet的逆向映射，因此在设计和实现时需要特别注意。