如何在Java中调用带%ROWTYPE和RECORD类型OUT参数的PL/SQL存储过程

现有一个PL/SQL存储过程，包含两个需注册的OUT参数：

1. 属于PACKAGE内定义的RECORD类型（核心输出值），定义如下：

CREATE PACKAGE schema2.my_package IS
  TYPE my_rec_type IS RECORD
  ( field1 VARCHAR2(40 CHAR) DEFAULT '0'
  , field2 VARCHAR2(240 CHAR)
  , field3 VARCHAR2(1 CHAR) DEFAULT '1'
  );
END my_package;

2. 属于%ROWTYPE类型，存储过程完整定义：

PROCEDURE schema2.myProcedure(
    p_my_tbl1_rec      IN     schema2.my_table1%ROWTYPE
  , p_my_tbl2_rec      IN     schema2.my_table2%ROWTYPE
  , p_to_my_table1_rec OUT    schema2.my_table1%ROWTYPE
  , p_my_rec           OUT    schema2.my_package.my_rec_type
)
BEGIN 
    -- 存储过程逻辑
END myProcedure;

目前已通过变通方式完成Java对象到%ROWTYPE输入参数的映射，但注册OUT参数时遇到两个问题：

• 用STRUCT注册%ROWTYPE类型参数无法正确定义
• 注册PACKAGE内的my_rec_type时提示找不到该类型

需求：

• 成功调用存储过程并验证执行状态
• 将p_my_rec映射为Java对象供后续使用
• 寻求调用带%ROWTYPE参数存储过程的替代方案

一、处理PACKAGE内RECORD类型的OUT参数（my_rec_type） #

PL/SQL PACKAGE内的RECORD属于程序级类型，JDBC无法直接识别数据库级元数据，需要通过Oracle JDBC扩展类手动描述其结构：

步骤1：Java端注册OUT参数 #

使用StructDescriptor指定PACKAGE内RECORD的全限定名称，再注册OUT参数：

// 假设conn是已获取的OracleConnection对象
CallableStatement cstmt = conn.prepareCall("{ call schema2.myProcedure(?, ?, ?, ?) }");

// 设置IN参数（已实现，此处省略具体赋值逻辑）
cstmt.setObject(1, myTbl1InputObj);
cstmt.setObject(2, myTbl2InputObj);

// 注册my_rec_type类型的OUT参数
StructDescriptor recDescriptor = StructDescriptor.createDescriptor("SCHEMA2.MY_PACKAGE.MY_REC_TYPE", conn);
cstmt.registerOutParameter(4, OracleTypes.STRUCT, recDescriptor.getSQLName());

步骤2：映射为Java对象 #

执行存储过程后，将返回的STRUCT转换为自定义Java对象：

// 执行存储过程
cstmt.execute();

// 获取OUT参数并转换
Struct myRecStruct = (Struct) cstmt.getObject(4);
Object[] attributes = myRecStruct.getAttributes();

// 映射到自定义Java对象
MyRec myRec = new MyRec();
myRec.setField1((String) attributes[0]);
myRec.setField2((String) attributes[1]);
myRec.setField3((String) attributes[2]);

二、处理%ROWTYPE类型的OUT参数 #

%ROWTYPE对应的是表的行结构，属于数据库隐式类型，可直接通过表的全限定名注册：

// 注册schema2.my_table1%ROWTYPE类型的OUT参数
cstmt.registerOutParameter(3, OracleTypes.STRUCT, "SCHEMA2.MY_TABLE1");

// 获取结果并转换
Struct tbl1OutStruct = (Struct) cstmt.getObject(3);
// 同样通过getAttributes()拆解字段映射到Java对象

三、调用带%ROWTYPE参数存储过程的替代方案 #

1. 改用数据库级OBJECT类型替代%ROWTYPE #

将%ROWTYPE参数替换为自定义的SQL OBJECT类型，此类属于数据库级对象，JDBC可直接识别元数据：

-- 先创建对应表的OBJECT类型
CREATE TYPE schema2.my_table1_obj AS OBJECT (
    -- 与my_table1字段一一对应
    col1 VARCHAR2(50),
    col2 NUMBER,
    col3 DATE
    -- 其他字段...
);
/

-- 修改存储过程参数类型
PROCEDURE schema2.myProcedure(
    p_my_tbl1_rec      IN     schema2.my_table1_obj
  , p_my_tbl2_rec      IN     schema2.my_table2_obj
  , p_to_my_table1_rec OUT    schema2.my_table1_obj
  , p_my_rec           OUT    schema2.my_package.my_rec_type
)
BEGIN 
    -- 逻辑不变，仅参数类型替换
END myProcedure;

Java端可直接用STRUCT映射OBJECT类型，无需额外的描述符定义。

2. 拆解%ROWTYPE为单个基础参数 #

如果表的字段数量不多，可将%ROWTYPE参数拆分为多个独立的基础类型参数（如VARCHAR2、NUMBER等），避免复杂的结构映射：

PROCEDURE schema2.myProcedure(
    -- 拆分my_table1%ROWTYPE为单个参数
    p_tbl1_col1        IN     VARCHAR2(50)
  , p_tbl1_col2        IN     NUMBER
  , p_tbl1_col3        IN     DATE
    -- 拆分my_table2%ROWTYPE同理...
  , p_to_tbl1_col1     OUT    VARCHAR2(50)
  , p_to_tbl1_col2     OUT    NUMBER
  , p_to_tbl1_col3     OUT    DATE
  , p_my_rec           OUT    schema2.my_package.my_rec_type
)
BEGIN 
    -- 逻辑调整为使用单个参数
END myProcedure;

Java端调用时直接注册和设置单个参数，无需处理STRUCT，实现更简单。

3. 实现OracleData接口自定义映射 #

通过实现Oracle JDBC的OracleData接口，自定义Java对象与PL/SQL类型的映射逻辑，支持更灵活的类型转换：

public class MyTable1Row implements OracleData {
    private String col1;
    private Integer col2;
    private Date col3;

    // 实现toOracle方法，将Java对象转换为数据库类型
    @Override
    public Datum toOracle(OracleConnection conn) throws SQLException {
        StructDescriptor desc = StructDescriptor.createDescriptor("SCHEMA2.MY_TABLE1", conn);
        Object[] attrs = {col1, col2, col3};
        return new STRUCT(desc, conn, attrs);
    }

    // 实现fromOracle静态方法，将数据库类型转换为Java对象
    public static MyTable1Row fromOracle(Datum datum, OracleConnection conn) throws SQLException {
        STRUCT struct = (STRUCT) datum;
        Object[] attrs = struct.getAttributes();
        MyTable1Row row = new MyTable1Row();
        row.col1 = (String) attrs[0];
        row.col2 = (Integer) attrs[1];
        row.col3 = (Date) attrs[2];
        return row;
    }

    // getter和setter方法
}

调用时可直接用setObject和getObject传递自定义对象，无需手动处理STRUCT。

内容的提问来源于stack exchange，提问作者JavaUser1923912