Java 中怎么用 PreparedStatement 处理 UUID 主键插入

陌伟酱_3589

陌伟酱_3589

2026-09-20

847人浏览

原创

java中用preparedstatement插入uuid主键,核心是将java.util.uuid正确映射为char(36)或binary(16)等数据库兼容类型,推荐setstring(1, uuid.tostring())通用写法,确保字段长度≥36且类型匹配。

java 中怎么用 preparedstatement 处理 uuid 主键插入

Java 中用 PreparedStatement 插入 UUID 主键,核心是把 java.util.UUID 正确映射为数据库能接收的类型(通常是 CHAR(36)BINARY(16)),并避免字符串拼接带来的 SQL 注入和格式问题。

确认数据库字段类型与 UUID 存储方式

不同数据库对 UUID 的支持策略不同,直接影响 Java 端写法:

  • 推荐用 CHAR(36):存储标准格式如 "f47ac10b-58cc-4372-a567-0e02b2c3d479",可读性强,兼容性好,几乎所有数据库都支持;
  • 可用 BINARY(16):更节省空间(16 字节 vs 36 字符),但需手动将 UUID 的 high/low long 转为字节数组,且部分 JDBC 驱动(如 MySQL Connector/J 8.0+)才原生支持 setObject(uuid, Types.BINARY)
  • PostgreSQL 支持 UUID 类型:可直接用 setObject(1, uuid, Types.OTHER) 或驱动自动识别,字段定义为 UUID 即可;
  • SQL Server 用 UNIQUEIDENTIFIER:接受标准 UUID 字符串格式,setString() 即可。

使用 setString() 写入标准格式 UUID(最通用)

适用于 MySQL、Oracle、SQL Server、H2 等绝大多数场景,无需额外依赖或特殊驱动配置:

UUID id = UUID.randomUUID();
String sql = "INSERT INTO users (id, name, email) VALUES (?, ?, ?)";
try (PreparedStatement ps = connection.prepareStatement(sql)) {
    ps.setString(1, id.toString()); // ✅ 转成 "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    ps.setString(2, "Alice");
    ps.setString(3, "alice@example.com");
    ps.executeUpdate();
}

注意:UUID.toString() 生成的是带连字符的 36 字符小写字符串,确保数据库字段长度 ≥36 且不区分大小写(一般默认满足)。

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

使用 setObject() + Types.VARCHAR / Types.OTHER(按数据库适配)

语义更清晰,部分驱动会做类型推断优化:

  • MySQL / H2 / Oracle:字段为 VARCHAR(36) 时,可用 ps.setObject(1, id.toString(), Types.VARCHAR)
  • PostgreSQL:字段为 UUID 类型时,推荐 ps.setObject(1, id, Types.OTHER)(现代 pgjdbc 自动识别 java.util.UUID);
  • 避免直接 setObject(1, id):未指定 SQL 类型时,某些旧驱动可能报错或转成意外格式(如 toString 带空格)。

插入前生成 UUID,不依赖数据库生成

明确由 Java 控制主键生成,适合分布式或需要提前获知 ID 的场景(如关联插入、日志记录):

  • UUID.randomUUID() 生成;
  • 若需基于时间/机器信息的变体(如 UUIDv1),可用第三方库如 uuid-generator,但普通业务 randomUUID() 安全足够;
  • 不建议在 SQL 中用 UUID() 函数(如 MySQL)再通过 getGeneratedKeys() 获取——这会让主键生成脱离 Java 控制,增加调试复杂度。

只要数据库字段设计合理、JDBC 类型设置匹配,用 PreparedStatement 插入 UUID 主键就是几行代码的事,关键在“存什么格式”和“怎么传过去”两个选择上保持前后一致。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

8717

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

5922

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5332

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

964

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

808

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1136

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2309

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19651

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1055

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习