MyBatis-Plus 元对象处理器 @TableField注解 反射动态赋值 实现字段自动填充

目录

🌰 举个直观例子

🛠️ 核心作用原理

📜 代码级工作流程

📜 完整代码

🔍 关键概念拆解

⚠️ 常见问题排查

🌟 设计意义

🌰 举个直观例子

package work.dduo.ans.domain;import com.baomidou.mybatisplus.annotation.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;import java.io.Serializable;
import java.util.Date;/*** * @TableName t_visit_log*/
@TableName(value ="t_visit_log")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class TVisitLog implements Serializable {/*** id*/@TableId(type = IdType.AUTO)private Integer id;/*** 访问ip*/private String ipAddress;/*** 访问地址*/private String ipSource;/*** 操作系统*/private String os;/*** 访问时间* 使用mybatis-plus的元对象处理器自动填充*/@TableField(fill=FieldFill.INSERT)private Date createTime;private static final long serialVersionUID = 1L;}

假设你每次保存订单时都要记录 "订单创建时间"：

• 没有元对象处理器：每次插入数据都要手动写 order.setCreateTime(new Date())
• 有了元对象处理器：你只需专注业务逻辑，框架自动帮你填充这个时间

---

🛠️ 核心作用原理

1. 拦截数据库操作
   MyBatis-Plus 在执行 insert() 或 update() 操作时，会触发元对象处理器。
2. 通过注解识别目标字段
   字段上的 @TableField(fill = FieldFill.INSERT) 注解会告诉处理器："这个字段需要自动填充"。
3. 反射动态赋值
   处理器利用反射机制，通过 MetaObject 对象直接操作实体类的字段值（无需手动调用 set 方法）。

---

📜 代码级工作流程

以你的 createTime 字段为例：

// 1. 你的实体类标记了自动填充
public class TVisitLog {@TableField(fill = FieldFill.INSERT)private Date createTime;
}// 2. 插入操作时自动触发
TVisitLog log = new TVisitLog();
visitLogMapper.insert(log); // ← 这里自动填充 createTime// 3. 处理器内部执行（伪代码）
class MyMetaObjectHandler {void insertFill() {if (字段有 @TableField(fill=INSERT)) {用反射给字段赋值 new Date()}}
}

📜 完整代码

package work.dduo.ans.handler;import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;import java.util.Date;@Component
public class MyMetaObjectHandler  implements MetaObjectHandler {@Overridepublic void insertFill(MetaObject metaObject) {this.strictInsertFill(metaObject, "createTime", Date.class, new Date());}@Overridepublic void updateFill(MetaObject metaObject) {this.strictInsertFill(metaObject, "updateTime", Date.class, new Date());}}

---

🔍 关键概念拆解

概念	说明
MetaObject	对实体类的动态包装器，提供反射操作字段的能力（类似一个能透视对象内部结构的工具）
FieldFill	填充策略枚举，包含 INSERT（插入时填充）、UPDATE（更新时填充）等
strictInsertFill	严格模式填充方法，确保字段存在且类型匹配

---

⚠️ 常见问题排查

如果自动填充失效，检查：

1. 处理器类是否添加了 @Component 注解
2. 实体类字段名与处理器中写的名称是否完全一致（包括大小写）
3. 是否在主启动类的扫描范围内（位于同一包或子包）
4. 数据库字段是否有默认值冲突（建议同时设置数据库默认值 CURRENT_TIMESTAMP）

---

🌟 设计意义

通过元对象处理器，实现了：
✅ 业务代码与非业务逻辑解耦（时间记录等通用操作集中管理）
✅ 消除重复代码（避免每个插入操作都写 setCreateTime）
✅ 保证数据一致性（比如强制所有表统一使用同一时间生成规则）