告别手动赋值!优雅处理 MyBatis-Plus 的创建时间和更新时间

背景

Spring JPA 提供了 @CreatedDate@LastModifiedDate 注解,用于自动赋值实体类的创建时间和更新时间。但我们的团队主要使用 MyBatis-Plus 作为 ORM 框架,需要提供同类的机制支持。

目标

为 MyBatis-Plus 提供自动填充功能。

实现

MyBatis-Plus 也提供了自动填充功能,通过实现 com.baomidou.mybatisplus.core.handlers.MetaObjectHandler 接口来实现。笔者定了 AutofillMetaObjectHandler 类实现,如下。

java 复制代码
@RequiredArgsConstructor
public class AutofillMetaObjectHandler implements MetaObjectHandler {

	private final String createdDateFieldName;

	private final String lastModifiedDateFieldName;

	/**
	 * 插入元对象字段填充(用于插入时对公共字段的填充)
	 *
	 * @param metaObject 元对象
	 */
	@Override
	public void insertFill(MetaObject metaObject) {
		LocalDateTime now = LocalDateTime.now();
		this.strictInsertFill(metaObject, createdDateFieldName, LocalDateTime.class, now);
		this.strictUpdateFill(metaObject, lastModifiedDateFieldName, LocalDateTime.class, now);
	}

	/**
	 * 更新元对象字段填充(用于更新时对公共字段的填充)
	 *
	 * @param metaObject 元对象
	 */
	@Override
	public void updateFill(MetaObject metaObject) {
		LocalDateTime now = LocalDateTime.now();
		this.strictUpdateFill(metaObject, lastModifiedDateFieldName, LocalDateTime.class, now);
	}
}

预留了 createdDateFieldNamelastModifiedDateFieldName 字段,提供给 @Configuration 配置类扩展。

java 复制代码
@AutoConfigureAfter(MybatisPlusAutoConfiguration.class)
@ConditionalOnClass({
	SqlSessionFactory.class,
	SqlSessionFactoryBean.class,
	MybatisConfiguration.class
})
@ConditionalOnProperty(name = "mybatis-plus.extension.auto-fill.enabled", havingValue = "true")
@EnableConfigurationProperties({MybatisPlusExtensionProperties.class})
@Slf4j
@Role(BeanDefinition.ROLE_INFRASTRUCTURE)
@Configuration(proxyBeanMethods = false)
public class MybatisPlusExtensionAutoConfiguration {

	@ConditionalOnMissingBean
	@Bean
	public MetaObjectHandler metaObjectHandler(MybatisPlusExtensionProperties properties) {
		log.debug("Autowired MetaObjectHandler");
		return new AutofillMetaObjectHandler(properties.getAutoFill().getCreatedDateFieldName(),
			properties.getAutoFill().getLastModifiedDateFieldName());
	}
}

@Data
@ConfigurationProperties(prefix = "mybatis-plus.extension")
public class MybatisPlusExtensionProperties {

	private final AutoFill autoFill = new AutoFill();

	@Data
	public static class AutoFill {

		private boolean enabled = true;

		private String createdDateFieldName = "created_date"; 

		private String lastModifiedDateFieldName = "last_modified_date";
	}
}

MybatisPlusExtensionProperties 属性类默认设置 created_date 字段为 SQL 表的创建时间,last_modified_date 为最后修改时间,业务方可以通过 mybatis-plus.extension.auto-fill.created-date-field-namemybatis-plus.extension.auto-fill.last-modified-date-field-name 自行调整。

业务方在项目配置 mybatis-plus.extension.auto-fill.enabled=true 启用 MyBatis-Plus 自动填充,在实体类中使用 @TableField 注解来标记哪些字段需要自动填充,并指定填充的策略,如下。

java 复制代码
public class User {

    @TableField(fill = FieldFill.INSERT)
    private String createTime;

    @TableField(fill = FieldFill.UPDATE)
    private String updateTime;

    // 其他字段...
}

这样就完成了 MyBatis-Plus 的自动填充功能,根据这个思路,也可以实现 @CreatedBy 创建人和 @LastModifiedBy 最后修改人。

产出

一般我们在设计表都会保留两个字段:创建时间和最后修改时间,引入这个组件,可以简化业务的处理。

本文涉及的代码完全开源,感兴趣的伙伴可以查阅 eden-mybatis-spring-boot-starter

相关推荐
kfepiza1 小时前
Debian10安装Mysql5.7.44 笔记250707
笔记·mysql·debian
armcsdn2 小时前
基于Docker Compose部署Traccar容器与主机MySQL的完整指南
mysql·docker·容器
袋鼠云数栈3 小时前
使用自然语言体验对话式MySQL数据库运维
大数据·运维·数据库·后端·mysql·ai·数据治理·数栈·data+ai
渣渣盟3 小时前
掌握MySQL函数:高效数据处理指南
sql·mysql·adb·dba
铅笔侠_小龙虾4 小时前
Docker 实战 -- Mysql
mysql·docker·容器
Britz_Kevin5 小时前
从零开始的云计算生活——番外2,MySQL组复制
数据库·mysql·云计算·生活·#组复制
工藤学编程5 小时前
分库分表之实战-sharding-JDBC绑定表配置实战
数据库·分布式·后端·sql·mysql
一只fish6 小时前
MySQL 8.0 OCP 1Z0-908 题目解析(23)
数据库·mysql
程序猿小D6 小时前
[附源码+数据库+毕业论]基于Spring Boot+mysql+vue结合内容推荐算法的学生咨询系统
数据库·vue.js·spring boot·mysql·毕业设计·推荐算法·学生咨询系统
大菠萝学姐7 小时前
基于Spring Boot和Vue的高校图书馆座位预约系统的设计与实现
java·vue.js·spring boot·后端·python·mysql·vue