一、背景描述
项目所有技术栈,spring boot (2.1.5.RELEASE) + mybatis-plus (3.3.1.tmp) + 其他。重点是这里使用了 mybatis-plus。
由于享受了懒人福利(不写或者少写sql语句),但是也或多或少的踩了一些别人没有踩到的坑。比如今天在使用 mybatis-plus updateById()方法更新数据库字段时,就遇到了糟心事儿,本来想把某个字段更新为空呢,结果竟然没有更新成功。其他非空字段更新正常。
二、问题原因
至于为什么某个字段更新为空会失败,首先想到的是可能与配置有关。所以去看配置文件,查看关于 mybatis-plus 相关的配置。
看到这个关于 mybatis-plus 配置项目后,有个 global-config 全局配置,field-strategy 字段策略被标注为 NOT_NULL 。然后一下子就明白了是怎么回事。
关于 mybatis-plus 插入或更新的字段有 空字符串 或者 null 时,mybatis-plus 官网上有关于这个问题的解决方案。
在这里,介绍一下 FieldStrategy 有三种策略:
- IGNORED:忽略
- NOT_NULL:非 NULL,默认策略
- NOT_EMPTY:非空
用户有更新字段为 空字符串 或者 null 的需求时,需要对 FieldStrategy 策略进行调整。
以上也是 mybatis-plus 官网上原文。
以下是 com.baomidou.mybatisplus.annotation.FieldStrategy 源码。DEFAULT是默认,这个不用管。
三、解决办法
mybatis-plus 官网上给出了三种解决方法,以下为摘取自 mybatis-plus 官网。想看官网的也可以,官网上的链接地址:https://mp.baomidou.com/guide/faq.html#插入或更新的字段有-空字符串-或者-null
方式一:调整全局的验证策略
注入配置 GlobalConfiguration 属性 fieldStrategy。
具体到我的项目里就是将 field-strategy 属性设备为 IGNORED,即忽略判断策略。
这样做是全局性配置,会对所有的字段都忽略判断,如果一些字段不想要修改,但是传值的时候没有传递过来,就会被更新为null,可能会影响其他业务数据的正确性。
方式二:调整字段验证注解
根据具体情况,在需要更新的字段中调整验证注解,如验证非空:
@TableField(strategy=FieldStrategy.NOT_EMPTY)
具体到我的项目里,是这样的:
我只是在对象里需要更新的字段上添加了 @TableField 注解,使用了更新策略。
使用上述方法,如果需要这样处理的字段较多,那么就需要涉及对各个字段上都添加该注解,显得有些麻烦了。
方式三:使用 UpdateWrapper (3.x)
使用以下方法来进行更新或插入操作:
//updateAllColumnById(entity) // 全部字段更新: 3.0已经移除 mapper.update( new User().setName("mp").setAge(3), Wrappers.<User>lambdaUpdate() .set(User::getEmail, null) //把email设置成null .eq(User::getId, 2) ); //也可以参考下面这种写法 mapper.update( null, Wrappers.<User>lambdaUpdate() .set(User::getAge, 3) .set(User::getName, "mp") .set(User::getEmail, null) //把email设置成null .eq(User::getId, 2) );
完结!