SpringBlade 数据库字段的自动填充

今天上班时,发现项目代码中实体类中没有定义相关创建人,更新人等等字段,只是继承了两个父类实体就实现了自动填充,以下是记录:

为什么post表或者bp表新增的时候创建人id等字段自动出现?

a. SpringBlade框架的自动填充机制

主要原因在于 SpringBlade框架的自动填充机制

实体类 BpTable 继承了 TenantEntity,而 TenantEntity 又继承了 BaseEntity(框架默认行为)。这些父类中已经包含了以下字段:

复制代码
public abstract class BaseEntity {
    private Long createUser;   // 对应 create_user
    private Long createDept;   // 对应 create_dept
    private LocalDateTime createTime;
    private Long updateUser;   // 对应 update_user
    private LocalDateTime updateTime;
    // 其他公共字段...
}

而SpringBlade 默认通过以下方式自动填充这些字段:

插入时 :自动填充 create_usercreate_deptcreate_time

更新时 :自动填充 update_userupdate_time

b. 原理

这是通过框架的 元对象处理器(MetaObjectHandler) 实现的,例如:

复制代码
@Component
public class BladeMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        // 自动设置创建人、部门、时间
        this.strictInsertFill(metaObject, "createUser", Long.class, UserUtil.getUserId());
        this.strictInsertFill(metaObject, "createDept", Long.class, UserUtil.getDeptId());
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        // 自动设置更新人和时间
        this.strictUpdateFill(metaObject, "updateUser", Long.class, UserUtil.getUserId());
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

c. 自动填充的启用与禁用

ⅰ. 保留自动填充(推荐)

如果这些字段需要自动记录操作人信息,无需任何修改,框架会持续自动维护这些字段。

ⅱ. 禁用自动填充

若需手动控制这些字段,需以下步骤:

方式一:从实体类中移除字段

复制代码
public class BpTable extends TenantEntity {
    // 移除继承的 TenantEntity,改为直接继承 BaseEntity 或完全自定义
    // 其他字段保持不变...
}

方式二:覆盖框架的自动填充逻辑

在实体类中显式忽略这些字段:

复制代码
@Data
@TableName("bp_table")
public class BpTable {
    @TableField(value = "create_user", fill = FieldFill.NONE)  // 禁止自动填充
    private Long createUser;

    @TableField(value = "create_dept", fill = FieldFill.NONE)
    private Long createDept;

    // 其他字段...
}

方式三:关闭全局自动填充(不推荐)

在配置文件中禁用 MyBatis-Plus 的自动填充:

复制代码
mybatis-plus:
  global-config:
    db-config:
      logic-not-delete-field: ""  # 关闭逻辑删除字段自动填充
      meta-object-handler: none   # 关闭所有自动填充(慎用)

ⅲ. 验证是否生效

插入数据后检查 SQL 日志,确认是否仍有自动填充行为:

复制代码
INSERT INTO bp_table (create_user, create_dept, update_user, ...) 
VALUES (?, ?, ?, ...)  # 如果值为NULL,说明已禁用成功
相关推荐
sniper_fandc35 分钟前
SpringBoot系列—入门
java·spring boot·后端
阿絮~40 分钟前
Apache RocketMQ进阶之路阅读笔记和疑问
笔记·apache·rocketmq
代码的余温2 小时前
Maven引入第三方JAR包实战指南
java·maven·jar
先睡4 小时前
Redis的缓存击穿和缓存雪崩
redis·spring·缓存
pianmian15 小时前
类(JavaBean类)和对象
java
我叫小白菜6 小时前
【Java_EE】单例模式、阻塞队列、线程池、定时器
java·开发语言
天水幼麟6 小时前
动手学深度学习-学习笔记(总)
笔记·深度学习·学习
Albert Edison6 小时前
【最新版】IntelliJ IDEA 2025 创建 SpringBoot 项目
java·spring boot·intellij-idea
超级小忍7 小时前
JVM 中的垃圾回收算法及垃圾回收器详解
java·jvm
weixin_446122467 小时前
JAVA内存区域划分
java·开发语言·redis