Mybatis-Plus字段策略FieldStrategy的使用
前言
最近都是Mybatis-Plus系列的小白文,算是对工作中最常使用的框架的细节扫盲。
有在学习Mybatis-Plus使用的,可以关注一波。
今天主要是对Mybatis-Plus字段策略FieldStrategy进行介绍。
一、官方文档
Mybatis-Plus中FieldStrategy说明:https://baomidou.com/pages/223848/
Tip⚠️:
官网链接,自力更生。
二、字段策略介绍
1、FieldStrategy作用
Mybatis-Plus字段策略FieldStrategy的作用主要是在进行新增、更新时,根据配置的策略判断是否对实体对象的值进行空值判断,如果策略为字段不能为空,则不会对为空的字段进行赋值或更新。
同样,在进行where条件查询时,根据whereStrategy策略判断是否对字段进行空值判断,如果策略为字段不能为空,则为空的字段不会作为查询条件组装到where条件中。
三个配置,对应三种使用场景
insertStrategy
在insert操作时的字段策略,是否进行空值判断,插入空值updateStrategy
在update操作时的字段策略,是否进行空值判断,插入空值whereStrategy
在where条件组装时,是否进行控制判断,将空值作为查询条件
2、FieldStrategy类型
FieldStrategy的源码中,一共有5种策略类型。
public enum FieldStrategy { IGNORED, NOT_NULL, NOT_EMPTY, DEFAULT, NEVER; private FieldStrategy() { } }
每种策略的作用:
值 | 描述 |
---|---|
IGNORED | 忽略空值判断,实体对象的字段是什么值就用什么值更新,支持null值更新操作 |
NOT_NULL | 进行非NULL判断,也是默认策略,相当于age!=null |
NOT_EMPTY | 进行非空判断,主要是针对字符串类型,相当于name != null and name != ‘’ |
NEVER | 从不更新,不管字段是否有值,都不进行更新 |
DEFAULT | 追随全局配置 |
3、FieldStrategy配置
全局策略配置
在全局配置中,三者的默认值都是FieldStrategy.NOT_NULL
,即进行空值判断,不对NULL值数据进行处理。
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中可以通过配置属性修改全局字段策略:
mybatis-plus.global-config.db-config.update-strategy=not_null mybatis-plus.global-config.db-config.insert-strategy=not_null mybatis-plus.global-config.db-config.where-strategy=not_null
单字段策略配置
在实体对象中,通过@TableField
注解可以针对单个字段指定字段策略。
示例:
@TableName(value ="user") @Data public class User implements Serializable { @TableId private Long id; private String name; private Integer age; //配置字段更新策略:不能为空 @TableField(updateStrategy = FieldStrategy.NOT_EMPTY) private String email; }
@TableField注解的源码:
@Documented @Retention(RetentionPolicy.RUNTIME) @Target({ElementType.FIELD, ElementType.ANNOTATION_TYPE}) public @interface TableField { String value() default ""; boolean exist() default true; String condition() default ""; String update() default ""; //插入策略 FieldStrategy insertStrategy() default FieldStrategy.DEFAULT; //更新策略 FieldStrategy updateStrategy() default FieldStrategy.DEFAULT; //where条件策略 FieldStrategy whereStrategy() default FieldStrategy.DEFAULT; FieldFill fill() default FieldFill.DEFAULT; boolean select() default true; boolean keepGlobalFormat() default false; String property() default ""; JdbcType jdbcType() default JdbcType.UNDEFINED; Class<? extends TypeHandler> typeHandler() default UnknownTypeHandler.class; boolean javaType() default false; String numericScale() default ""; }
其中,insertStrategy、updateStrategy和whereStrategy的默认策略都是FieldStrategy.DEFAULT
,表示跟随全局配置。
三、实战说明
以更新操作updateById
为例,演示各种策略的作用。
1.默认策略 - NOT_NULL
默认策略为FieldStrategy.NOT_NULL
,表示需要进行非NULL判断,只有不为NULL的字段才会参与数据处理。
相当于mybatis的xml文件中的if判定条件判断:age!=null
<if test="age != null"> AND t.age = #{age} </if>
代码如下(示例):
@TableName(value ="user") @Data public class User implements Serializable { @TableId private Long id; private String name; private Integer age; //NOT_NULL为默认的全局策略 //@TableField(updateStrategy = FieldStrategy.NOT_NULL) private String email; }
单元测试:
@Test public void testUpdateById() { System.out.println("----- updateById method test ------"); User user = new User(); user.setId(1543920054188400641L); user.setName("test"); user.setAge(13); //email字段为null //user.setEmail(""); userMapper.updateById(user); System.out.println(user.toString()); }
执行结果:
为null的字段email没有参与更新操作。
updateStrategy的默认策略是FieldStrategy.DEFAULT
,表示跟随全局配置。而全局的默认策略是FieldStrategy.NOT_NULL
,即进行NULL值判断,如果为NULL,则不更新对应的字段。
2.忽略判断-IGNORED
@TableName(value ="user") @Data public class User implements Serializable { @TableId private Long id; private String name; private Integer age; @TableField(updateStrategy = FieldStrategy.IGNORED) private String email; }
再次执行上面的单元测试:
可以看到,尽管email字段的值为null,但还是进行了更新操作。
说明策略FieldStrategy.IGNORED
会忽略字段值的空值判断,无论实体对象的字段值是否为空,都会进行更新操作。
3.从不处理-NEVER
@TableName(value ="user") @Data public class User implements Serializable { @TableId private Long id; private String name; private Integer age; @TableField(updateStrategy = FieldStrategy.NEVER) private String email; }
指定email字段不为空,进行单元测试:
@Test public void testUpdateById() { System.out.println("----- updateById method test ------"); User user = new User(); user.setId(1543920054188400641L); user.setName("test"); user.setAge(13); //email字段不为空 user.setEmail("101@qq.com"); userMapper.updateById(user); System.out.println(user.toString()); }
执行结果:
尽管email字段有值,但还是没有进行了更新操作。
说明策略FieldStrategy.NEVER
不但会忽略字段值的空值判断,而且不管标识的字段是否有值,都不会进行更新操作。
4.字符不为空-NOT_EMPTY
策略FieldStrategy.NOT_EMPTY
表示需要对字符串进行空值判断,只有非空字符串的字段才会参与数据处理。
相当于mybatis的xml文件中的if判定条件判断:name != null and name != ''
<if test="name != null and name != '' "> AND t.name like CONCAT('%',#{name},'%') </if>
@TableName(value ="user") @Data public class User implements Serializable { @TableId private Long id; private String name; private Integer age; @TableField(updateStrategy = FieldStrategy.NOT_EMPTY) private String email; }
指定email字段不为空,进行单元测试:
@Test public void testUpdateById() { System.out.println("----- updateById method test ------"); User user = new User(); user.setId(1543920054188400641L); user.setName("test"); user.setAge(13); //email字段不为空 user.setEmail("101@qq.com"); userMapper.updateById(user); System.out.println(user.toString()); }
执行结果:
email字段有值的时候,正常更新。
指定email字段为空字符串,进行单元测试:
@Test public void testUpdateById() { System.out.println("----- updateById method test ------"); User user = new User(); user.setId(1543920054188400641L); user.setName("test"); user.setAge(13); //email字段为空字符串 user.setEmail(""); userMapper.updateById(user); System.out.println(user.toString()); }
执行结果:
email字段为空字符串时,不会参与更新操作。
5.跟随全局-DEFAULT
策略FieldStrategy.DEFAULT
表示追随全局配置的字段策略,这也是字段级别的默认策略。而全局的字段策略,默认是FieldStrategy.NOT_NULL
。
这里就不做继续演示。
总结
本文主要是详细介绍了Mybatis-Plus字段策略FieldStrategy的作用和使用方法。
1、字段策略的3个使用场景:
insertStrategy
insert操作时的字段策略,是否进行空值判断,插入空值updateStrategy
update操作时的字段策略,是否进行空值判断,插入空值whereStrategy
where条件组装时的字段策略,是否进行控制判断,将空值作为查询条件
2、字段策略的5种类型:
IGNORED
忽略空值判断,实体对象的字段是什么值就用什么值更新,支持null值更新操作NOT_NULL
进行非NULL判断,相当于age!=null
,也是默认的策略NOT_EMPTY
进行非空判断,主要是针对字符串类型的字段,相当于name != null and name != ''
NEVER
从不更新,不管字段是否有值,都不进行更新DEFAULT
追随全局配置
到此这篇关于Mybatis-Plus字段策略FieldStrategy的使用的文章就介绍到这了,更多相关Mybatis-Plus字段策略FieldStrategy内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
原文出处:https://blog.csdn.net/w1014074794/article/details/125644080
相关文章
- 这篇文章主要介绍了mybatis-plus 表名添加前缀的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-08-26
- 这篇文章主要介绍了mybatis-plus 返回部分字段的解决方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-10-02
- 这篇文章主要介绍了MyBatis-Plus自动填充功能失效导致的原因及解决,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-02-04
- 这篇文章主要介绍了mybatis-plus 处理大数据插入太慢的解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-12-18
- 这篇文章主要介绍了解决mybatis-plus 查询耗时慢的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-07-04
使用mybatis-plus报错Invalid bound statement (not found)错误
这篇文章主要介绍了使用mybatis-plus报错Invalid bound statement (not found)错误,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-02- 这篇文章主要介绍了mybatis-plus实体类主键策略有3种(小结),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-08-27
- 这篇文章主要介绍了mybatis-plus getOne和逻辑删除,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-08-26
mybatis-plus mapper中foreach循环操作代码详解(新增或修改)
这篇文章主要介绍了mybatis-plus mapper中foreach循环操作代码详解(新增或修改),本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-11-17- 这篇文章主要介绍了Mybatis和Mybatis-Plus时间范围查询方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-06
- 这篇文章主要介绍了Mybatis-Plus根据时间段去查询数据的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-18
Mybatis-plus使用TableNameHandler分表详解(附完整示例源码)
这篇文章主要介绍了Mybatis-plus使用TableNameHandler分表详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-01-26Mybatis-plus实现主键自增和自动注入时间的示例代码
这篇文章主要介绍了Mybatis-plus实现主键自增和自动注入时间的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-07-20- 这篇文章主要介绍了mybatis-plus读取JSON类型的方法实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-25
解决Mybatis-plus找不到对应表及默认表名命名规则的问题
这篇文章主要介绍了解决Mybatis-plus找不到对应表及默认表名命名规则的问题,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-11-18- 这篇文章主要介绍了搭建MyBatis-Plus框架并进行数据库增删改查,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-03-12
Mybatis或Mybatis-Plus框架的xml文件中特殊符号的使用详解
这篇文章主要介绍了Mybatis或Mybatis-Plus框架的xml文件中特殊符号的使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-11-19SpringBoot+Mybatis-Plus实现mysql读写分离方案的示例代码
这篇文章主要介绍了SpringBoot+Mybatis-Plus实现mysql读写分离方案的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-03-09- 这篇文章主要介绍了Mybatis-Plus 通用CRUD的详细操作,包括插入操作,更新操作及删除操作等,针对每种操作通过实例代码给大家介绍的非常详细,需要的朋友可以参考下...2021-09-16
- 这篇文章主要介绍了mybatis-plus主键生成策略,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-08-27