在 java 中设置 nclob 参数,核心做法是调用 preparedstatement.setncharacterstream() 方法。该方法接受字符流作为输入,能自动处理 unicode 数据并映射到数据库的 nlob 类型。如果驱动支持,也可以直接使用 setnclob() 传入 java.sql.nclob 对象,但使用字符流通常更通用且易于实现。

setNCharacterStream 如何指定长度和读取数据
使用 setNCharacterStream 时,必须显式指定流的长度(以字符为单位),否则部分 JDBC 驱动可能无法正确分配缓冲区或抛出异常。写入完成后,需要关闭流以确保数据被刷新到数据库。读取时,通过 ResultSet.getNCharacterStream() 获取字符流进行解析。

import java.io.StringReader;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
public class NclobExample {
public static void main(String[] args) {
String url = "jdbc:mysql://localhost:3306/testdb"; // 需确保驱动支持 NClob
String user = "root";
String password = "password";
String sql = "INSERT INTO test_table (id, ntext_col) VALUES (?, ?)";
String selectSql = "SELECT ntext_col FROM test_table WHERE id = ?";
try (Connection conn = DriverManager.getConnection(url, user, password);
PreparedStatement pstmt = conn.prepareStatement(sql)) {
String largeText = "这是一段很长的中文文本...";
int length = largeText.length();
// 设置 NClob 参数
pstmt.setInt(1, 1);
pstmt.setNCharacterStream(2, new StringReader(largeText), length);
pstmt.executeUpdate();
// 读取验证
try (PreparedStatement selectPstmt = conn.prepareStatement(selectSql);
ResultSet rs = selectPstmt.executeQuery()) {
selectPstmt.setInt(1, 1);
if (rs.next()) {
try (java.io.Reader reader = rs.getNCharacterStream(1)) {
char[] buffer = new char[1024];
StringBuilder sb = new StringBuilder();
int len;
while ((len = reader.read(buffer)) != -1) {
sb.append(buffer, 0, len);
}
System.out.println("Read NClob: " + sb.toString());
}
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
setNClob 与 setNCharacterStream 的区别
setNClob 要求传入一个已经存在的 NClob 实例,这通常需要通过 Connection.createNClob() 创建。这种方式适用于数据已经在内存中构建为 NClob 对象的场景。而 setNCharacterStream 直接接受流,更适合从文件、网络或其他流式来源读取大数据的场景,避免了将整个大对象加载到内存中。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import java.io.StringReader;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.NClob;
import java.sql.PreparedStatement;
public class NclobCreateExample {
public static void main(String[] args) {
String url = "jdbc:mysql://localhost:3306/testdb";
String user = "root";
String password = "password";
String sql = "INSERT INTO test_table (id, ntext_col) VALUES (?, ?)";
try (Connection conn = DriverManager.getConnection(url, user, password);
PreparedStatement pstmt = conn.prepareStatement(sql)) {
String largeText = "这是通过 createNClob 创建的文本...";
// 创建 NClob 对象
NClob nclob = conn.createNClob();
nclob.setString(1, largeText); // 注意:setString 偏移量从 1 开始
pstmt.setInt(1, 2);
pstmt.setNClob(2, nclob);
pstmt.executeUpdate();
} catch (Exception e) {
e.printStackTrace();
}
}
}
当 NClob 内容为空时会发生什么
当尝试设置空的 NClob 内容时,如果使用 setNCharacterStream,传入长度为 0 的空流是合法的,数据库会存储一个空的 NLOB。如果使用 setNClob,创建一个空的 NClob 对象并设置也是有效的。在读取时,如果列值为 SQL NULL,getNCharacterStream 将返回 null;如果列值为空 NLOB,则返回一个空的流,读取操作不会抛出异常,但也不会产生任何字符输出。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










