如何使用EntityManager调用带OUT参数的复杂PL/SQL存储函数？

问题根源分析 #

你遇到的错误来自两个核心问题：

• 函数返回值的参数模式错误：将函数的返回值注册为ParameterMode.OUT，但PL/SQL函数的返回值需要用ParameterMode.RETURN模式。
• 参数名大小写不匹配：Oracle默认会把PL/SQL标识符转为大写，你代码中用小写参数名（如f_name）无法匹配数据库中的大写参数名（F_NAME）。

解决方案1：修正StoredProcedureQuery用法 #

按照以下步骤调整Java代码：

1. 用ParameterMode.RETURN注册函数的返回值参数。
2. 使用大写参数名匹配Oracle的默认标识符规则。
3. 按函数定义的顺序注册参数，确保参数类型和模式正确。

StoredProcedureQuery storedProcedureQuery = entityManager.createStoredProcedureQuery("schema.create_foo")
        // 注册函数返回值，模式为RETURN
        .registerStoredProcedureParameter("return", Integer.class, ParameterMode.RETURN)
        // 用大写参数名匹配Oracle数据库中的参数
        .registerStoredProcedureParameter("F_NAME", String.class, ParameterMode.IN)
        .registerStoredProcedureParameter("L_NAME", String.class, ParameterMode.IN)
        .registerStoredProcedureParameter("SOMENUM", Integer.class, ParameterMode.IN)
        .registerStoredProcedureParameter("SOMERESULT", String.class, ParameterMode.OUT)
        // 设置IN参数值
        .setParameter("F_NAME", "John")
        .setParameter("L_NAME", "Doe")
        .setParameter("SOMENUM", 0);

// 执行调用
storedProcedureQuery.execute();

// 获取返回值和OUT参数
Integer returnId = (Integer) storedProcedureQuery.getOutputParameterValue("return");
String someResult = (String) storedProcedureQuery.getOutputParameterValue("SOMERESULT");

解决方案2：使用NativeQuery执行PL/SQL块 #

如果StoredProcedureQuery的参数匹配问题仍存在，可以直接用NativeQuery编写PL/SQL调用块，更直观可控：

String plSql = "DECLARE " +
               "  v_result VARCHAR2(100); " +
               "  v_id NUMBER; " +
               "BEGIN " +
               "  v_id := schema.create_foo(:f_name, :l_name, :some_num, v_result); " +
               "  :return_id := v_id; " +
               "  :some_result := v_result; " +
               "END;";

Query query = entityManager.createNativeQuery(plSql)
        .setParameter("f_name", "John")
        .setParameter("l_name", "Doe")
        .setParameter("some_num", 0)
        // 注册输出参数
        .registerStoredProcedureParameter("return_id", Integer.class, ParameterMode.OUT)
        .registerStoredProcedureParameter("some_result", String.class, ParameterMode.OUT);

// 执行调用
query.execute();

// 获取结果
Integer returnId = (Integer) query.getOutputParameterValue("return_id");
String someResult = (String) query.getOutputParameterValue("some_result");

额外注意事项 #

• 确保schema是函数所在的正确数据库模式（用户），如果当前连接用户就是函数所属用户，可以省略schema.前缀。
• 如果PL/SQL函数中的someNum是NUMBER类型，Java中用Integer.class或Long.class都可，根据实际数值范围选择。
• 测试时可以先在PL/SQL Developer或SQL*Plus中手动调用函数，确认函数本身可正常运行。

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