MyBatis-Plus主键生成策略
MyBatis-Plus 主键生成策略中,最常用的是IdType.AUTO,表示主键的生成是由 数据库的自增功能 控制的,前提:数据库的主键列必须设置为 AUTO_INCREMENT。
MyBatis-Plus 提供了内置的主键生成策略,可以在不改动业务代码的前提下自动生成主键值,而无需依赖数据库的自增主键。以下是解决方法和配置方式:
(1) IdType.ASSIGN_ID(默认雪花算法)
使用 MyBatis-Plus 提供的雪花算法生成全局唯一主键。此策略适用于 Long 或 String 类型的主键。
@TableId(value = "pay_id", type = IdType.ASSIGN_ID)
private Long payId;
- 特点:生成的 ID 是分布式唯一的,性能高,适合大规模并发场景。无需表设置主键自增。
(2) IdType.ASSIGN_UUID
使用 UUID 作为主键,适用于 String 类型的主键。
@TableId(value = "pay_id", type = IdType.ASSIGN_UUID)
private String payId;
- 特点:生成 32 位 UUID 字符串,适合跨系统场景,但主键长度较长,性能略低于雪花算法。
(3) IdType.INPUT
手动输入主键值,由开发者提供。
@TableId(value = "pay_id", type = IdType.INPUT)
private Integer payId;
- 特点:开发者需要在插入数据前手动设置主键值。MyBatis-Plus 不会自动生成,未设置主键id是null,会插入失败。
(4) IdType.NONE
不使用 MyBatis-Plus 的主键生成策略,完全交给数据库处理(如果数据库的主键设置为自增,则行为类似于 IdType.AUTO)。
3. 示例代码
假设你的表 pay_order 没有设置自增主键,现在想使用 MyBatis-Plus 内置雪花算法自动生成主键。
实体类定义
@TableName("pay_order")
public class PayOrderPO {
@TableId(value = "pay_id", type = IdType.ASSIGN_ID) // 使用雪花算法
private Long payId;
private String orderNo;
// 省略其他字段
}
插入操作
PayOrderPO payOrderPO = new PayOrderPO();
payOrderPO.setOrderNo("ORDER123456");
payOrderMapper.insert(payOrderPO);
System.out.println(payOrderPO.getPayId());
在插入时,MyBatis-Plus 会自动生成 pay_id 值。
注意点:主键id必须是Long类型(对应数据库bigint)如果Id 的类型定义为 Integer,这可能导致雪花算法生成的 long 值被截断为 Integer 类型,从而出现负数。
浙公网安备 33010602011771号