在 java 中使用 preparedstatement 设置 json 参数时,核心做法是将 json 字符串作为普通文本传入,调用 setstring() 方法即可。具体实现取决于数据库类型:对于 mysql 8.0+、postgresql 或 oracle 12c+ 等支持原生 json 类型的数据库,需确保表列类型为 json 或 clob,直接传参后由数据库内部处理;对于不支持原生 json 的旧版数据库(如 mysql 5.7),则必须将列定义为 text 或 varchar,此时 jdbc 驱动仅负责传输字符串,应用层需自行保证 json 格式合法性。若遇到中文乱码,通常是因为连接 url 未指定字符集(如 ?characterencoding=utf-8)。

MySQL 8.0+ 中如何存储和查询 JSON 字段
在 MySQL 8.0+ 环境中,PreparedStatement 可以直接操作 JSON 类型字段。开发者只需创建包含 JSON 列的表,并在 SQL 语句中使用占位符 ?,通过 setString() 传入合法的 JSON 字符串。数据库会自动验证 JSON 格式并存储为二进制格式以提高效率。查询时同样使用 getString() 获取原始 JSON 字符串,或使用 MySQL 特有的 JSON 函数进行提取。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
public class MysqlJsonExample {
public static void main(String[] args) {
String url = "jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC";
String user = "root";
String password = "password";
// 假设表结构: CREATE TABLE users (id INT PRIMARY KEY, profile JSON);
String sql = "INSERT INTO users (id, profile) VALUES (?, ?)";
try (Connection conn = DriverManager.getConnection(url, user, password);
PreparedStatement pstmt = conn.prepareStatement(sql)) {
pstmt.setInt(1, 1);
// 直接传入 JSON 字符串
String jsonStr = "{\"name\": \"Alice\", \"age\": 30}";
pstmt.setString(2, jsonStr);
pstmt.executeUpdate();
System.out.println("Insert successful.");
// 查询示例
String selectSql = "SELECT id, profile FROM users WHERE id = ?";
try (PreparedStatement pstmtSelect = conn.prepareStatement(selectSql);
ResultSet rs = pstmtSelect.executeQuery()) {
if (rs.next()) {
int id = rs.getInt("id");
String profile = rs.getString("profile");
System.out.println("ID: " + id + ", Profile: " + profile);
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
PostgreSQL 中如何处理 JSONB 数据
PostgreSQL 推荐使用 jsonb 类型以支持索引和高效查询。在 PreparedStatement 中,处理方式与 MySQL 类似,但需注意 PostgreSQL JDBC 驱动对 JSON 的支持细节。通常建议将 JSON 字符串作为 String 传入 setString(),或者利用 PGObject 类进行更复杂的对象映射。对于简单的 CRUD 操作,直接使用 setString() 是最通用且不易出错的方式。数据库会将字符串解析为内部的 JSONB 二进制格式。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
public class PostgresJsonExample {
public static void main(String[] args) {
String url = "jdbc:postgresql://localhost:5432/testdb";
String user = "postgres";
String password = "password";
// 假设表结构: CREATE TABLE users (id SERIAL PRIMARY KEY, data JSONB);
String sql = "INSERT INTO users (data) VALUES (?) RETURNING id";
try (Connection conn = DriverManager.getConnection(url, user, password);
PreparedStatement pstmt = conn.prepareStatement(sql)) {
String jsonData = "{\"key\": \"value\", \"nested\": {\"a\": 1}}";
pstmt.setString(1, jsonData);
try (ResultSet rs = pstmt.executeQuery()) {
if (rs.next()) {
int id = rs.getInt(1);
System.out.println("Inserted with ID: " + id);
}
}
// 查询示例
String selectSql = "SELECT data FROM users WHERE id = ?";
try (PreparedStatement pstmtSelect = conn.prepareStatement(selectSql)) {
pstmtSelect.setInt(1, 1);
try (ResultSet rs = pstmtSelect.executeQuery()) {
if (rs.next()) {
String data = rs.getString("data");
System.out.println("Retrieved Data: " + data);
}
}
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
当 JSON 字符串中包含特殊字符或空值时会发生什么
当传入的 JSON 字符串包含特殊字符(如单引号、双引号、换行符)或为空时,PreparedStatement 的安全性机制会正确处理这些内容,防止 SQL 注入。然而,如果 JSON 字符串本身格式不合法(例如缺少闭合括号),数据库会在执行时抛出异常。对于空值,应使用 setNull() 方法而非传入空字符串,以确保数据库列能正确存储 NULL 值而不是空字符串。此外,如果 JSON 字符串过长,超过数据库字段的最大长度限制(如 VARCHAR 的长度限制),也会导致插入失败。

















