实践Mybatis-Plus主键ID生成策略

50 阅读 0 评论 33 点赞

我是靠谱客的博主感性小甜瓜，最近开发中收集的这篇文章主要介绍实践Mybatis-Plus主键ID生成策略，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

在3.4.3以后的版本中，Mybatis-Plus默认的主键生成策略共有5种，对应枚举：IdType，分别为：
IdType.AUTO(0) 数据库ID自增，该类型请确保数据库设置了 ID自增否则无效
IdType.NONE(1) 这个是默认的类型，该类型为未设置主键类型(注解里等于跟随全局，全局里约等于 INPUT)
IdType.INPUT(2) 用户输入ID，该类型可以通过自己注册自动填充插件进行填充
IdType.ASSIGN_ID(3) 分配ID (主键类型为number或string），默认实现类 (雪花算法)
IdType.ASSIGN_UUID(4) 分配UUID (主键类型为 string)，默认实现类(UUID.replace(“-”,“”))

在3.3.0以前的版本的策略是：AUTO，NONE，INPUT，ID_WORKER，UUID，IDWORKER_STR这几种；
但是ID_WORKER，ID_WORKER_STR，UUID在3.3.0之后就提示废弃，3.4.3版本就完全移除了；
ID_WORKER和IDWORKER_STR建议使用为ASSIGN_ID，UUID建议使用为ASSIGN_UUID

1.自增主键

（1）新建一个表，在这个表中已经设置了自增id bigint NOT NULL AUTO_INCREMENT

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for t_case10_user
-- ----------------------------
DROP TABLE IF EXISTS `t_case10_user`;
CREATE TABLE `t_case10_user`  (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '名字',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci ROW_FORMAT = Dynamic;

SET FOREIGN_KEY_CHECKS = 1;

（2）创建对应实体类，注解TableId中，type = IdType.AUTO

/**
 * (t_case10_user)表实体类
 * @since 2022-08-22 11:26:58
 */
@Data
@TableName("t_case10_user")
public class TCase10User implements Serializable { {
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    @TableField("name")
    private String name;
}

（3）创建测试类，插入三条数据，一条不指定id，一条指定id为10L，另一条不指定id

/**
 * @program:
 * @description:
 * @create: 2022-08-22 11:31
 **/
@RunWith(SpringRunner.class)
@SpringBootTest(classes = Case10Application.class)
public class UserTest {
    @Resource
    private TCase10UserService userService;
    /**
     * 测试mybatis自增插入
     */
    @Test
    public void testMybatisIdAUTO(){
        userService.save(new TCase10User("自增user1"));
        userService.save(new TCase10User("自增user2"));
        userService.save(new TCase10User(10L,"自增user3"));
        userService.save(new TCase10User("自增user4"));
        userService.save(new TCase10User("自增user5"));
    }
}

场景一：字段设置AUTO(0) 数据库设置自增
执行之后的结果如下图所示，可以看出，如果没有指定id，id会从1开始递增（这个可以改），如果指定了，会使用指定的id进行插入，然后后续的会根据上一个插入的id进行递
在这里插入图片描述
场景二：字段设置AUTO(0) 数据库不设置自增
执行之后的结果如下图所示，抛出异常，无法插入数据

2.未指定，或者设置IdType.NONE(1)

这俩个是一样的，因为默认就是IdType.NONE(1)在源码中可以看到

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE})
public @interface TableId {
    /**
     * 字段名（该值可无）
     */
    String value() default "";
    /**
     * 主键类型
     * {@link IdType}
     */
    IdType type() default IdType.NONE;
}

修改注解type为IdType.NONE，或者把type这块给删了也行，现在表中的自增还在

@TableId(value = "id", type = IdType.NONE)
private Long id;

执行一下TRUNCATE table t_case10_user，删除表数据，这个语句可以重置id开始的数字为1
测试方法为：

/**
 * 测试mybatis默认
 */
@Test
public void testMybatisIdNONE(){
    userService.save(new TCase10User("自增user1"));
    userService.save(new TCase10User("自增user2"));
    userService.save(new TCase10User(10L,"自增user3"));
    userService.save(new TCase10User("自增user4"));
    userService.save(new TCase10User("自增user5"));
}

场景一：字段设置NONE(1) 数据库设置自增，与设置AUTO(0)结果一致，自增生效
在这里插入图片描述

场景二：字段设置NONE(1) 数据库不设置自增，与设置AUTO(0)结果一致
执行之后的结果如下图所示，抛出异常，无法插入数据
在这里插入图片描述

3.设置IdType.INPUT(2)

这个测试方法和IdType.NONE(1)完全一样，再两个场景下，结果也一样，不再赘述

4.设置IdType.ASSIGN_ID(3)

@TableId(value = "id", type = IdType.ASSIGN_ID)
private Long id;

执行一下TRUNCATE table t_case10_user，删除表数据，这个语句可以重置id开始的数字为1
测试方法为：

/**
 * 测试mybatis分配id
 */
@Test
public void testMybatisIdASSIGN_ID(){
    userService.save(new TCase10User("自增user1"));
    userService.save(new TCase10User("自增user2"));
    userService.save(new TCase10User(10L,"自增user3"));
    userService.save(new TCase10User("自增user4"));
    userService.save(new TCase10User("自增user5"));
}

场景一：字段设置ASSIGN_ID(3) 数据库设置自增
执行结果如下图：如果id已指定，插入指定值，如果没有指定，使用雪花算法进行填充
在这里插入图片描述
场景二：字段设置ASSIGN_ID(3) 数据库不设置自增
执行结果如下图，说明字段设置ASSIGN_ID(3)之后，设置不设置自增没有影响，都是id已指定，插入指定值，如果没有指定，使用雪花算法进行填充

场景三：字段设置ASSIGN_ID(3) 数据库设置自增，将时间进行回拨，看看是否有时钟回拨问题
测试方法：

/**
 * 测试mybatis分配id
 */
@Test
public void testMybatisIdASSIGN_ID_Time(){
    userService.save(new TCase10User("时钟回拨user1"));
    userService.save(new TCase10User("时钟回拨user2"));
}

执行结果如下图，比较一下id可以发现，最新插入的时钟回拨数据id比较小，说明时钟回拨的问题是存在的，需要自行处理这个问题
在这里插入图片描述

4.设置IdType.ASSIGN_UUID(4)

需要修改表结构，将字段id设置为varchar(32)

@TableId(value = "id", type = IdType.ASSIGN_UUID)
private String id;

测试方法为：

/**
 * 测试mybatis uuid
 */
@Test
public void testMybatisIdASSIGN_UUID(){
    userService.save(new TCase10User("自增user1"));
    userService.save(new TCase10User("自增user2"));
    userService.save(new TCase10User("user","自增user3"));
    userService.save(new TCase10User("自增user4"));
    userService.save(new TCase10User("自增user5"));
}