如何在Spring Boot Data REST中自定义列表接口的数据过滤？

下面提供几种无需使用@RestController，直接通过Spring Boot Data REST实现自定义条件返回数据的方案：

方案1：用@Query覆盖默认findAll方法（简单固定条件） #

直接在ExerciseRepository中覆盖默认的findAll方法，通过@Query指定自定义查询条件，替换默认的全量查询行为。

@RepositoryRestResource
public interface ExerciseRepository extends JpaRepository<Exercise, Integer> {

    // 覆盖默认的/exercises端点，返回id<100的Exercise数据
    @Override
    @RestResource(path = "", rel = "exercises")
    @Query("SELECT e FROM Exercise e WHERE e.id < 100")
    List<Exercise> findAll();
}

访问127.0.0.1/exercises时，会自动执行定义的查询逻辑，返回符合条件的数据。如果需要更复杂的JPQL条件（比如多表关联、多条件组合），直接修改@Query中的语句即可。

方案2：自定义Repository实现类（复杂业务逻辑） #

如果查询逻辑涉及外部服务调用、复杂运算等无法用JPQL表达的场景，可以通过自定义Repository实现类扩展：

1. 定义自定义扩展接口

public interface ExerciseRepositoryCustom {
    List<Exercise> findCustomExercises();
}

2. 实现扩展接口（命名规则：主Repository名+Impl）

@Repository
public class ExerciseRepositoryImpl implements ExerciseRepositoryCustom {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List<Exercise> findCustomExercises() {
        // 编写复杂业务逻辑，比如多表查询、调用其他服务等
        String jpql = "SELECT e FROM Exercise e WHERE e.id < 100 AND e.status = 'ACTIVE'";
        return entityManager.createQuery(jpql, Exercise.class).getResultList();
    }
}

3. 让主Repository继承自定义接口并覆盖findAll

@RepositoryRestResource
public interface ExerciseRepository extends JpaRepository<Exercise, Integer>, ExerciseRepositoryCustom {

    @Override
    @RestResource(path = "", rel = "exercises")
    default List<Exercise> findAll() {
        return findCustomExercises();
    }
}

方案3：用RepositoryRestController完全控制端点（需自定义响应/请求处理） #

如果需要完全控制请求参数解析、响应结构，可以使用@RepositoryRestController覆盖默认端点，它会保留Spring Data REST的HAL响应格式，比普通@RestController更贴合Data REST生态：

@RepositoryRestController
@RequestMapping("/exercises")
public class ExerciseCustomController {

    private final ExerciseRepository exerciseRepository;

    // 构造注入Repository
    public ExerciseCustomController(ExerciseRepository exerciseRepository) {
        this.exerciseRepository = exerciseRepository;
    }

    @GetMapping
    public ResponseEntity<CollectionModel<Exercise>> getCustomExercises() {
        // 执行自定义条件查询
        List<Exercise> exercises = exerciseRepository.findAll(Specification.where(
            (root, query, cb) -> cb.lessThan(root.get("id"), 100)
        ));
        // 包装成符合Spring Data REST规范的响应格式
        CollectionModel<Exercise> response = CollectionModel.of(exercises);
        return ResponseEntity.ok(response);
    }
}

方案4：使用Specification动态条件（支持灵活组合条件） #

如果需要支持动态条件组合，可以让Repository继承JpaSpecificationExecutor，通过Specification构建查询条件：

@RepositoryRestResource
public interface ExerciseRepository extends JpaRepository<Exercise, Integer>, JpaSpecificationExecutor<Exercise> {

    @Override
    @RestResource(path = "", rel = "exercises")
    default List<Exercise> findAll() {
        // 构建自定义条件组合
        Specification<Exercise> spec = (root, query, criteriaBuilder) -> {
            Predicate idCondition = criteriaBuilder.lessThan(root.get("id"), 100);
            Predicate statusCondition = criteriaBuilder.equal(root.get("status"), "ACTIVE");
            return criteriaBuilder.and(idCondition, statusCondition);
        };
        return findAll(spec);
    }
}

内容的提问来源于stack exchange，提问作者Tony.Luo