在 java 中使用 preparedstatement 设置 ref 参数时,核心做法是调用 setobject(int parameterindex, ref x) 方法。你需要先通过 connection.createref(string typename, object value) 创建一个 java.sql.ref 实例,然后将其作为参数传入预编译语句中。这样做会将数据库中的结构化类型(structured type)或引用类型正确地绑定到 sql 语句的占位符上,从而允许你在执行查询或更新操作时传递复杂的对象引用。

createRef 方法如何创建 Ref 对象
要获取一个 Ref 对象,必须依赖当前的 Connection 实例。数据库驱动通常要求你提供结构化类型的名称以及该类型的主键值。例如,如果数据库中有一个名为 ADDRESS_TYPE 的结构化类型,且其主键为 1001,你可以使用 createRef 方法来构建这个引用。这个方法返回的是一个 Ref 接口实现,它封装了对数据库对象的引用,而不是对象本身的数据内容。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.Ref;
public class RefExample {
public static void main(String[] args) throws Exception {
// 假设已建立连接
Connection conn = DriverManager.getConnection("jdbc:your_db_url", "user", "pass");
// 1. 创建 Ref 对象
// 参数1: 数据库中的结构化类型名
// 参数2: 该类型实例的主键值
Ref addressRef = conn.createRef("ADDRESS_TYPE", 1001);
// 2. 准备 SQL 语句
String sql = "INSERT INTO EMPLOYEES (EMP_ID, HOME_ADDRESS_REF) VALUES (?, ?)";
PreparedStatement pstmt = conn.prepareStatement(sql);
// 3. 设置参数
pstmt.setInt(1, 5001); // 设置员工ID
pstmt.setObject(2, addressRef); // 设置 Ref 参数
// 4. 执行
pstmt.executeUpdate();
// 清理资源
pstmt.close();
conn.close();
}
}
上述代码展示了完整的流程。首先通过 DriverManager 获取连接,接着调用 conn.createRef 指定类型名和主键。这里的关键在于 setType 和主键值必须与数据库 schema 中定义的一致。随后,PreparedStatement 的 setObject 方法被用来绑定这个 Ref 对象。注意,不能使用 setRef 方法,因为 PreparedStatement 接口中并没有定义 setRef,只有 setObject 支持 Ref 类型。
从 ResultSet 中获取 Ref 并重新设置
在实际开发中,你可能需要从查询结果中提取 Ref 对象,并将其用于后续的插入或更新操作中。这涉及到两个步骤:首先从 ResultSet 中读取 Ref,然后将其设置给另一个 PreparedStatement。需要注意的是,不同数据库对 Ref 的支持程度不同,部分驱动可能在获取时返回代理对象,直接赋值给新的预编译语句通常是可以工作的,但需确保连接上下文一致。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.Ref;
import java.sql.ResultSet;
public class RefTransferExample {
public static void main(String[] args) throws Exception {
Connection conn = DriverManager.getConnection("jdbc:your_db_url", "user", "pass");
// 第一步:查询获取 Ref
String selectSql = "SELECT ADDRESS_REF FROM EMPLOYEES WHERE EMP_ID = ?";
PreparedStatement selectPstmt = conn.prepareStatement(selectSql);
selectPstmt.setInt(1, 5001);
ResultSet rs = selectPstmt.executeQuery();
Ref sourceRef = null;
if (rs.next()) {
sourceRef = rs.getRef("ADDRESS_REF");
}
selectPstmt.close();
rs.close();
if (sourceRef != null) {
// 第二步:将获取到的 Ref 设置给新的语句
String insertSql = "INSERT INTO TEMP_RECORDS (REF_VALUE) VALUES (?)";
PreparedStatement insertPstmt = conn.prepareStatement(insertSql);
insertPstmt.setObject(1, sourceRef); // 直接使用之前获取的 Ref
insertPstmt.executeUpdate();
insertPstmt.close();
}
conn.close();
}
}
这段代码演示了数据的流转。通过 rs.getRef() 获取引用后,我们直接将其传递给新的 PreparedStatement 的 setObject 方法。这种场景常见于数据迁移或中间表处理。关键点在于 getRef 返回的对象可以直接复用,无需重新创建。如果数据库不支持结构化类型,此操作可能会抛出 SQLException,因此在生产环境中应做好异常捕获。
当 Ref 指向的类型不存在时会发生什么
如果在调用 createRef 时指定的类型名在数据库中不存在,或者主键对应的记录不存在,驱动程序的行为取决于具体的实现。大多数情况下,createRef 可能不会立即验证类型的存在性,而是创建一个本地引用对象。然而,当执行 PreparedStatement 时,数据库服务器会进行校验。如果类型无效或引用失效,通常会抛出 SQLException,错误信息可能包含 "Invalid type name" 或 "Reference not found" 等字样。因此,确保类型名准确无误是避免运行时错误的关键。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










