Java抽象CrudService结合DTO模式的困惑：如何实现抽象映射器？

一、抽象CrudService的设计合理性 #

你的抽象CrudService设计是合理的，属于通用CRUD逻辑的有效抽象，能大幅减少重复代码。但要把握好使用边界：

• 不要强制所有实体都继承该类，对于存在特殊业务逻辑（比如创建后触发消息通知、复杂参数校验）的实体，单独编写具体服务类更贴合业务需求；
• 通用CRUD仅适配简单场景，当某个实体需要额外业务操作时，在具体服务类中扩展方法即可，无需修改抽象类本身。

二、抽象映射器的实现思路 #

完全可以编写抽象映射器，核心是定义通用转换模板，让具体映射器基于业务需求实现或扩展。

1. 抽象映射器示例 #

public abstract class AbstractMapper<E extends EntityWithId<ID>, DTO, ID> {
    // 实体转DTO的抽象方法，由子类实现具体映射逻辑
    public abstract DTO toDto(E entity);
    // DTO转实体的抽象方法，由子类实现具体映射逻辑
    public abstract E toEntity(DTO dto);
    
    // 批量实体转DTO的默认实现，无需子类重复编写
    public List<DTO> toDtoList(List<E> entities) {
        return entities.stream()
                .map(this::toDto)
                .collect(Collectors.toList());
    }
    
    // 批量DTO转实体的默认实现，无需子类重复编写
    public List<E> toEntityList(List<DTO> dtos) {
        return dtos.stream()
                .map(this::toEntity)
                .collect(Collectors.toList());
    }
}

2. 具体映射器示例 #

以User实体和UserDTO为例，编写具体映射逻辑：

@Component
public class UserMapper extends AbstractMapper<User, UserDTO, Long> {
    @Override
    public UserDTO toDto(User user) {
        UserDTO dto = new UserDTO();
        dto.setId(user.getId());
        dto.setUsername(user.getUsername());
        dto.setEmail(user.getEmail());
        // 根据业务需求补充其他字段映射
        return dto;
    }

    @Override
    public User toEntity(UserDTO dto) {
        User user = new User();
        user.setId(dto.getId());
        user.setUsername(dto.getUsername());
        user.setEmail(dto.getEmail());
        // 根据业务需求补充其他字段映射
        return user;
    }
}

3. 结合抽象CrudService使用 #

可以扩展抽象CrudService，引入映射器，提供基于DTO的通用业务方法：

public abstract class CrudService<E extends EntityWithId<ID>, ID, R extends JpaRepository<E,ID>, DTO> {
    protected R repository;
    protected AbstractMapper<E, DTO, ID> mapper;

    public CrudService(R repository, AbstractMapper<E, DTO, ID> mapper) {
        this.repository = repository;
        this.mapper = mapper;
    }

    // 基于DTO的创建方法
    public ID create(DTO dto) {
        E entity = mapper.toEntity(dto);
        return repository.save(entity).getId();
    }

    // 基于DTO的批量查询方法
    public List<DTO> readAll() {
        return mapper.toDtoList(repository.findAll());
    }

    // 基于DTO的单条查询方法
    public Optional<DTO> readByIdDto(ID id) {
        return repository.findById(id).map(mapper::toDto);
    }

    // 保留原有实体查询方法，供特殊业务场景使用
    public Optional<E> readById(ID id) {
        return repository.findById(id);
    }

    // 基于DTO的更新方法
    public boolean update(DTO dto) {
        E entity = mapper.toEntity(dto);
        if(!repository.existsById(entity.getId())){
            return false;
        }
        repository.save(entity);
        return true;
    }

    public boolean delete(ID id) {
        if(!repository.existsById(id)){
            return false;
        }
        repository.deleteById(id);
        return true;
    }
}

三、总结建议 #

• 保留抽象CrudService作为通用基础，有特殊业务需求的实体编写具体服务类继承它，按需扩展业务方法；
• 抽象映射器值得实现，能统一DTO与实体的转换逻辑，避免重复编写映射代码；
• 如果项目使用MapStruct等映射工具，也可结合抽象类进一步简化实现，无需手动编写字段映射逻辑。

内容的提问来源于stack exchange，提问作者Pavlo Shevchyk