Mybatis-Plus更新对象时字段更新为空值的问题

Mybatis-Plus更新对象时字段更新为空值的问题

问题:

Mybatis-plus(简称:mp)执行更新操作,将某些字段值置为 空 或者 null,持久层执行后,需要更新为空值的字段仍然保持原本的值。显然和我们预期的结果不一致。

我们可以参照以下三种方案处理 mp 执行更新操作空值的情况。

方案一:注解方式

针对实体类中字段的注解,在 mybatis-plus 的 @tablefield有 FieldStrategy-字段验证策略 和 FieldFill-自动填充 两种方式:

FieldStrategy 字段策略的3个使用场景:

  • insertStrategy insert操作时的字段策略,是否进行空值判断,插入空值
  • updateStrategy update操作时的字段策略,是否进行空值判断,插入空值
  • whereStrategy where条件组装时的字段策略,是否进行控制判断,将空值作为查询条件

这里我们主要说 mp 执行更新操作,某一字段值为空未被更新的情况:就是注解中的:updateStrategyfill 两个属性。

1、updateStrategy(字段验证策略之 update)

1.1 当执行更新操作时,该字段拼接set语句时的策略:

  • IGNORED: update table_a set column=#{columnProperty}, 属性为null/空string都会被set进去
  • NOT_NULL: update table_a set <if test="columnProperty != null">column=#{columnProperty}</if>
  • NOT_EMPTY: update table_a set <if test="columnProperty != null and columnProperty!=''">column=#{columnProperty}</if> 如果针对的是非 CharSequence 类型的字段则效果等于 NOT_NULL

1.2 FieldStrategy 有三种策略:

  • IGNORED:忽略
  • NOT_NULL:非 NULL,默认策略
  • NOT_EMPTY:非空

当更新字段为 空字符串 或者 null 的需求时,需要对 FieldStrategy 策略进行调整对应的策略值。示例:

@TableField(value = "ENDDATE", updateStrategy=FieldStrategy.IGNORED)
private Date enddate;

1.3 注意

在 官方文档中给出的 “方式二:调整字段验证注解”的 @TableField(strategy=FieldStrategy.NOT_EMPTY) ,其写法在 3.1.2 版本后 strategy 方法被弃用,更新为 insertStrategyupdateStrategywhereStrategy

/**
* 字段验证策略
* <p>默认追随全局配置</p>
*
* @deprecated 3.1.2 , to use {@link #insertStrategy} and {@link #updateStrategy} and {@link #whereStrategy}
*/
@Deprecated
FieldStrategy strategy() default FieldStrategy.DEFAULT;

2、FieldFill

2.1 在 @tablefield 注解中有属性:fill ,字段自动填充策略。

fill 自动填充指的是某些字段只有在特定的场景下才会被填充,例如表里的数据:create_time (创建时间)和 update_time(更新时间), 创建时间是在数据插入的时候会被填充的,而更新时间是在这条数据被更新时填充的,如下代码所示,fill 注解自动填充可以很好的实现这个。

@TableField(value = "create_time",fill = FieldFill.INSERT)
private Date createTime;
@TableField(value = "update_time",fill = FieldFill.INSERT_UPDATE)
private Date updateTime;

2.2 FieldFill 字段填充策略枚举类如下:

描述
DEFAULT 默认不处理
INSERT 插入时填充字段
UPDATE 更新时填充字段
INSERT_UPDATE 插入和更新时填充字段
  • 当 fill = FieldFill.INSERT 表示在执行 INSERT 语句时,该字段才会被填充。

  • 当 fill = FieldFill.INSERT_UPDATE 表示在执行 INSERT、UPDATE 语句时,该字段才会被填充。

2.3 FieldStrategy 与 FieldFill

对于 FieldStrategy 和 FieldFill,判断注入的 insert 和 update 的 sql 脚本是否在对应情况下忽略掉字段的 if 标签生成, FieldFill 优先级是高于 FieldStrategy 的。

方案二:全局配置

根据方案一,FieldStrategy 的三种策略:IGNORED、NOT_NULL、NOT_EMPTY, 可以在 application.yml 配置文件中注入配置 GlobalConfiguration 属性 update-strategy, 将 update-strategy 策略调整为 IGNORED,即忽略判断策略。即可调整全局的验证策略。如下所示:

# yml 配置:
mybatis-plus:
  global-config:
    db-config:
      update-strategy: IGNORED

全局性配置会对所有的字段都忽略判断,如果有特殊字段处理,可以单独配置,修改字段的策略。

设定全局配置,可以减少一个一个字段去指定增加的麻烦。

方案三:使用 UpdateWrapper (3.x) 更新

mp 提供了 UpdateWrapper 类简化更新的操作, 针对方法级进行操作,只需操作其更新方法,相比较方案一和方案二,方案三影响范围较小。

由于 BaseMapper 的继承 Mapper ,在 BaseMapper的源码中写道:

/**
 * 根据 whereEntity 条件,更新记录
 *
 * @param entity        实体对象 (set 条件值,可以为 null)
 * @param updateWrapper 实体对象封装操作类(可以为 null,里面的 entity 用于生成 where 语句)
 */
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);

可看出,实体对象可以 set 条件值且可以为 null,说明有两种方法可以实现更新操作(采用 lambda 表达式):

1、将需要更新的字段,设置到 entity 中

mapper.update(
   new User().setName("mp").setAge(3),
   Wrappers.<User>lambdaUpdate()
           .set(User::getEmail, null) //把email设置成null
           .eq(User::getId, 2)
);

2、将 entity设置为 null ,将需要更新的字段设置到 UpdateWrapper 中

mapper.update(
    null,
    Wrappers.<User>lambdaUpdate()
       .set(User::getAge, 3)
       .set(User::getName, "mp")
       .set(User::getEmail, null) //把email设置成null
       .eq(User::getId, 2)
);

参考资料

  • mp-annotation:https://www.mybatis-plus.com/guide/annotation.html
  • mp-BaseMapper:https://Github.com/baomidou/mybatis-plus/blob/3.0/mybatis-plus-core/src/main/Java/com/baomidou/mybatisplus/core/mapper/BaseMapper
  • mp-FAQ: https://www.mybatis-plus.com/guide/faq.html


原文始发于微信公众号(AmberBala):Mybatis-Plus更新对象时字段更新为空值的问题

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/179066.html

(0)
小半的头像小半

相关推荐

发表回复

登录后才能评论
极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!