Mybatis-Plus主鍵生成策略的方法
前言
很多人在使用Mybatis-Plus的時(shí)候可能會(huì)疑惑，自己明明沒(méi)有配置主鍵的生成策略，但是執(zhí)行新增操作時(shí)卻自動(dòng)生成了主鍵，而且還特別長(zhǎng)。這是由于Mybatis-Plus默認(rèn)就會(huì)采用雪花算法填充主鍵字段。
今天就和大家詳解聊聊Mybatis-Plus中主鍵生成的相關(guān)策略。
一、官網(wǎng)
Mybatis-Plus主鍵策略：https://baomidou.com/pages/e131bd/
Mybatis-Plus自定義ID生成器：https://baomidou.com/pages/568eb2/
TIP??：
推薦學(xué)習(xí)框架的時(shí)候，多研究下官網(wǎng)，獲取第一手資料。
二、主鍵注解@TableId說(shuō)明
1、源碼
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE})
public @interface TableId {
String value() default "";
IdType type() default IdType.NONE;
}
2、作用
標(biāo)識(shí)主鍵字段
使用@TableId可以標(biāo)識(shí)實(shí)體對(duì)象中和數(shù)據(jù)庫(kù)表中主鍵對(duì)應(yīng)的字段。如果不添加@TableId注解，會(huì)默認(rèn)匹配id字段為主鍵。
變量名稱和主鍵字段名稱的匹配
如果表中的主鍵字段名稱和實(shí)體中的主鍵字段名稱不相同，這時(shí)候就要通過(guò)@TableId中的value屬性明確指出對(duì)應(yīng)的數(shù)據(jù)庫(kù)主鍵字段的名稱。
指定主鍵的生成方式
可以通過(guò)@TableId注解中的type屬性指定主鍵的生成策略，具體支持哪些策略可以在IdType枚舉中查看。
3、使用
@TableName(value ="user")
@Data
public class User implements Serializable {
/**
* 主鍵ID
*/
@TableId(value = "id",type = IdType.ASSIGN_ID)
private Long userId;
private String name;
private Integer age;
private String email;
三、主鍵生成策略-IdType枚舉說(shuō)明
通過(guò)查看IdType枚舉類的源碼，可以發(fā)現(xiàn)Mybatis-Plus中默認(rèn)支持5種主鍵生成方式。
1、源碼
public enum IdType {
AUTO(0),
NONE(1),
INPUT(2),
ASSIGN_ID(3),
ASSIGN_UUID(4);
private final int key;
private IdType(int key) {
this.key = key;
}
public int getKey() {
return this.key;
}
}
2、說(shuō)明
| 值 | 描述 |
|---|---|
| AUTO | 數(shù)據(jù)庫(kù) ID自增，這種情況下將表中主鍵設(shè)置為自增，否則，沒(méi)有設(shè)置主動(dòng)設(shè)置id值進(jìn)行插入時(shí)會(huì)報(bào)錯(cuò) |
| NONE | 無(wú)狀態(tài)，該類型為未設(shè)置主鍵類型（注解里等于跟隨全局，全局里默認(rèn) ASSIGN_ID），注意這里官網(wǎng)文檔有誤 |
| INPUT | insert 前自行 set 主鍵值，在采用IKeyGenerator類型的ID生成器時(shí)必須為INPUT |
| ASSIGN_ID | 分配 ID(主鍵類型為 Number(Long 和 Integer)或 String)(since 3.3.0),使用接口IdentifierGenerator的方法nextId(默認(rèn)實(shí)現(xiàn)類為DefaultIdentifierGenerator雪花算法) |
| ASSIGN_UUID | 分配 UUID,主鍵類型為 String(since 3.3.0),使用接口IdentifierGenerator的方法nextUUID(默認(rèn) default 方法) |
3、全局設(shè)置
IdType默認(rèn)的全局設(shè)置為IdType.ASSIGN_ID,即由mybatis-plus主動(dòng)分配主鍵，默認(rèn)情況下由默認(rèn)主鍵生成器實(shí)現(xiàn)類DefaultIdentifierGenerator采用雪花算法填充主鍵。
public DbConfig() {
this.idType = IdType.ASSIGN_ID;
this.tableUnderline = true;
this.capitalMode = false;
this.logicDeleteValue = "1";
this.logicNotDeleteValue = "0";
this.insertStrategy = FieldStrategy.NOT_NULL;
this.updateStrategy = FieldStrategy.NOT_NULL;
this.whereStrategy = FieldStrategy.NOT_NULL;
}
在spring boot中，可以通過(guò)如下配置更改全局配置。
mybatis-plus.global-config.db-config.id-type=assign_id
三、ID生成器介紹
Mybatis-Plus中的ID生成器主要分為2類，一類是IdentifierGenerator，另一類是IKeyGenerator。
1、IdentifierGenerator
源碼如下：
public interface IdentifierGenerator {
//根據(jù)id是否為null判斷是否需要主動(dòng)分配Id
default boolean assignId(Object idValue) {
return StringUtils.checkValNull(idValue);
}
//生成數(shù)值型Id
Number nextId(Object entity);
//生成字符型uuid
default String nextUUID(Object entity) {
return IdWorker.get32UUID();
}
}
說(shuō)明：
IdentifierGenerator生成器中主要提供了3個(gè)方法。
其使用場(chǎng)景是：不依賴數(shù)據(jù)庫(kù)生成ID，而是由mybatis-plus自己提供一套id生成算法。 對(duì)應(yīng)的主鍵生成方式為IdType.ASSIGN_ID、ASSIGN_UUID。
assignId是否需要分配idnextId獲取下一個(gè)數(shù)值型IdnextUUID獲取下一個(gè)uuid
典型的實(shí)現(xiàn)是默認(rèn)的id生成器DefaultIdentifierGenerator,基于雪花算法生成id。`
public class DefaultIdentifierGenerator implements IdentifierGenerator {
private final Sequence sequence;
public DefaultIdentifierGenerator() {
this.sequence = new Sequence((InetAddress)null);
}
public DefaultIdentifierGenerator(InetAddress inetAddress) {
this.sequence = new Sequence(inetAddress);
}
public DefaultIdentifierGenerator(long workerId, long dataCenterId) {
this.sequence = new Sequence(workerId, dataCenterId);
}
public DefaultIdentifierGenerator(Sequence sequence) {
this.sequence = sequence;
}
public Long nextId(Object entity) {
return this.sequence.nextId();
}
}
具體使用：
1、聲明由mybatis-plus分配主鍵值
@TableName(value ="user")
@Data
public class User implements Serializable {
/**
* 主鍵ID
*/
@TableId(value = "id",type = IdType.ASSIGN_ID)
private Long userId;
private String name;
private Integer age;
private String email;
2、指定idGenerator的實(shí)現(xiàn)類
如果是默認(rèn)的DefaultIdentifierGenerator，則不需要用戶重新指定。
@Configuration
public class IdAutoConfig {
@Value("${mybatis-plus.zookeeper.serverLists}")
private String zkServerLists;
@Bean
public IdentifierGenerator idGenerator() {
return new ImadcnIdentifierGenerator(zkServerLists);
}
}
2、IKeyGenerator
源碼如下：
public interface IKeyGenerator {
//執(zhí)行sql生成id
String executeSql(String incrementerName);
//獲取數(shù)據(jù)庫(kù)類型
DbType dbType();
}
說(shuō)明：IKeyGenerator 生成器主要是根據(jù)不同的數(shù)據(jù)庫(kù)類型，執(zhí)行sql語(yǔ)句生成對(duì)應(yīng)的主鍵。典型的數(shù)據(jù)庫(kù)如Oracle，Postgre，需要根據(jù)序列器生成表主鍵。
相關(guān)實(shí)現(xiàn)類：
OracleKeyGenerator中的實(shí)現(xiàn)：
可以發(fā)現(xiàn)，是通過(guò)執(zhí)行sql調(diào)用序列器生成的id。
public class OracleKeyGenerator implements IKeyGenerator {
public OracleKeyGenerator() {
}
public String executeSql(String incrementerName) {
return "SELECT " + incrementerName + ".NEXTVAL FROM DUAL";
}
public DbType dbType() {
return DbType.ORACLE;
}
}
具體使用:
1、在實(shí)體中通過(guò)@KeySequence指定序列器名稱，并通過(guò)@TableId指定主鍵生成策略為IdType.INPUT
@KeySequence(value = "SEQ_ORACLE_STRING_KEY", clazz = String.class)
public class YourEntity {
@TableId(value = "ID_STR", type = IdType.INPUT)
private String idStr;
}
2、spring boot配置列中配置keyGenerator具體實(shí)現(xiàn)類
@Bean
public IKeyGenerator keyGenerator() {
return new OracleKeyGenerator();
}
也可以通過(guò)配置項(xiàng)指定：
mybatis-plus.global-config.db-config.key-generators=com.baomidou.mybatisplus.extension.incrementer.OracleKeyGenerator
四、自定義主鍵生成器
自定義主鍵生成器也有2種方式。如果需要通過(guò)執(zhí)行sql語(yǔ)句來(lái)生成id的，可以通過(guò)實(shí)現(xiàn)IKeyGenerator接口來(lái)自定義。 如果不想依賴數(shù)據(jù)庫(kù)，完全自定義一套主鍵生成策略，那么可以通過(guò)實(shí)現(xiàn)IdentifierGenerator接口來(lái)擴(kuò)展。
下面演示如何通過(guò)實(shí)現(xiàn)IdentifierGenerator接口，自定義主鍵生成器。
1、自定義id生成器
@Component
public class CustomIdGenerator implements IdentifierGenerator {
@Override
public Long nextId(Object entity) {
//可以將當(dāng)前傳入的class全類名來(lái)作為bizKey,或者提取參數(shù)來(lái)生成bizKey進(jìn)行分布式Id調(diào)用生成.
String bizKey = entity.getClass().getName();
//根據(jù)bizKey調(diào)用分布式ID生成
long id = ....;
//返回生成的id值即可.
return id;
}
}
2、配置類中指定id生成器
@Bean
public IdentifierGenerator idGenerator() {
return new CustomIdGenerator();
}
3、實(shí)體類中指定主鍵分配策略IdType.ASSIGN_ID
@TableName(value ="user")
@Data
public class User implements Serializable {
/**
* 主鍵ID
*/
@TableId(value = "id",type = IdType.ASSIGN_ID)
private Long userId;
private String name;
private Integer age;
private String email;
總結(jié)
本文主要是介紹了Mybatis-Plus主鍵生成策略及其相關(guān)的擴(kuò)展方法。
1、詳細(xì)介紹了@TableId注解的屬性和作用，推薦項(xiàng)目中在實(shí)體的主鍵字段上明確添加@TableId注解，標(biāo)識(shí)id字段以及id生成策略IdType。
2、目前mybatis-plus中有5種Id生成策略IdType，搞清楚各種的用法和使用場(chǎng)景。
AUTO數(shù)據(jù)庫(kù) ID自增NONE未設(shè)置主鍵類型，也就是跟隨全局策略，全局策略默認(rèn)為ASSIGN_IDINPUTinsert 前自行 set 主鍵值ASSIGN_ID分配 IDASSIGN_UUID分配 UUID
3、Mybatis-Plus中的ID生成器主要分為2類，一類是IdentifierGenerator，另一類是IKeyGenerator，搞清楚他們的區(qū)別和各自的使用場(chǎng)景。
IdentifierGenerator 適用于不依賴數(shù)據(jù)庫(kù)，用戶自定義的主鍵生成場(chǎng)景。
IKeyGenerator 依賴數(shù)據(jù)庫(kù)，通過(guò)執(zhí)行sql語(yǔ)句生成主鍵的場(chǎng)景。
到此這篇關(guān)于Mybatis-Plus主鍵生成策略的方法的文章就介紹到這了,更多相關(guān)Mybatis-Plus主鍵生成策略內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
java 重定義數(shù)組的實(shí)現(xiàn)方法(與VB的ReDim相像)
java 重定義數(shù)組的實(shí)現(xiàn)方法(與VB的ReDim相像)，需要的朋友可以參考一下2013-04-04
學(xué)習(xí)Java的static與final關(guān)鍵字
本篇文章給大家詳細(xì)分析了Java的static與final關(guān)鍵字知識(shí)點(diǎn)以及相關(guān)代碼分享，有需要的讀者跟著學(xué)習(xí)下吧。2018-03-03
MybatisPlus的MetaObjectHandler與@TableLogic使用
這篇文章主要介紹了MybatisPlus的MetaObjectHandler與@TableLogic使用方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-04-04
Spring?4.0版本中更新了很多新功能，其中比較重要的一個(gè)就是對(duì)帶泛型的Bean進(jìn)行依賴注入的支持。本文將通過(guò)實(shí)例詳細(xì)講講Spring如何實(shí)現(xiàn)泛型注入，需要的可以參考一下2022-07-07
這篇文章主要介紹了java壓縮文件與刪除文件的示例代碼，代碼簡(jiǎn)單易懂，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-08-08
Mybatis-plus獲取雪花算法生成的ID并返回生成ID
本文主要介紹了Mybatis-plus獲取雪花算法生成的ID并返回生成ID,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2023-09-09
JavaSE在java.util類庫(kù)中提供了一個(gè)專門用于輸入操作的類Scanner類,可以使用該類創(chuàng)建一個(gè)對(duì)象,然后利用該對(duì)象的相關(guān)方法從鍵盤上讀取數(shù)據(jù),下面這篇文章主要給大家介紹了關(guān)于Java中Scanner類使用的相關(guān)資料,需要的朋友可以參考下2023-04-04
Java經(jīng)緯度小數(shù)與度分秒相互轉(zhuǎn)換工具類示例詳解
這篇文章主要介紹了Java經(jīng)緯度小數(shù)與度分秒相互轉(zhuǎn)換工具類，本文通過(guò)示例代碼給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-07-07
Java使用正則表達(dá)式去除小數(shù)點(diǎn)后面多余的0功能示例
這篇文章主要介紹了Java使用正則表達(dá)式去除小數(shù)點(diǎn)后面多余的0功能,結(jié)合具體實(shí)例形式分析了java字符串正則替換相關(guān)操作技巧,需要的朋友可以參考下2017-06-06
Spring如何消除代碼中的if-else/switch-case
這篇文章主要給大家介紹了關(guān)于Spring如何消除代碼中if-else/switch-case的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用Spring具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-04-04