如何用Hibernate调用含对象类型参数的Oracle函数？

问题原因 #

你遇到的PLS-00306错误，本质是Java的POJO对象无法直接被Hibernate/JDBC映射为Oracle的自定义行类型t_RecordType。Oracle需要明确的类型转换规则，才能识别Java对象和数据库行类型的对应关系。

解决方案步骤 #

1. 实现SQLData接口封装行类型 #

创建对应t_RecordType的Java类，实现java.sql.SQLData接口，明确和数据库行类型的映射规则：

@Data
public class RecordType implements SQLData, Serializable {
    // 对应t_RecordType的150个字段，和数据库列名一一对应
    private Long id;
    // 其他149个字段...

    private static final String SQL_TYPE_NAME = "T_RECORDTYPE"; // 注意是数据库中类型的大写名称

    @Override
    public String getSQLTypeName() throws SQLException {
        return SQL_TYPE_NAME;
    }

    @Override
    public void readSQL(SQLInput stream, String typeName) throws SQLException {
        // 按照数据库行类型的字段顺序读取，顺序必须和t_RecordType定义一致
        this.id = stream.readLong();
        // 依次读取其他字段，比如stream.readString()、stream.readInt()等
    }

    @Override
    public void writeSQL(SQLOutput stream) throws SQLException {
        // 按照数据库行类型的字段顺序写入，顺序必须和t_RecordType定义一致
        stream.writeLong(this.id);
        // 依次写入其他字段
    }
}

注意：readSQL和writeSQL的字段顺序必须严格和Oracle中t_RecordType的定义顺序一致，不能只看列名，否则会出现类型不匹配或字段值错位。

2. 修改Hibernate调用代码 #

需要借助Oracle JDBC的StructDescriptor和STRUCT来处理参数，同时正确设置输出参数的类型：

EntityManager em = emf.createEntityManager();
Session sess = em.unwrap(Session.class);
Connection conn = sess.doReturningWork(connection -> connection);

// 初始化输入参数的Struct
StructDescriptor inputDesc = StructDescriptor.createDescriptor(RecordType.SQL_TYPE_NAME, conn);
Object[] inputAttrs = new Object[]{
        input.getId(),
        // 其他149个字段的值，顺序和RecordType的read/writeSQL一致
};
STRUCT inputStruct = new STRUCT(inputDesc, conn, inputAttrs);

// 调用PL/SQL块
CallableStatement cs = conn.prepareCall("BEGIN ? := Compute(p_RecordIn => ?); END;");
// 设置输出参数：类型为STRUCT，指定自定义类型名称
cs.registerOutParameter(1, OracleTypes.STRUCT, RecordType.SQL_TYPE_NAME);
// 设置输入参数
cs.setObject(2, inputStruct);

cs.execute();

// 处理返回结果
STRUCT resultStruct = (STRUCT) cs.getObject(1);
Object[] resultAttrs = resultStruct.getAttributes();
// 将结果属性映射到你的MyResult对象
MyResult result = new MyResult();
result.setId((Long) resultAttrs[0]);
// 依次设置其他字段

cs.close();
conn.close();
return result;

3. 额外注意事项 #

• 确保数据库用户有访问t_RecordType的权限，否则会出现权限不足的错误。
• 如果使用的是Oracle 12c+，可以考虑使用OracleConnection的createStruct方法替代STRUCT构造器，更符合新版本JDBC规范：

  OracleConnection oracleConn = conn.unwrap(OracleConnection.class);
  STRUCT inputStruct = oracleConn.createStruct(RecordType.SQL_TYPE_NAME, inputAttrs);
  

• 若150个字段手动编写映射代码太繁琐，可以借助代码生成工具（比如基于数据库元数据生成SQLData实现类）来减少重复工作。

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