如何复用Spring Data MongoDB现有查询并实现链式调用？

阿华AIGC实验室

2026-6-13

问题背景

现有Spring Data MongoDB的Repository定义如下：

package foo.bar;

import java.util.List;
import java.util.UUID;

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.data.mongodb.repository.Query;

public interface MyRepository extends MongoRepository<MyObject, UUID> {

    @Query("{ $or: [ "
            + "{ '_id': ?0 },"
            + "{ 'someField1': ?0 },"
            + "{ 'someField2': ?0 },"
            // 省略其余约20个字段...
            + " ] }")
    Page<MyObject> findAllBySearchTerm(String search, Pageable pageable);

    @Query("{'date' : { $gte: ?0, $lte: ?1 } }")
    List<MyObject> findObjectByDateIso(String from, String to);
}

其中findAllBySearchTerm实现多字段匹配搜索，findObjectByDateIso实现日期范围过滤，二者单独使用均正常。现在需要同时应用这两个查询逻辑，希望复用现有查询逻辑实现动态组合，而非编写第三个硬编码的组合查询——后续可能新增类似查询，要避免大量重复的组合查询定义。

可行解决方案

1. 用Querydsl构建可复用的动态查询

这是最适合长期扩展的方案，能把各个查询逻辑封装成独立片段，按需组合。

操作步骤：

确保项目引入Querydsl MongoDB依赖
封装独立的查询逻辑片段：

// 多字段搜索的Predicate封装
public Predicate buildSearchPredicate(String search) {
    QMyObject qObj = QMyObject.myObject;
    return qObj._id.eq(search)
            .or(qObj.someField1.eq(search))
            .or(qObj.someField2.eq(search))
            // 依次添加其余20个字段的匹配条件
            ;
}

// 日期范围过滤的Predicate封装
public Predicate buildDateRangePredicate(String from, String to) {
    QMyObject qObj = QMyObject.myObject;
    return qObj.date.goe(from).and(qObj.date.loe(to));
}

修改Repository接口，继承QuerydslPredicateExecutor：

public interface MyRepository extends MongoRepository<MyObject, UUID>, QuerydslPredicateExecutor<MyObject> {
    // 原有@Query方法可保留，也可逐步迁移到Querydsl实现
}

业务层按需组合查询：

public Page<MyObject> searchWithDateRange(String search, String from, String to, Pageable pageable) {
    Predicate searchPred = buildSearchPredicate(search);
    Predicate datePred = buildDateRangePredicate(from, to);
    // 组合两个查询条件
    Predicate combined = searchPred.and(datePred);
    return myRepository.findAll(combined, pageable);
}

后续新增查询条件时，只需要新增对应的Predicate封装方法，组合时直接拼接即可，完全避免重复写硬编码的组合查询。

2. 用MongoTemplate的Criteria API实现逻辑复用

如果不想引入Querydsl依赖，也可以用Spring Data自带的Criteria API来实现：

// 封装多字段搜索的Criteria
public Criteria buildSearchCriteria(String search) {
    return new Criteria().orOperator(
            Criteria.where("_id").is(search),
            Criteria.where("someField1").is(search),
            Criteria.where("someField2").is(search)
            // 添加其余字段的匹配条件
    );
}

// 封装日期范围的Criteria
public Criteria buildDateRangeCriteria(String from, String to) {
    return Criteria.where("date").gte(from).lte(to);
}

// 组合查询并返回分页结果
public Page<MyObject> searchWithDateRange(String search, String from, String to, Pageable pageable) {
    Criteria combined = new Criteria().andOperator(
            buildSearchCriteria(search),
            buildDateRangeCriteria(from, to)
    );
    Query query = new Query(combined).with(pageable);
    
    long total = mongoTemplate.count(query, MyObject.class);
    List<MyObject> content = mongoTemplate.find(query, MyObject.class);
    return new PageImpl<>(content, pageable, total);
}

这种方式无需额外依赖，直接用原生API就能实现查询逻辑的复用和动态组合。