背景
业务人员反映某某表数据莫名奇妙丢失了,要求系统排查。当时理解丢失是整条数据被删除了(文字表达精准的重要性/(ㄒoㄒ)/~~),于是排查所有delete相关代码,未发现异常。后经过反复沟通,业务表达的丢失是指某条记录的某两个属性值丢失,被置为null了(哭笑不得)。
于是继续排查,系统引入了mybatis-plus框架,数据表对应的实体其中有两个属性被加了 @TableField(updateStrategy = FieldStrategy.IGNORED)
引起注意。
java
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String spclFieldName;
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String valMpngFldNm;
FieldStrategy.IGNORED
通过智能助手得到的答案是:
@TableField(updateStrategy = FieldStrategy.IGNORED) 是 MyBatis-Plus 框架中的一个注解,用于指定某个字段在更新操作时的策略。
具体来说,@TableField 注解用于标识实体类中的字段与数据库表中的列之间的映射关系。而 updateStrategy 属性则用于定义在更新数据库记录时,该字段的更新策略。
FieldStrategy.IGNORED 是 updateStrategy 的一个值,它表示在更新操作中忽略该字段。这意味着,当你在使用 MyBatis-Plus 进行更新操作时,即使你为这个字段设置了新的值,MyBatis-Plus 也不会将这个字段的值更新到数据库中。
例如,假设你有一个 User 实体类,其中有一个 name 字段,并且你想在更新用户信息时忽略这个字段,那么你可以这样写:
javapublic class User { private Long id; @TableField(updateStrategy = FieldStrategy.IGNORED) private String name; // 其他字段和getter/setter方法 }
在这个例子中,即使你在更新 User 实体时设置了新的 name 值,这个值也不会被更新到数据库中。这可以用于保护某些重要字段,确保它们不会被意外修改。
而这里智能助手给的答案是错误的。当然这个单词确实也很容易让人误会,所以作者后面也抛弃了该注解。
通过mybatisplus官网查到这个注解意思:是忽略判断。而mybatisplus的默认全局判断策略是 not null判断,也就是说只有在值为非null的时候 update方法才会去修改对应的字段值。
以下为对应的源码:
Wrapper.java
java
/**
* 根据实体FieldStrategy属性来决定判断逻辑
*/
private boolean fieldStrategyMatch(TableInfo tableInfo, T entity, TableFieldInfo e) {
switch (e.getWhereStrategy()) {
case NOT_NULL:
return Objects.nonNull(tableInfo.getPropertyValue(entity, e.getProperty()));
case IGNORED:
return true;
case NOT_EMPTY:
return StringUtils.checkValNotNull(tableInfo.getPropertyValue(entity, e.getProperty()));
case NEVER:
return false;
default:
return Objects.nonNull(tableInfo.getPropertyValue(entity, e.getProperty()));
}
}
TableFieldInfo.java
java
/**
* 转换成 if 标签的脚本片段
*
* @param sqlScript sql 脚本片段
* @param property 字段名
* @param fieldStrategy 验证策略
* @return if 脚本片段
*/
private String convertIf(final String sqlScript, final String property, final FieldStrategy fieldStrategy) {
if (fieldStrategy == FieldStrategy.NEVER) {
return null;
}
if (isPrimitive || fieldStrategy == FieldStrategy.IGNORED) {
return sqlScript;
}
if (fieldStrategy == FieldStrategy.NOT_EMPTY && isCharSequence) {
return SqlScriptUtils.convertIf(sqlScript, String.format("%s != null and %s != ''", property, property),
false);
}
return SqlScriptUtils.convertIf(sqlScript, String.format("%s != null", property), false);
}
发现,FieldStrategy.IGNORED就是忽略判断,
所以在 使用 update方法时,虽然那两个属性值为null,但最后生成的sql是
sql
set spclFieldName=null,valMpngFldNm=null
导致这两个属性值丢失。
解决办法是去掉这两个注解,或者使用
java
ChainWrappers.lambdaUpdateChain(this.getBaseMapper())
.set(IdxDefTblPo::getPerfDivdIntoInd, "1")
.in(IdxDefTblPo::getIdxId, yesList)
.update();
指定更新的字段和条件。