公共字段自動填充的六種神技，開發(fā)效率翻倍！

2025-05-27 01:44:00

本文將分享一套經(jīng)過生產(chǎn)驗證的自動化方案，涵蓋MyBatis-Plus、AOP、JWT等六種核心策略，助你徹底擺脫公共字段維護的煩惱。

在開發(fā)外賣系統(tǒng)訂單模塊時，我發(fā)現(xiàn)每個實體類都包含create_time、update_by等重復字段。手動維護這些字段不僅效率低下，還容易出錯。

本文將分享一套經(jīng)過生產(chǎn)驗證的自動化方案，涵蓋MyBatis-Plus、AOP、JWT等六種核心策略，助你徹底擺脫公共字段維護的煩惱。

一、痛點分析：公共字段維護的三大困境

1.1 典型問題場景

// 訂單創(chuàng)建邏輯
publicvoidcreateOrder(OrderDTO dto){
    Order order = convertToEntity(dto);
    
    // 手動設(shè)置公共字段
    order.setCreateTime(LocalDateTime.now());
    order.setUpdateTime(LocalDateTime.now());
    order.setCreateUser(getCurrentUser());
    order.setUpdateUser(getCurrentUser());
    
    orderMapper.insert(order);
}

// 訂單更新邏輯 
publicvoidupdateOrder(OrderDTO dto){
    Order order = convertToEntity(dto);
    
    // 重復設(shè)置邏輯
    order.setUpdateTime(LocalDateTime.now());
    order.setUpdateUser(getCurrentUser());
    
    orderMapper.updateById(order);
}

痛點總結(jié)：

代碼重復率高（每個Service方法都要設(shè)置）
維護成本高（字段變更需修改多處）
容易遺漏（特別是更新操作）

二、基礎(chǔ)方案：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{
    // 業(yè)務(wù)字段...
}

三、進階方案：AOP統(tǒng)一處理

3.1 自定義注解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public@interface AutoFill {
    OperationType value();
}

publicenum OperationType {
    INSERT,
    UPDATE
}

3.2 切面實現(xiàn)

@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);
    }
    
    // 獲取當前用戶（支持多線程環(huán)境）
    private String getCurrentUser(){
        return Optional.ofNullable(RequestContextHolder.getRequestAttributes())
                      .map(attrs -> (ServletRequestAttributes) attrs)
                      .map(ServletRequestAttributes::getRequest)
                      .map(req -> req.getHeader("X-User-Id"))
                      .orElse("system");
    }
}

四、生產(chǎn)環(huán)境最佳實踐

4.1 多數(shù)據(jù)源適配

@Configuration
publicclassDataSourceConfig{
    
    @Bean
    @ConfigurationProperties("spring.datasource.master")
    public DataSource masterDataSource(){
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    public MetaObjectHandler metaObjectHandler(){
        returnnew MultiDataSourceAutoFillHandler();
    }
}

publicclassMultiDataSourceAutoFillHandlerextendsMetaObjectHandler{
    // 根據(jù)當前數(shù)據(jù)源動態(tài)處理
}

4.2 分布式ID生成

publicclassSnowflakeIdGenerator{
    // 實現(xiàn)分布式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;

六、性能優(yōu)化方案

6.1 緩存當前用戶信息

publicclassUserContextHolder{
    privatestaticfinal ThreadLocal<String> userHolder = new ThreadLocal<>();
    
    publicstaticvoidsetUser(String user){
        userHolder.set(user);
    }
    
    publicstatic String getUser(){
        return userHolder.get();
    }
    
    publicstaticvoidclear(){
        userHolder.remove();
    }
}

// 在攔截器中設(shè)置
publicclassUserInterceptorimplementsHandlerInterceptor{
    @Override
    publicbooleanpreHandle(HttpServletRequest request, 
                            HttpServletResponse response, 
                            Object handler){
        UserContextHolder.setUser(request.getHeader("X-User-Id"));
        returntrue;
    }
}

6.2 批量操作優(yōu)化

@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);
}

七、監(jiān)控與審計

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);
    }
}

結(jié)語： 通過本文的六種方案組合使用，我們在生產(chǎn)環(huán)境中實現(xiàn)了：

公共字段維護代碼量減少90%
相關(guān)Bug率下降75%
新功能開發(fā)效率提升40%

最佳實踐清單：

基礎(chǔ)字段使用MyBatis-Plus自動填充
復雜場景結(jié)合AOP處理
分布式環(huán)境集成唯一ID生成
重要操作添加審計日志
定期檢查字段填充策略

未來展望： 隨著Spring Data JPA的演進，未來可以探索與Reactive編程的結(jié)合，實現(xiàn)全鏈路的非阻塞式自動填充。

責任編輯：武曉燕來源：碼猿技術(shù)專欄

公共字段開發(fā)

成人免费xxxxx在线视频软件_久久精品久久久_亚洲国产精品久久久_天天色天天色_亚洲人成一区_欧美一级欧美三级在线观看