如何避免Spring Repository<T, ID>向服务层泄露持久化信息

问题1：能否通过转换器/回调实现透明的模型-文档转换？ #

直接让MongoRepository<MyModel, UUID>生效是不可行的——Spring Data MongoDB要求Repository的泛型实体类必须是带有@Document、@Id等元注解的持久化实体（即你的MyDocument），Mongo映射上下文无法识别非标注的MyModel作为持久化目标。

但可以通过自定义Repository实现封装转换逻辑，让服务层完全感知不到MyDocument的存在：

1. 定义面向服务层的Repository接口，只暴露返回MyModel的方法：

interface MyRepository {
    Optional<MyModel> findById(UUID id);
    MyModel save(MyModel model);
    // 按需添加其他CRUD方法
}

2. 实现该接口，内部依赖原生MongoRepository<MyDocument, String>和转换器完成转换：

@Repository
class MyRepositoryImpl implements MyRepository {

    private final MongoRepository<MyDocument, String> mongoRepo;
    private final Converter<MyDocument, MyModel> docToModelConverter;
    private final Converter<MyModel, MyDocument> modelToDocConverter;
    private final Converter<UUID, String> idConverter;

    // 构造注入所有依赖
    public MyRepositoryImpl(MongoRepository<MyDocument, String> mongoRepo,
                            Converter<MyDocument, MyModel> docToModelConverter,
                            Converter<MyModel, MyDocument> modelToDocConverter,
                            Converter<UUID, String> idConverter) {
        this.mongoRepo = mongoRepo;
        this.docToModelConverter = docToModelConverter;
        this.modelToDocConverter = modelToDocConverter;
        this.idConverter = idConverter;
    }

    @Override
    public Optional<MyModel> findById(UUID id) {
        String docId = idConverter.convert(id);
        return mongoRepo.findById(docId)
                .map(docToModelConverter::convert);
    }

    @Override
    public MyModel save(MyModel model) {
        MyDocument doc = modelToDocConverter.convert(model);
        MyDocument savedDoc = mongoRepo.save(doc);
        return docToModelConverter.convert(savedDoc);
    }
}

3. 注册自定义转换器（通过配置类）：

@Configuration
class ConversionConfig {

    @Bean
    public Converter<MyDocument, MyModel> docToModelConverter() {
        return doc -> {
            MyModel model = new MyModel();
            model.setId(UUID.fromString(doc.getId()));
            // 补充其他属性的转换逻辑
            return model;
        };
    }

    @Bean
    public Converter<MyModel, MyDocument> modelToDocConverter() {
        return model -> {
            MyDocument doc = new MyDocument();
            doc.setId(model.getId().toString());
            // 补充其他属性的转换逻辑
            return doc;
        };
    }

    @Bean
    public Converter<UUID, String> idConverter() {
        return UUID::toString;
    }
}

这样服务层注入的MyRepository只会返回MyModel，完全隔离了持久化层的MyDocument细节。

问题2：服务层与持久化层解耦的替代方案 #

如果不想自定义Repository实现，还有以下几种成熟的解耦方式：

1. 引入DAO层封装转换逻辑 #

在Repository之上新增数据访问层（DAO），服务层仅依赖DAO，DAO内部调用MongoRepository并完成模型转换：

@Service
class MyDao {
    private final MongoRepository<MyDocument, String> mongoRepo;
    private final Converter<MyDocument, MyModel> docToModelConverter;

    // 构造注入依赖
    public MyDao(MongoRepository<MyDocument, String> mongoRepo, Converter<MyDocument, MyModel> docToModelConverter) {
        this.mongoRepo = mongoRepo;
        this.docToModelConverter = docToModelConverter;
    }

    public Optional<MyModel> getById(UUID id) {
        return mongoRepo.findById(id.toString())
                .map(docToModelConverter::convert);
    }
}

2. 用MapStruct简化转换代码 #

如果属性转换逻辑复杂，使用MapStruct自动生成转换器代码，避免手动编写重复的转换逻辑：

@Mapper(componentModel = "spring")
public interface MyModelMapper {
    MyModelMapper INSTANCE = Mappers.getMapper(MyModelMapper.class);

    @Mapping(source = "id", target = "id", qualifiedByName = "stringToUuid")
    MyModel docToModel(MyDocument doc);

    @Mapping(source = "id", target = "id", qualifiedByName = "uuidToString")
    MyDocument modelToDoc(MyModel model);

    @Named("stringToUuid")
    default UUID stringToUuid(String id) {
        return UUID.fromString(id);
    }

    @Named("uuidToString")
    default String uuidToString(UUID id) {
        return id.toString();
    }
}

之后在Repository实现或DAO中直接注入MyModelMapper即可使用。

3. 严格隔离Repository的暴露范围 #

永远不要让服务层直接依赖MongoRepository，始终定义业务导向的接口（如上述的MyRepository或MyDao），确保服务层只接触领域模型（MyModel），完全隔离持久化层的schema细节。

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