在Java中调用Oracle包内存储过程该怎么传递数组参数？-Oracle-PHP中文网

Java调用Oracle存储过程数组参数必须用oracle.sql.ARRAY封装，关键步骤包括：获取与PL/SQL定义完全一致的ArrayDescriptor（含schema和大小写），用OracleConnection创建ARRAY实例，注册Types.ARRAY类型，并严格匹配参数位置、方向及字符集配置。

在java中调用oracle包内存储过程该怎么传递数组参数？

Oracle 存储过程的数组参数在 Java 中必须用 `ARRAY` 类型封装

Java 原生不识别 Oracle 的 VARCHAR2_TABLE、NUMBER_TABLE 等自定义集合类型，直接传 String[] 或 Integer[] 会报 java.sql.SQLException: Invalid column type。必须通过 oracle.sql.ARRAY 将 Java 数组转为 Oracle 可识别的集合实例。

关键步骤：

先用 Connection 获取 ArrayDescriptor，名称必须和 Oracle 包里定义的集合类型**完全一致**（区分大小写，含 schema）；例如包 pkg_util 定义了 TYPE str_list_t IS TABLE OF VARCHAR2(100)，则描述符名应为 "PKG_UTIL.STR_LIST_T"
构造 ARRAY 实例时，元素类型要匹配：字符串数组用 new Object[]{...}，数字数组用 new BigDecimal[]{...}（Oracle NUMBER 对应 BigDecimal，不是 Integer）
注册为 Types.ARRAY，不能用 Types.VARCHAR 或其他标量类型

`CallableStatement` 设置 `ARRAY` 参数前必须确保连接支持 Oracle 扩展

标准 JDBC DriverManager.getConnection() 返回的 Connection 默认不启用 Oracle 特有类型支持。若跳过这步，createARRAY() 会抛 java.lang.AbstractMethodError 或空指针。

正确做法：

使用 oracle.jdbc.pool.OracleDataSource 或从 Web 容器（如 Tomcat）JNDI 获取 OracleConnection，而非普通 java.sql.Connection
若只能拿到标准 Connection，需强制向下转型：OracleConnection oc = connection.unwrap(OracleConnection.class)，并确认驱动版本 ≥ 12c（11g 部分版本 unwrap 失败）
调用 oc.createARRAY(descriptor, elements) 创建数组对象，再用 cs.setArray(index, array)

Oracle 包内存储过程调用时，数组参数位置和 IN/OUT 方向必须与 PL/SQL 声明严格对应

常见错误是 Java 里把数组设成了第 2 个参数，但 PL/SQL 过程定义中它是第 3 个 IN 参数，或误将 OUT 数组当成 IN 传入空数组 —— 这会导致 ORA-06550 或静默失败。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

检查要点：

PL/SQL 过程签名如 PROCEDURE proc_with_array(p_ids IN number_table, p_names OUT varchar2_table)，Java 中第 1 个 setArray() 必须对应 p_ids，且方向为 IN；第 2 个需用 registerOutParameter(pos, Types.ARRAY, "SCHEMA.NUMBER_TABLE") 注册 p_names
数组长度为 0 是合法的，但 Oracle 不接受 null 数组（会报 ORA-06502），Java 侧传空数组要用 new Object[0]，别传 null
如果过程在包体内（非 schema 级），调用 SQL 字符串必须写全名：{CALL pkg_name.proc_name(?, ?)}，不能省略包名

驱动版本和数据库字符集不匹配会导致数组元素乱码或截断

尤其当 Oracle 数据库字符集是 ZHS16GBK，而 Java 使用 UTF-8 且驱动未显式配置时，ARRAY 中的中文可能变成问号或长度异常（如 VARCHAR2(100) 在 Java 里被截成 50 个汉字）。

规避方式：

连接 URL 加参数：?useUnicode=true&characterEncoding=GBK（与 DB 字符集一致），或升级到 ojdbc8+ 并设置 oracle.jdbc.convertNcharLiterals=true
避免在数组元素里混用不同长度语义的类型：比如 PL/SQL 用 VARCHAR2(200 CHAR)，Java 传入超长字符串时，Oracle 可能按字节截断，而非字符
调试时打印 array.length() 和 array.getArray() 结果，确认实际传递的元素数量和内容是否符合预期

最易被忽略的是 ArrayDescriptor 名称里的 schema 前缀 —— 很多人本地测试用 SCOTT.MY_ARRAY_TYPE 没问题，上线后因用户权限或 synonym 导致 descriptor 查找不到，错误信息却只提示“invalid name”，得翻 Oracle 日志才能定位。