公共字段自動填充的六種神技，開發效率翻倍！
本文將分享一套經過生產驗證的自動化方案，涵蓋MyBatis-Plus、AOP、JWT等六種核心策略，助你徹底擺脫公共字段維護的煩惱。
在開發外賣系統訂單模塊時，我發現每個實體類都包含create_time、update_by等重復字段。手動維護這些字段不僅效率低下，還容易出錯。
本文將分享一套經過生產驗證的自動化方案，涵蓋MyBatis-Plus、AOP、JWT等六種核心策略，助你徹底擺脫公共字段維護的煩惱。
一、痛點分析：公共字段維護的三大困境
1.1 典型問題場景
// 訂單創建邏輯
publicvoidcreateOrder(OrderDTO dto){
Order order = convertToEntity(dto);
// 手動設置公共字段
order.setCreateTime(LocalDateTime.now());
order.setUpdateTime(LocalDateTime.now());
order.setCreateUser(getCurrentUser());
order.setUpdateUser(getCurrentUser());
orderMapper.insert(order);
}
// 訂單更新邏輯
publicvoidupdateOrder(OrderDTO dto){
Order order = convertToEntity(dto);
// 重復設置邏輯
order.setUpdateTime(LocalDateTime.now());
order.setUpdateUser(getCurrentUser());
orderMapper.updateById(order);
}痛點總結：
- 代碼重復率高（每個Service方法都要設置）
- 維護成本高（字段變更需修改多處）
- 容易遺漏（特別是更新操作）
二、基礎方案：MyBatis-Plus自動填充
2.1 配置元對象處理器
@Slf4j
@Component
publicclassAutoFillHandlerimplementsMetaObjectHandler{
// 插入時自動填充
@Override
publicvoidinsertFill(MetaObject metaObject){
this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
this.strictInsertFill(metaObject, "createUser", String.class, getCurrentUser());
this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
}
// 更新時自動填充
@Override
publicvoidupdateFill(MetaObject metaObject){
this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
}
// 獲取當前用戶（從安全上下文）
private String getCurrentUser(){
return Optional.ofNullable(SecurityContextHolder.getContext())
.map(SecurityContext::getAuthentication)
.map(Authentication::getName)
.orElse("system");
}
}2.2 實體類注解配置
@Data
publicclassBaseEntity{
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;
@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;
@TableField(fill = FieldFill.INSERT)
private String createUser;
@TableField(fill = FieldFill.INSERT_UPDATE)
private String updateUser;
}
// 訂單實體繼承基類
publicclassOrderextendsBaseEntity{
// 業務字段...
}三、進階方案：AOP統一處理
3.1 自定義注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public@interface AutoFill {
OperationType value();
}
publicenum OperationType {
INSERT,
UPDATE
}3.2 切面實現
@Aspect
@Component
@Slf4j
publicclassAutoFillAspect{
@Autowired
private ObjectMapper objectMapper;
@Around("@annotation(autoFill)")
public Object around(ProceedingJoinPoint pjp, AutoFill autoFill)throws Throwable {
Object[] args = pjp.getArgs();
for (Object arg : args) {
if (arg instanceof BaseEntity) {
fillFields((BaseEntity) arg, autoFill.value());
}
}
return pjp.proceed(args);
}
privatevoidfillFields(BaseEntity entity, OperationType type){
String currentUser = getCurrentUser();
LocalDateTime now = LocalDateTime.now();
if (type == OperationType.INSERT) {
entity.setCreateTime(now);
entity.setCreateUser(currentUser);
}
entity.setUpdateTime(now);
entity.setUpdateUser(currentUser);
}
// 獲取當前用戶（支持多線程環境）
private String getCurrentUser(){
return Optional.ofNullable(RequestContextHolder.getRequestAttributes())
.map(attrs -> (ServletRequestAttributes) attrs)
.map(ServletRequestAttributes::getRequest)
.map(req -> req.getHeader("X-User-Id"))
.orElse("system");
}
}四、生產環境最佳實踐
4.1 多數據源適配
@Configuration
publicclassDataSourceConfig{
@Bean
@ConfigurationProperties("spring.datasource.master")
public DataSource masterDataSource(){
return DataSourceBuilder.create().build();
}
@Bean
public MetaObjectHandler metaObjectHandler(){
returnnew MultiDataSourceAutoFillHandler();
}
}
publicclassMultiDataSourceAutoFillHandlerextendsMetaObjectHandler{
// 根據當前數據源動態處理
}4.2 分布式ID生成
publicclassSnowflakeIdGenerator{
// 實現分布式ID生成
}
// 在自動填充中集成
@Override
publicvoidinsertFill(MetaObject metaObject){
this.strictInsertFill(metaObject, "id", String.class,
idGenerator.nextId());
}五、避坑指南：五大常見問題
5.1 空指針異常防護
// 使用Optional處理可能為空的情況
private String safeGetUser(){
return Optional.ofNullable(SecurityContextHolder.getContext())
.map(SecurityContext::getAuthentication)
.map(Authentication::getPrincipal)
.map(principal -> {
if (principal instanceof UserDetails) {
return ((UserDetails) principal).getUsername();
}
return principal.toString();
})
.orElse("system");
}5.2 字段覆蓋問題
// 在實體類中使用@TableField策略
@TableField(fill = FieldFill.INSERT, updateStrategy = FieldStrategy.NEVER)
private String createUser;六、性能優化方案
6.1 緩存當前用戶信息
publicclassUserContextHolder{
privatestaticfinal ThreadLocal<String> userHolder = new ThreadLocal<>();
publicstaticvoidsetUser(String user){
userHolder.set(user);
}
publicstatic String getUser(){
return userHolder.get();
}
publicstaticvoidclear(){
userHolder.remove();
}
}
// 在攔截器中設置
publicclassUserInterceptorimplementsHandlerInterceptor{
@Override
publicbooleanpreHandle(HttpServletRequest request,
HttpServletResponse response,
Object handler){
UserContextHolder.setUser(request.getHeader("X-User-Id"));
returntrue;
}
}6.2 批量操作優化
@Transactional
publicvoidbatchInsert(List<Order> orders){
// 提前獲取公共字段值
String user = getCurrentUser();
LocalDateTime now = LocalDateTime.now();
orders.forEach(order -> {
order.setCreateTime(now);
order.setCreateUser(user);
order.setUpdateTime(now);
order.setUpdateUser(user);
});
orderMapper.batchInsert(orders);
}七、監控與審計
7.1 審計日志集成
@EntityListeners(AuditingEntityListener.class)
publicclassBaseEntity{
@CreatedBy
private String createUser;
@LastModifiedBy
private String updateUser;
@CreatedDate
private LocalDateTime createTime;
@LastModifiedDate
private LocalDateTime updateTime;
}7.2 操作日志追蹤
@Aspect
@Component
publicclassOperationLogAspect{
@AfterReturning("@annotation(autoFill)")
publicvoidlogOperation(AutoFill autoFill){
LogEntry log = new LogEntry();
log.setOperator(getCurrentUser());
log.setOperationType(autoFill.value().name());
logService.save(log);
}
}結語： 通過本文的六種方案組合使用，我們在生產環境中實現了：
- 公共字段維護代碼量減少90%
- 相關Bug率下降75%
- 新功能開發效率提升40%
最佳實踐清單：
- 基礎字段使用MyBatis-Plus自動填充
- 復雜場景結合AOP處理
- 分布式環境集成唯一ID生成
- 重要操作添加審計日志
- 定期檢查字段填充策略
未來展望： 隨著Spring Data JPA的演進，未來可以探索與Reactive編程的結合，實現全鏈路的非阻塞式自動填充。
責任編輯：武曉燕
來源：
碼猿技術專欄
