当前位置：首页 > news >正文

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

news 2025/9/18 1:11:47

🌰 举个直观例子

🛠️ 核心作用原理

📜 代码级工作流程

📜 完整代码

🔍 关键概念拆解

⚠️ 常见问题排查

🌟 设计意义

🌰 举个直观例子

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())
有了元对象处理器：你只需专注业务逻辑，框架自动帮你填充这个时间

🛠️ 核心作用原理

拦截数据库操作
MyBatis-Plus 在执行 insert() 或 update() 操作时，会触发元对象处理器。
通过注解识别目标字段
字段上的 @TableField(fill = FieldFill.INSERT) 注解会告诉处理器："这个字段需要自动填充"。
反射动态赋值
处理器利用反射机制，通过 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 {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", Date.class, new Date());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "updateTime", Date.class, new Date());
    }

}

🔍 关键概念拆解

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