设计通用 CRUD 框架：BaseServiceImpl 的实现与思考

// system 模块
public void createUser(UserDTO dto) {
    validator.validate(dto);
    UserEntity entity = userConverter.dtoToEntity(dto);
    if (!userMapper.insert(entity)) {
        throw new RuntimeException("保存失败");
    }
}

// article 模块（几乎一样的代码）
public void createArticle(ArticleDTO dto) {
    validator.validate(dto);
    ArticleEntity entity = articleConverter.dtoToEntity(dto);
    if (!articleMapper.insert(entity)) {
        throw new RuntimeException("保存失败");
    }
}

public abstract class BaseServiceImpl<
    M extends BaseMapper<E>,   // Mapper 类型
    E,                          // Entity 类型
    V,                          // VO 类型（响应）
    D extends Identifiable<?>, // DTO 类型（请求，需包含 id）
    C extends BaseConverter<D, E, V>  // MapStruct 转换器
> extends ServiceImpl<M, E> implements IBaseService<E, V, D> {

@Transactional(rollbackFor = Exception.class)
public Serializable saveByDto(D dto) {
    validate(dto);                    // 1. JSR-303 参数校验
    E entity = converter.dtoToEntity(dto);  // 2. MapStruct 转换
    preSave(entity);                  // 3. 预保存钩子（子类可重写）
    if (!this.save(entity)) {
        throw new OperationFailedException("实体保存失败", entity);
    }
    return getEntityId(entity);       // 4. 通过反射返回主键
}

@Transactional(rollbackFor = Exception.class)
public boolean updateByDto(D dto) {
    validate(dto);
    Serializable id = dto.getId();
    Assert.notNull(id, "更新失败：无法从 DTO 中获取主键 ID");

    // 关键第一步：先从数据库加载完整 Entity
    E entity = this.getById(id);
    if (entity == null) {
        throw new EntityNotFoundException(this.getEntityClass().getSimpleName(), id);
    }

    // 关键第二步：只把 DTO 中的非 null 字段更新到 Entity（增量更新）
    converter.updateEntityFromDto(dto, entity);

    preUpdate(entity);  // 预更新钩子
    boolean success = this.updateById(entity);
    if (!success) {
        // 可能是乐观锁 @Version 冲突
        throw new OperationFailedException("实体更新失败，可能存在数据冲突", dto);
    }
    return true;
}

// BaseConverter 接口
public interface BaseConverter<D, E, V> {
    E dtoToEntity(D dto);
    V entityToVo(E entity);
    // 关键：将 DTO 的非 null 字段合并到已存在的 Entity 上
    void updateEntityFromDto(D dto, @MappingTarget E entity);
}

// 子类可选择重写
protected void preSave(E entity) {
    // 默认空实现
}

protected void preUpdate(E entity) {
    // 默认空实现  
}

// ArticleServiceImpl.java
@Override
protected void preSave(ArticleEntity entity) {
    // 1. 没有封面图时，自动填充必应每日壁纸
    if (StringUtils.isBlank(entity.getCoverImage())) {
        String bingWallpaper = bingWallpaperService.getRandomWallpaper();
        entity.setCoverImage(bingWallpaper);
    }

    // 2. 默认状态设为草稿
    if (entity.getStatus() == null) {
        entity.setStatus(ArticleStatus.DRAFT.getCode());
    }

    // 3. 从 SecurityContext 获取当前用户 ID 作为作者
    Long currentUserId = SecurityUtils.getCurrentUserId();
    entity.setAuthorId(currentUserId);

    // 4. 责任链模式处理内容（XSS过滤 → Markdown转HTML → 生成目录 → 提取摘要）
    ProcessResult result = contentProcessorChain.process(new ProcessResult(entity.getContent()));
    entity.setContentHtml(result.getHtml());
    entity.setTocJson(result.getTocJson());
    entity.setSummary(result.getSummary());
}

XssFilterProcessor → MarkdownProcessor → TocProcessor → SummaryProcessor

protected Serializable getEntityId(E entity) {
    TableInfo tableInfo = TableInfoHelper.getTableInfo(this.getEntityClass());
    // 通过 MP 的元数据反射获取主键值，无需知道字段名
    return (Serializable) tableInfo.getPropertyValue(entity, tableInfo.getKeyProperty());
}

@Service
public class ArticleServiceImpl
    extends BaseServiceImpl<ArticleMapper, ArticleEntity, ArticleDetailVO, ArticleDTO, ArticleConverter>
    implements IArticleService {

    public ArticleServiceImpl(ArticleConverter converter, ...) {
        super(converter);  // 传入 MapStruct 转换器
        // 其他依赖注入 ...
    }
    // 立刻获得全套 CRUD 能力，只需关注业务特有逻辑
}