小书MybatisPlus第6篇-主键生成策略精讲

本文为mybatis系列文档的第6篇，前5篇请访问下面的网址。

• 小书MybatisPlus第1篇-整合SpringBoot快速开始增删改查
• 小书MybatisPlus第2篇-条件构造器的应用及总结
• 小书MybatisPlus第3篇-自定义SQL
• 小书MybatisPlus第4篇-表格分页与下拉分页查询
• 小书MybatisPlus第5篇-Active Record模式精讲

Mybatis Plus 为我们提供了三种设置 主键生成策略的方式。它们的优先级顺序是：局部注解 > 全局 > 默认(雪花算法)。下面我们来一一介绍

一、默认主键生成策略：雪花算法

Mybatis Plus如果不做任何主键策略配置，默认使用的是雪花算法。该策略会根据雪花算法生成主键ID，主键类型为Long或String（具体到MySQL数据库就是BIGINT和VARCHAR），该策略使用接口IdentifierGenerator的方法nextId（默认实现类为DefaultIdentifierGenerator雪花算法）

snowflake算法是Twitter开源的分布式ID生成算法，结果是一个long类型的ID 。其核心思想：使用41bit作为毫秒数，10bit作为机器的ID（5bit数据中心，5bit的机器ID），12bit作为毫秒内的流水号（意味着每个节点在每个毫秒可以产生4096个ID），最后还有一个符号位，永远是0。

二、自定义主键策略

mybatis-plus3.3.0以后，主要有五种主键生成策略。

public enum IdType {
    /**
     * 数据库ID自增,数据库需要支持主键自增(如MySQL)，并设置主键自增
     */
    AUTO(0),

    /**
     * 该类型为未设置主键类型,默认使用雪花算法生成
     */
    NONE(1),

    /**
     * 用户输入ID,数据类型和数据库保持一致就行
     * <p>该类型可以通过自己注册自动填充插件进行填充</p>
     */
    INPUT(2),

    /* 以下3种类型、只有当插入对象ID 为空，才自动填充。 */
    /**
     * 全局唯一ID (idWorker),数值类型  数据库中也必须是数值类型 否则会报错
     */
    ID_WORKER(3),
    /**
     * 全局唯一ID (UUID，不含中划线)
     */
    UUID(4),
    /**
     * 字符串全局唯一ID (idWorker 的字符串表示)，数据库也要保证一样字符类型
     */
    ID_WORKER_STR(5);
}

三、局部注解配置策略

我们针对主键设置主键策略使用注解方式为

@TableId(type = IdType.AUTO)
private long userId;

四、全局配置策略

mybatis-plus:
  global-config:
    db-config:
      id-type: auto

五、扩展使用

5.1.INPUT用户输入ID策略的用法

其中需要和大家特殊介绍的是：Input（用户输入ID），这个ID来源可以有两种

• 用户自己设置ID，并在insert之前SET主键的值
• 一些有序列的数据库，比如Oracle，SQLServer等，针对这些数据库我们可以通过序列填充ID字段

Mybatis-Plus 内置了如下数据库主键序列（如果内置支持不满足你的需求，可实现 IKeyGenerator 接口来进行扩展）：

• DB2KeyGenerator
• H2KeyGenerator
• KingbaseKeyGenerator
• OracleKeyGenerator
• PostgreKeyGenerator

以Oracle 的Sequence使用方法为例，使用方法如下：
首先添加@Bean

 [@Bean](https://my.oschina.net/bean)
    public OracleKeyGenerator oracleKeyGenerator(){
        return new OracleKeyGenerator();
    }

然后实体类配置主键 Sequence，指定主键策略为 IdType.INPUT 即可,

[@Data](https://my.oschina.net/difrik)
@KeySequence(value = "SEQ_USER" , clazz = Long.class)
public class User {

    @TableId(value = "ID",type = IdType.INPUT)
    private Integer id;

欢迎关注我的博客，里面有很多精品合集

• 本文转载注明出处（必须带连接，不能只转文字）：字母哥博客。

觉得对您有帮助的话，帮我点赞、分享！您的支持是我不竭的创作动力！ 。另外，笔者最近一段时间输出了如下的精品内容，期待您的关注。

• 《手摸手教你学Spring Boot2.0》
• 《Spring Security-JWT-OAuth2一本通》
• 《实战前后端分离RBAC权限管理系统》
• 《实战SpringCloud微服务从青铜到王者》
• 《VUE深入浅出系列》