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个使用场景：
insertStrategyinsert操作时的字段策略，是否进行空值判断，插入空值updateStrategyupdate操作时的字段策略，是否进行空值判断，插入空值whereStrategywhere条件组装时的字段策略，是否进行控制判断，将空值作为查询条件
2、字段策略的5种类型：
IGNORED忽略空值判断，实体对象的字段是什么值就用什么值更新，支持null值更新操作NOT_NULL进行非NULL判断，相当于age!=null，也是默认的策略NOT_EMPTY进行非空判断，主要是针对字符串类型的字段，相当于name != null and name != ''NEVER从不更新，不管字段是否有值，都不进行更新DEFAULT追随全局配置
到此这篇关于Mybatis-Plus字段策略FieldStrategy的使用的文章就介绍到这了,更多相关Mybatis-Plus字段策略FieldStrategy内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！
免责声明：
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的，并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据，供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
