在新增员工时需要设置创建时间、创建人、修改时间、修改人等字段,在编辑员工时需要设置修改时间、修改人等字段。这些字段属于公共字段,也就是也就是在我们的系统中很多表中都会有这些字段,如下:
1.2 基本功能实现 1.2.1 思路分析而针对于这些字段,我们的赋值方式为:
A. 在新增数据时, 将createTime、updateTime 设置为当前时间, createUser、updateUser设置为当前登录用户ID。
B. 在更新数据时, 将updateTime 设置为当前时间, updateUser设置为当前登录用户ID。
Mybatis Plus公共字段自动填充,也就是在插入或者更新的时候为指定字段赋予指定的值,使用它的好处就是可以统一对这些字段进行处理,避免了重复代码。在上述的问题分析中,我们提到有四个公共字段,需要在新增/更新中进行赋值操作, 具体情况如下:
字段名 | 赋值时机 | 说明 |
---|---|---|
createTime | 插入(INSERT) | 当前时间 |
updateTime | 插入(INSERT) , 更新(UPDATE) | 当前时间 |
createUser | 插入(INSERT) | 当前登录用户ID |
updateUser | 插入(INSERT) , 更新(UPDATE) | 当前登录用户ID |
1.2.2 代码实现实现步骤:
1、在实体类的属性上加入@TableField注解,指定自动填充的策略。
2、按照框架要求编写元数据对象处理器,在此类中统一为公共字段赋值,此类需要实现MetaObjectHandler接口。
1). 实体类的属性上加入@TableField注解,指定自动填充的策略。
这里就不提供代码,要注创建时间和创建人只在insert语句中需要自动填充。
- FieldFill.INSERT: 插入时填充该属性值
- FieldFill.INSERT_UPDATE: 插入/更新时填充该属性值
2). 按照框架要求编写元数据对象处理器,在此类中统一为公共字段赋值,此类需要实现MetaObjectHandler接口。
放在项目的common包下
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler; import lombok.extern.slf4j.Slf4j; import org.apache.ibatis.reflection.MetaObject; import org.springframework.stereotype.Component; import java.time.LocalDateTime; @Component @Slf4j public class MyMetaObjecthandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { log.info("公共字段自动填充[insert]..."); log.info(metaObject.toString()); metaObject.setValue("createTime", LocalDateTime.now()); metaObject.setValue("updateTime",LocalDateTime.now()); metaObject.setValue("createUser",new Long(1)); metaObject.setValue("updateUser",new Long(1)); } @Override public void updateFill(MetaObject metaObject) { log.info("公共字段自动填充[update]..."); log.info(metaObject.toString()); metaObject.setValue("updateTime",LocalDateTime.now()); metaObject.setValue("updateUser",new Long(1)); } }1.3 功能完善 1.3.1 思路分析
前面我们已经完成了公共字段自动填充功能的代码开发,但是还有一个问题没有解决,就是我们在自动填充createUser和updateUser时设置的用户id是固定值,现在我们需要完善,改造成动态获取当前登录用户的id。
大家可能想到,用户登录成功后我们将用户id存入了HttpSession中,现在我从HttpSession中获取不就行了?
1.3.2 ThreadLocal注意,我们在MyMetaObjectHandler类中是不能直接获得HttpSession对象的,所以我们需要通过其他方式来获取登录用户id。
- 那么我们先搞清楚一点,当我们在修改员工信息时, 我们业务的执行流程是什么样子的,如下图:
ThreadLocal并不是一个Thread,而是Thread的局部变量。当使用ThreadLocal维护变量时,ThreadLocal为每个使用该变量的线程提供独立的变量副本,所以每一个线程都可以独立地改变自己的副本,而不会影响其它线程所对应的副本。
ThreadLocal为每个线程提供单独一份存储空间,具有线程隔离的效果,只有在线程内才能获取到对应的值,线程外则不能访问当前线程对应的值。
ThreadLocal常用方法:
A. public void set(T value) : 设置当前线程的线程局部变量的值
B. public T get() : 返回当前线程所对应的线程局部变量的值
C. public void remove() : 删除当前线程所对应的线程局部变量的值
1.3.3 操作步骤我们可以在LoginCheckFilter(过滤器)的doFilter方法中获取当前登录用户id,并调用ThreadLocal的set方法来设置当前线程的线程局部变量的值(用户id),然后在MyMetaObjectHandler的updateFill方法中调用ThreadLocal的get方法来获得当前线程所对应的线程局部变量的值(用户id)。 如果在后续的操作中, 我们需要在Controller / Service中要使用当前登录用户的ID, 可以直接从ThreadLocal直接获取。
实现步骤:
1). 编写UserThreadLocal工具类,基于ThreadLocal封装的工具类
2). 在LoginCheckFilter的doFilter方法中调用BaseContext来设置当前登录用户的id
3). 在MyMetaObjectHandler的方法中调用BaseContext获取登录用户的id
1.3.4 代码实现1). UserThreadLocal工具类
public class UserThreadLocal { private UserThreadLocal() { } private static ThreadLocalTHREADLOCAL = new ThreadLocal<>(); public static void setCurrentId(Long id) { THREADLOCAL.set(id); } public static Long getCurrentId() { return THREADLOCAL.get(); } public static void remove() { THREADLOCAL.remove(); } }
2).LoginCheckFilter中存放当前登录用户到ThreadLocal
在doFilter方法中, 判定用户是否登录, 如果用户登录, 在放行之前, 获取HttpSession中的登录用户信息, 调用BaseContext的setCurrentId方法将当前登录用户ID存入ThreadLocal。
有些小伙伴肯定会有疑问,清除id的方法就写在下面,这不就等于没设吗,方法都没走完就给清除了。
filterChain.doFilter(request, response); 会等待 Controller,等一系类方法的调用,才会结束。
我解释的不是很完美,大家可以自行测试
3). MyMetaObjectHandler中从ThreadLocal中获取
1.3.5 功能测试将之前在代码中固定的当前登录用户1, 修改为动态调用UserThreadLocal中的getCurrentId方法获取当前登录用户ID
2. 逻辑删除 2.1 问题分析完善了元数据对象处理器之后,我们就可以重新启动项目,对插入或者更新的接口去测试。
2.2 思路分析在实际的项目中,数据是十分宝贵的,所以不会做到真正的去删除。数据库中一般会存在如下字段:
2.3 代码实现 2.3.1配置全局MybatisPlus为我们提供了许多种的配置方法。
- 可以在yaml中配置全局的逻辑删除
- 也可以在每个实体类中
配置yaml
- 图中红框中的就是全局逻辑删除的配置,其他的可以根据需要自行添加
- logic-delete-field: deleted 配置的一定对应上实体类的变量名称
- @TableField(value = "is_deleted") value对应的是数据库的字段
mybatis-plus: configuration: #在映射实体或者属性时,将数据库中表名和字段名中的下划线去掉,按照驼峰命名法映射 address_book ---> AddressBook map-underscore-to-camel-case: true #日志输出 log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: ASSIGN_ID # 全局配置数据库id生成的策略 logic-delete-field: deleted # 全局逻辑删除的实体字段名(实体类) logic-delete-value: 1 # 逻辑已删除值(默认为1) logic-not-delete-value: 0 # 逻辑未删除值(默认为0)2.3.2实体类中
- @TableLogic(value = "0", delval = "1")配置逻辑删除字段的值,value的值表示未删除的时候的值,delval的值表示已删除时候的值;