MyBatis中日期字段空值的插入与更新方案优化问询

我有一个Java Bean BeanA：

public class BeanA {
    
    private Integer id;
    private String dateField;
    // other fields
}

对应MySQL表 bean_a，包含date类型列 date_field。
对应的MyBatis SQL如下：

<insert ..>
insert into bean_a(date_field, ..) values
(
<if test="dateField != null and dateField == ''">null,</if>
<if test="dateField != null and dateField != ''">#{dateField},</if>
...
)
</insert>

<update ..>
update bean_a
<set>
<if test="dateField != null && dateField == ''">date_field = null,</if>
<if test="dateField != null && dateField != ''">date_field = #{dateField},</if>
</set>
where id = #{id}
</update>

日期字段存在两种场景：

• 用户在UI上清空该值，此时需向表中插入/更新null
• BeanA beanA = new BeanA();set other fields exclude dateField;then call dao to update BeanA，此时因dateField为null，不应修改表中的date_field

请问上述方案是否为通用实践？是否有更优方案（因每个插入/更新需两次if判断，存在重复）？

一、是否属于通用实践？ #

这种方案是常见的临时解决方案，但算不上通用实践。它能勉强区分“主动清空”和“未设置”的场景，但存在明显缺陷：

1. 重复代码冗余：每个涉及该字段的Insert/Update都要写两组if判断，字段越多维护成本越高；
2. 语义约定模糊：用空字符串代表“主动清空”需要团队统一认知，新人接手容易误判逻辑；
3. 扩展性差：后续新增类似字段时，会导致XML中的判断逻辑持续膨胀。

二、更优方案 #

方案1：使用「更新标记类」明确字段状态 #

创建专门的更新DTO类（比如BeanAUpdateDTO），为每个需要区分状态的字段添加一个布尔标记，标识该字段是否需要更新：

public class BeanAUpdateDTO {
    private Integer id;
    private String dateField;
    private boolean updateDateField; // 标记是否要更新dateField
    
    // 其他字段及对应的更新标记
}

业务逻辑中：

• 用户主动清空日期：setDateField(null); setUpdateDateField(true);
• 不需要修改日期：保持updateDateField默认false，不触发更新

对应的MyBatis SQL可大幅简化：

<update ..>
update bean_a
<set>
<if test="updateDateField">date_field = #{dateField},</if>
<!-- 其他字段同理 -->
</set>
where id = #{id}
</update>

这种方式语义清晰，避免了空字符串的歧义，也消除了重复判断。

方案2：用choose-when-otherwise合并重复判断 #

如果不想新增类，可以用MyBatis的choose标签合并两组if逻辑，减少代码重复：

<insert ..>
insert into bean_a(date_field, ..) values
(
<choose>
    <when test="dateField != null and dateField == ''">null,</when>
    <when test="dateField != null and dateField != ''">#{dateField},</when>
    <otherwise>#{dateField},</otherwise> <!-- dateField为null时，插入默认值或留空 -->
</choose>
...
)
</insert>

<update ..>
update bean_a
<set>
<choose>
    <when test="dateField != null and dateField == ''">date_field = null,</when>
    <when test="dateField != null and dateField != ''">date_field = #{dateField},</when>
    <!-- 无otherwise，dateField为null时不生成更新语句 -->
</choose>
</set>
where id = #{id}
</update>

通过choose整合分支判断，让XML结构更简洁，避免重复的条件校验。

方案3：借助MyBatis-Plus的灵活更新策略 #

如果项目使用MyBatis-Plus，可利用其Wrapper API精准控制更新字段：

// 用户主动清空日期
UpdateWrapper<BeanA> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", beanA.getId()).set("date_field", null);
// 仅更新其他字段时，不添加date_field的set语句
updateWrapper.eq("id", beanA.getId()).set("other_field", beanA.getOtherField());

这种方式完全无需在XML中编写复杂判断，通过Java代码直接控制要更新的字段，逻辑直观且扩展性强。

内容的提问来源于stack exchange，提问作者frank