在开发企业级应用时，分页查询是数据库操作中最常见的需求之一。随着数据量的增长，直接查询所有数据会导致性能问题，而分页查询能够有效减少内存压力、提升响应速度。Spring Boot 提供了强大的分页支持（如 Pageable 接口），但直接使用原始 API 可能导致代码重复、逻辑分散。本文将详细介绍如何通过封装通用工具类和接口，实现灵活、高效的分页查询功能，并结合实际场景优化性能。
一、分页查询的背景与必要性
在 Web 应用中，用户通常需要以分页形式查看数据（如商品列表、订单记录等）。若直接查询所有数据，可能导致：
- 性能瓶颈：数据库全表扫描耗时长，网络传输数据量大。
- 用户体验差：页面加载缓慢，甚至出现卡顿。
- 资源浪费：不必要的数据占用内存和带宽。
Spring Data JPA 提供了 Pageable 接口和 Page 对象，支持分页查询。但直接使用时，开发者需要为每个实体类编写重复的 Pageable 逻辑，导致代码冗余。通过封装分页查询功能，可以统一接口设计，提升开发效率。
二、Spring Data JPA 分页基础
Spring Data JPA 的分页核心是 Pageable 接口和 Page 接口：
Pageable：定义分页参数（页码、每页数量、排序字段）。Page：封装分页结果（当前页数据、总页数、总记录数）。
示例代码：
Page<User> users = userRepository.findAll(PageRequest.of(page, size, Sort.by("id")));但这种方式需要为每个实体类编写独立的 PageRequest，且无法处理复杂的查询条件。我们需要进一步封装。
三、封装通用分页工具类
1. 定义分页请求参数对象
创建一个通用的 PageRequest 类，封装用户请求的分页参数：
public class PageRequest {
private int page = 1; // 当前页（从1开始）
private int size = 10; // 每页数量
private String sortBy = "id"; // 排序列
private String sortDir = "asc";// 排序方向
// Getter 和 Setter 方法
}2. 创建分页查询工具类
通过 Pageable 和 Specification（动态查询条件）实现通用分页逻辑：
public class PageUtil {
public static <T> Page<T> buildPageableQuery(Specification<T> spec, PageRequest request, JpaRepository<T, Long> repository) {
int pageNumber = Math.max(1, request.getPage());
int pageSize = Math.min(100, Math.max(1, request.getSize())); // 限制最大分页大小
Sort sort = Sort.by(Sort.Direction.fromString(request.getSortDir()), request.getSortBy());
Pageable pageable = PageRequest.of(pageNumber - 1, pageSize, sort);
return repository.findAll(spec, pageable);
}
}3. 动态查询条件支持
使用 Specification 实现动态查询条件拼接（例如模糊搜索、范围查询）：
public static Specification<User> buildUserSpec(String name, Integer minAge) {
return (root, query, cb) -> {
List<Predicate> predicates = new ArrayList<>();
if (name != null) {
predicates.add(cb.like(root.get("name"), "%" + name + "%"));
}
if (minAge != null) {
predicates.add(cb.ge(root.get("age"), minAge));
}
return cb.and(predicates.toArray(new Predicate[0]));
};
}四、分页查询的接口设计
在 Controller 层，封装统一的分页接口，支持复杂查询条件：
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserRepository userRepository;
@GetMapping("/list")
public ResponseEntity<Page<User>> getUsers(
@RequestParam(required = false) String name,
@RequestParam(required = false) Integer minAge,
@Valid PageRequest request) {
Specification<User> spec = PageUtil.buildUserSpec(name, minAge);
Page<User> result = PageUtil.buildPageableQuery(spec, request, userRepository);
return ResponseEntity.ok(result);
}
}4. 响应结果格式优化
为统一返回格式，定义 PageResponse 类：
public class PageResponse<T> {
private List<T> data;
private int currentPage;
private int totalPages;
private long totalElements;
public PageResponse(Page<T> page) {
this.data = page.getContent();
this.currentPage = page.getNumber() + 1;
this.totalPages = page.getTotalPages();
this.totalElements = page.getTotalElements();
}
}五、性能优化与注意事项
- 避免 N+1 查询问题
使用@EntityGraph或JOIN FETCH显式指定关联字段加载，减少数据库查询次数。 - 分页大小限制
在工具类中限制size的最大值（如 100），防止恶意请求导致资源耗尽。 - 缓存高频查询
对于静态或低频更新的数据（如商品分类），可使用@Cacheable缓存分页结果。 - 异常处理
捕获Pageable参数异常（如负数页码），返回友好的错误提示。
六、实际应用场景示例
假设需要根据用户姓名和年龄范围查询用户列表，分页接口如下：
GET /users/list?name=Tom&minAge=20&page=1&size=20&sortBy=id&sortDir=desc通过封装的 PageUtil 工具类，只需定义 buildUserSpec 方法，即可快速实现动态查询和分页逻辑，无需重复编写 Pageable 处理代码。
七、总结
通过封装分页查询工具类，开发者可以：
- 减少重复代码：统一处理分页参数、动态查询条件。
- 提升灵活性：支持复杂查询和多表关联。
- 增强可维护性：修改分页逻辑时只需调整工具类，无需改动业务代码。
在实际项目中，建议结合缓存、性能监控等技术进一步优化分页查询效率，确保系统在高并发场景下的稳定性。
