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_user、create_dept、create_time

• 更新时 :自动填充 update_user、update_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,说明已禁用成功
相关推荐
学长毕设7 分钟前
基于SpringBoot的儿童慈善捐赠管理系统-附源码
java·spring boot·后端
慧一居士16 分钟前
@RestControllerAdvice 的注解作用和使用
java
学长毕设1 小时前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
金銀銅鐵3 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
琳少_3 小时前
java程序开发笔记
java·开发语言·数据库·笔记
叼烟扛炮5 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
文丑颜不良啊5 小时前
LeetCode3401~3420题目解析
java·leetcode
Z21-X7 小时前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
一只大鸽子7 小时前
游戏开发笔记7-Godot RPG游戏基础-场景切换、全局脚本
笔记·游戏·godot
文丑颜不良啊7 小时前
LeetCode3421~3440题目解析
java·leetcode