mybatis-plus--使用雪花算法生成主键id--使用/分析(代码片段)

IT利刃出鞘 IT利刃出鞘     2023-03-03     364

关键词:

原文网址:MyBatis-Plus--使用雪花算法生成主键ID--使用/分析_IT利刃出鞘的博客-CSDN博客

简介

说明

        本文介绍MyBatis-Plus如何使用其自带的雪花算法生成主键ID。

MyBatis-Plus自带的雪花算法

  • MyBatis-Plus自带雪花算法
  • MyBatis-Plus默认使用雪花算法生成ID。
    • 即:@TableId的type属性默认是ASSIGN_ID
  • 若没有配置机器号,则默认生成机器号(通过物理网卡地址和jvm的进程ID生成机器号)。
    • 雪花算法是需要指定不同的机器号的,如果机器号相同,则可能会生成相同的ID。

MyBatis-Plus的雪花算法示例

建库建表

DROP DATABASE IF EXISTS mp;
CREATE DATABASE mp DEFAULT CHARACTER SET utf8;
USE mp;

DROP TABLE IF EXISTS `t_user`;
SET NAMES utf8mb4;

CREATE TABLE `t_user`
(
    `id`           BIGINT(0) NOT NULL,
    `user_name`    VARCHAR(64) NOT NULL COMMENT '用户名(不能重复)',
    `nick_name`    VARCHAR(64) NULL COMMENT '昵称(可以重复)',
    `email`        VARCHAR(64) COMMENT '邮箱',
    `create_time`  DATETIME(0) NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `update_time`  DATETIME(0) NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改时间',
    `deleted_flag` BIGINT(0) NOT NULL DEFAULT 0 COMMENT '0:未删除 其他:已删除',
    PRIMARY KEY (`id`) USING BTREE,
    UNIQUE KEY `index_user_name_deleted_flag` (`user_name`, `deleted_flag`),
    KEY `index_create_time`(`create_time`)
) ENGINE = InnoDB COMMENT = '用户';

依赖

引入MyBatis-Plus依赖。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.1</version>
</dependency>

整个pom.xml为:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.12.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>MyBatis-Plus_Single</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>MyBatis-Plus_Single</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.1</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>3.0.3</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

配置

application.yml

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/mp?characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: 222333

#mybatis-plus配置控制台打印完整带参数SQL语句
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

MyBatis-Plus配置类

启动类上加注解:

@MapperScan("com.example.demo.**.mapper")

代码

Entity

package com.example.demo.user.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

import java.time.LocalDateTime;

@Data
@TableName(value = "t_user")
public class User 
    @TableId(value = "id")
    // 等价于:
    // @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    /**
     * 用户名(不能重复)
     */
    private String userName;

    /**
     * 昵称(可以重复)
     */
    private String nickName;

    /**
     * 邮箱
     */
    private String email;

    /**
     * 创建时间
     */
    private LocalDateTime createTime;

    /**
     * 修改时间
     */
    private LocalDateTime updateTime;

    /**
     * 0:未删除 其他:已删除
     */
    @TableLogic(delval = "id")
    private Long deletedFlag;

Mapper

package com.example.demo.user.mapper;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.demo.user.entity.User;
import org.springframework.stereotype.Repository;

@Repository
public interface UserMapper extends BaseMapper<User> 

Service

接口

package com.example.demo.user.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.demo.user.entity.User;

public interface UserService extends IService<User> 

实现

package com.example.demo.user.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.demo.user.entity.User;
import com.example.demo.user.mapper.UserMapper;
import com.example.demo.user.service.UserService;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService 

Controller

package com.example.demo.user.controller;

import com.example.demo.user.entity.User;
import com.example.demo.user.service.UserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.ArrayList;
import java.util.List;

@Api(tags = "增删改查")
@RestController
@RequestMapping("/crud")
public class CRUDController 
    @Autowired
    private UserService userService;

    // 其他代码

    @ApiOperation("批量添加")
    @PostMapping("/addBatch")
    public List<User> addBatch() 
        List<User> users = new ArrayList<>();
        for (long i = 0; i < 10; i++) 
            User user = new User();
            user.setUserName("Iron Man" + i);

            users.add(user);
        
        userService.saveBatch(users);
        return users;
    

测试

访问:http://localhost:8080/doc.html

结果

访问如下位置:

可以发现,生成的ID是19位的数,而且是增加的。这就是雪花算法的生成的ID的现象。

原理分析

MyBatis-Plus默认用雪花算法

ID的类型默认是ASSIGN_ID

MyBatis-Plus的ID生成算法的配置方式如下:

application.yml:

mybatis-plus:
  global-config:
    db-config:
      #id类型。
      id-type: ASSIGN_ID # 默认为ASSIGN_ID

id-type默认是: ASSIGN_ID,代码如下:

ASSIGN_ID使用雪花算法实现

        MyBatis的MybatisParameterHandler#populateKeys方法里对ID进行填充,里边调用到IdentifierGenerator#nextId获取ID:

        IdentifierGenerator是一个接口,其默认实现类是:DefaultIdentifierGenerator,其调用Sequence的nextId()获取ID:

点进去看看这个Sequence:

 可以发现,这就是雪花算法!

不配置机器号时的处理逻辑

结论

        MyBatis-Plus生成机器序号的方法是:前5位作为dataCenterId(通过MAC地址生成),后5位作为workerId(通过MAC地址结合JVM的PID生成)。

分析

        DefaultIdentifierGenerator有个构造函数,若没有配置workerId和dataCenterId,则会调用无参构造方法。

上边会调用到Sequence的构造方法:Sequence#Sequence(java.net.InetAddress),如下图所示

追踪dataCenterId和workerId的方法:

package com.baomidou.mybatisplus.core.toolkit;

import org.apache.ibatis.logging.Log;
import org.apache.ibatis.logging.LogFactory;

import java.lang.management.ManagementFactory;
import java.net.InetAddress;
import java.net.NetworkInterface;
import java.util.concurrent.ThreadLocalRandom;

/**
 * 分布式高效有序 ID 生产黑科技(sequence)
 *
 * <p>优化开源项目:https://gitee.com/yu120/sequence</p>
 *
 * @author hubin
 * @since 2016-08-18
 */
public class Sequence 
 
    // 其他代码
    
    /**
     * 获取 maxWorkerId
     */
    protected long getMaxWorkerId(long datacenterId, long maxWorkerId) 
        StringBuilder mpid = new StringBuilder();
        mpid.append(datacenterId);
        String name = ManagementFactory.getRuntimeMXBean().getName();
        if (StringUtils.isNotBlank(name)) 
            /*
             * GET jvmPid
             */
            mpid.append(name.split(StringPool.AT)[0]);
        
        /*
         * MAC + PID 的 hashcode 获取16个低位
         */
        return (mpid.toString().hashCode() & 0xffff) % (maxWorkerId + 1);
    

    /**
     * 数据标识id部分
     */
    protected long getDatacenterId(long maxDatacenterId) 
        long id = 0L;
        try 
            if (null == this.inetAddress) 
                this.inetAddress = InetAddress.getLocalHost();
            
            NetworkInterface network = NetworkInterface.getByInetAddress(this.inetAddress);
            if (null == network) 
                id = 1L;
             else 
                byte[] mac = network.getHardwareAddress();
                if (null != mac) 
                    id = ((0x000000FF & (long) mac[mac.length - 2]) | (0x0000FF00 & (((long) mac[mac.length - 1]) << 8))) >> 6;
                    id = id % (maxDatacenterId + 1);
                
            
         catch (Exception e) 
            logger.warn(" getDatacenterId: " + e.getMessage());
        
        return id;
    

MyBatis-Plus的雪花算法工具类

说明

        MyBatis-Plus也提供了一个雪花算法工具类,想用的可以使用:com.baomidou.mybatisplus.core.toolkit.IdWorker。

用法

public static void main(String[] args) 
    // 返回值  1385106677482582018
    System.out.println(IdWorker.getId());
    // 返回值 "1385106677482582019"
    System.out.println(IdWorker.getIdStr());

注意

        这只是个工具类,与MyBatis-Plus和它的ID默认的雪花算法无关

        在github中有一个很流行的分布式统一ID生成框架也叫idworker,需要和mybatis-plus中自带的Idworker工具类区分开来。它是一个基于zookeeper和snowflake算法的分布式统一ID生成工具,通过zookeeper自动注册机器(最多1024台),无需手动指定workerId和dataCenterId。idworker官网:https://github.com/imadcn/idworker

关于mybatis-plus雪花算法生成id精度丢失问题的处理(代码片段)

MyBatis-Plus3.3.0开始,默认使用雪花算法首先插入一条数据生成的id长这样1400693801379520513但是我们传给前端的时候却是这样1400693801379520500上网查了一下Number精度是16位(雪花ID是19位的)So:前端的Number数据类型导致... 查看详情

oracleid生成算法——雪花算法(代码片段)

...过长,单纯的就无序这一点,数据库中就不建议使用࿰ 查看详情

oracleid生成算法——雪花算法(代码片段)

...过长,单纯的就无序这一点,数据库中就不建议使用࿰ 查看详情

mybatis-plus使用oracle函数生成主键

函数的调用方式为:selectpkg1.fun1fromdual;mybatis-plus一般会使用的主键生成策略为:@BeanpublicOracleKeyGeneratororacleKeyGenerator(){returnnewOracleKeyGenerator();}此处由于要使用自定义主键生成策略,所以就不需要以上Bean了。自定义主键生成策略... 查看详情

mybatisplus之主键生成策略

...布式ID生成算法,结果是一个long型的ID。其核心思想是:使用41bit作为毫秒数,10bit作为机器的ID(5个bit是数据中心,5个bit的机器ID),12bit作为毫秒内的流水号(意味着每个节点在每毫秒可以产生4096个 查看详情

雪花算法(snowflake)

...的全局唯一性。对于MySQL而言,一个表中的主键id一般使用自增的方式,但是如果进行水平分表之后,多个表中会生成重复的id值。那么如何保证水平分表后的多张表中的id是全局唯一性的呢?如果还是借助数据库... 查看详情

mybatis-plus插入测试以及雪花算法(代码片段)

Mybatis-Plus插入测试以及雪花算法1、导入依赖<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dep 查看详情

小白知识:数据库表主键id生成策略及snowflake雪花算法的由来(代码片段)

早期单机早期单机系统习惯的主键有两种方式:整数的自增主键和字符串主键整数自增主键,数据库自己维护,每次+1,优点快速简单,具有顺序,方便排序,缺点高并发时会有主键冲突问题。... 查看详情

springboot分布式全局唯一id的生成-雪花算法snowflake

一背景描述1.1问题产生在分布式系统中,怎么使用全局唯一id?在分布式是,微服务的架构中,或者大数据分库分表中,多个不同节点怎么保持每台机器生成的主键id不重复,具有唯一性?方案1:mys... 查看详情

mybatis-plus雪花id的使用以及参数配置详解

1.引入Mybatis-Plus依赖(3.1.1版本目前有些问题,建议使用3.1.0版本)<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.1.0</version> </dependency>  2.在application.yml配置... 查看详情

springboot分布式全局唯一id的生成-雪花算法snowflake

一背景描述1.1问题产生在分布式系统中,怎么使用全局唯一id?在分布式是,微服务的架构中,或者大数据分库分表中,多个不同节点怎么保持每台机器生成的主键id不重复,具有唯一性?方案1:mys... 查看详情

mybatis-plus主键生成策略详解(代码片段)

1.1简述Mybatis-plus提供了多种主键生成策略,可以在Pojo类中主键上加注解进行配置,例如数据库主键自增@TableId(type=IdType.AUTO)1.2五种策略1.2.1AUTO(自动增长策略)AUTO自动增长策略,这个配合数据库使用,Mysql可以... 查看详情

springboot中使用雪花算法生成雪花id(代码片段)

...、什么是雪花算法2、雪花算法的优缺点3、springboot项目中使用雪花算法使用1、什么是雪花算法雪花算法(Snowflake)是一种生成全局唯一ID的算法,由Twitter公司开发。它可以在分布式系统中生成全局唯一的ID,解决... 查看详情

雪花算法解析生成uuid

...0000000000000000000000000000000000-00000-00000-000000000000*第一位为未使用,接下来的41位为毫秒级时间(41位的长度可以使用69年),然后是5 查看详情

mybatis-plus总结笔记(代码片段)

...ql-connector-java</artifactId></dependency>注意:引入MyBatis-Plus之后请不要再次引入MyBatis,以避免因版本差异导致的问题。在对应的Mapper上面继承接口BaseMapper,这样我们就可以使用父类中的方法,大大简化我们的... 查看详情

分布式全局唯一id解决方案(雪花算法)(代码片段)

...分布式ID吗Redis集群实现分布式ID的利弊雪花算法(SonwFlake)使用糊涂工具包实现雪花算法优缺点:为什么需要分布式全局唯一ID以及分布式ID的业务需求在复杂分布式系统中,往往需要对大量的数据和消息进行唯一标识如在... 查看详情

分布式全局唯一id解决方案(雪花算法)(代码片段)

...分布式ID吗Redis集群实现分布式ID的利弊雪花算法(SonwFlake)使用糊涂工具包实现雪花算法优缺点:为什么需要分布式全局唯一ID以及分布式ID的业务需求在复杂分布式系统中,往往需要对大量的数据和消息进行唯一标识如在... 查看详情

雪花算法生成的id,前端无法使用(代码片段)

由于前端Number类型长度不够,所以雪花算法生成的ID,传递给前端就会精度丢失。解决方案:@ConfigurationpublicclassJacksonConfig@Bean@Primary@ConditionalOnMissingBean(ObjectMapper.class)publicObjectMapperja 查看详情