前言

在当今的互联网软件开发领域，处理海量数据是一个绕不开的话题。想象一下，你开发的应用程序需要展示数以万计甚至更多的用户信息、商品列表或者文章内容，如果一次性将所有数据加载到前端，不仅会严重拖慢系统响应速度，还可能导致应用程序崩溃。这时候，分页操作就如同救星一般登场，它能将数据合理地分段展示，大大提升用户体验和系统性能。今天，咱们就深入探讨在 Spring Boot3 中如何巧妙实现分页操作。

为什么要使用分页

在现代 Web 应用开发的大环境下，分页和排序已然成为处理海量数据时，提升用户体验与系统性能的关键所在。它们宛如一对默契的搭档，广泛应用于 RESTful API、后台管理系统等诸多场景。据 2024 年 Stack Overflow 开发者调查显示，约 60% 的后端开发者在处理列表数据时会使用分页技术。就拿常见的电商平台商品展示页面来说，当用户搜索 “运动鞋”，可能会出现成千上万条结果，如果不分页，用户不仅要等待漫长的加载时间，而且面对满屏密密麻麻的数据，也会无从下手。分页操作通过将数据按页划分，每次仅 #程序员 #后端 #Java加载部分数据，极大地减轻了数据库和服务器的负载压力，让用户能够更高效地浏览数据。

Spring Boot3 实现分页的方式

（一）基于 Spring Data JPA 的分页

Spring Data JPA 为 Java 开发者提供了极为便捷的方式来实现数据访问层。在分页方面，它主要通过 Pageable 接口来达成。Pageable 接口可谓是分页操作的核心枢纽，它包含了页码、每页大小以及排序信息，能够生成 LIMIT、OFFSET 和 ORDER BY 语句，从而精准地控制查询结果。例如：

Pageable pageable = PageRequest.of(pageNumber, pageSize, Sort.by(Sort.Direction.ASC, "id"));
Page<User> users = userRepository.findAll(pageable);

这里通过 PageRequest.of 方法创建了 Pageable 实例，指定了当前页码 pageNumber、每页大小 pageSize 以及排序方式（按照 id 字段升序排列）。然后，调用 userRepository 的 findAll 方法，并传入 Pageable 实例，即可轻松获取分页后的用户数据。Page 对象会返回分页结果，其中包含了内容（content）、分页信息（pageable）以及总数（totalElements），为开发者提供了全面的分页数据。

（二）基于 MyBatis – Plus 的分页

MyBatis – Plus 是在 MyBatis 基础上进行增强的工具，它简化了 MyBatis 的开发流程，在分页功能上更是表现出色。实现分页操作，第一需要引入 pagehelper – spring – boot – starter 依赖。

<dependency>

<groupId>com.github.pagehelper</groupId>

<artifactId>pagehelper - spring - boot - starter</artifactId>

<version>最新版本</version>

</dependency>

配置完成后，在代码中使用 PageHelper 插件进行分页操作，简直易如反掌。例如：

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;

@Override public List<User> queryUserListPaged(SysUser user, Integer page, Integer pageSize) { // 开始分页 PageHelper.startPage(page, pageSize); Example example = new Example(SysUser.class); Example.Criteria criteria = example.createCriteria(); if (!StringUtils.isEmptyOrWhitespace(user.getUsername())) { criteria.andLike("username", "%" + user.getUsername() + "%"); } if (!StringUtils.isEmptyOrWhitespace(user.getNickname())) { criteria.andLike("nickname", "%" + user.getNickname() + "%"); } List<User> userList = userMapper.selectByExample(example); return userList; } }

在上述代码中，关键的一行代码 PageHelper.startPage(page, pageSize)就标识着分页操作的开始。PageHelper 插件会通过其内部强劲的拦截器，将原本的查询 SQL 语句巧妙地转化为分页 SQL 语句，从而实现高效的分页查询。不过，需要特别注意的是，PageHelper.startPage(pageNum, pageSize)方法必定要紧贴在列表查询方法之前调用，只有这样，在查询时才能准确查出相应的数据量，并且同时查询出数据总数。

分页实现的详细步骤与代码示例

（一）基于 Spring Data JPA 的完整示例

创建实体类

假设我们有一个 User 实体类，用于表明用户信息。

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String email;
    // 其他字段及Getter、Setter方法省略
}

创建 Repository 接口

继承 JpaRepository，Spring Data JPA 会自动为我们实现基本的数据访问方法，包括分页查询相关方法。

public interface UserRepository extends JpaRepository<User, Long> {
}

在 Service 层实现分页查询

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

public Page<User> getUsers(int pageNumber, int pageSize) { Pageable pageable = PageRequest.of(pageNumber, pageSize, Sort.by(Sort.Direction.ASC, "id")); return userRepository.findAll(pageable); } }

在 Controller 层暴露接口

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;

@GetMapping public Page<User> getUsers(@RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "10") int size) { return userService.getUsers(page, size); } }

此时，访问/users?page=0&size=10，就可以获取到第一页，每页 10 条数据的用户列表。

基于 MyBatis – Plus 的完整示例

创建实体类

同样是 User 实体类，与 Spring Data JPA 示例中的实体类类似。

public class User {
    private Long id;
    private String username;
    private String email;
    // 其他字段及Getter、Setter方法省略
}

创建 Mapper 接口

@Mapper
public interface UserMapper extends BaseMapper<User> {
}

在 Service 层实现分页查询

前文已经展示过该部分代码，通过 PageHelper.startPage 方法开启分页，然后执行查询逻辑。

在 Controller 层暴露接口

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;

@GetMapping("/paged") public JSONResult queryUserListPaged(@RequestParam(required = false, defaultValue = "1") Integer page) { int pageSize = 10; SysUser user = new SysUser(); List<User> userList = userService.queryUserListPaged(user, page, pageSize); return JSONResult.ok(userList); } }

访问/users/paged?page=1，即可获取到使用 MyBatis – Plus 分页后的用户列表数据。

分页操作中的性能优化与注意事项

（一）性能优化

合理设置每页数据量 ：如果每页数据量设置过大，会增加单次查询的数据量，影响查询速度；如果设置过小，会导致频繁查询数据库，同样降低性能。一般来说，需要根据实际业务场景和数据量大小，经过测试来确定一个合适的每页数据量，例如常见的 10 条、20 条或 50 条。

使用索引 ：对常常用于排序和分页的字段添加索引，可以显著提升查询速度。列如在基于 Spring Data JPA 的分页中，如果按照 id 字段进行排序和分页，确保 id 字段上有索引。在 MySQL 中，可以使用 CREATE INDEX 语句来创建索引。

避免全表扫描 ：在编写查询语句时，要尽量避免使用 SELECT *，而是明确指定需要查询的字段。这样可以减少数据传输量，提高查询效率。同时，合理使用查询条件，缩小查询范围，避免对整个表进行扫描。

（二）注意事项

调用顺序 ：在使用 MyBatis – Plus 的 PageHelper 插件时，startPage()方法必须紧贴在查询方法之前调用，否则分页将无法生效。这是由于 PageHelper 是通过拦截器机制来实现分页的，只有正确的调用顺序才能确保拦截器准确地对查询 SQL 进行改写。

线程安全 ：在异步或多线程场景下，使用 PageHelper 时需要特别注意线程安全问题。由于 PageHelper 内部依赖 ThreadLocal 来传递分页参数，如果在多线程环境下使用不当，可能会导致参数混乱，影响分页结果。此时，可能需要手动传递分页参数，以确保每个线程的分页操作独立且正确。

处理空页和越界 ：在返回分页结果时，需要思考到空页（即查询结果为空）和越界（请求的页码超出了实际的页码范围）的情况。对于空页，应返回一个合适的提示信息，而不是让前端显示空白页面；对于越界情况，一般应返回最后一页的数据，或者给出明确的错误提示，告知用户请求的页码无效。

动态排序的实现

在实际业务中，除了分页，动态排序也是超级常见的需求。用户可能希望根据不同的字段，如创建时间、价格、评论数量等对数据进行排序。在 Spring Boot3 中，基于 Spring Data JPA 和 MyBatis – Plus 都能轻松实现动态排序。

（一）基于 Spring Data JPA 的动态排序

通过 Sort 对象或 Pageable 的排序参数可以支持动态排序。例如，我们希望按照用户的 email 字段进行降序排序，可以这样实现：

Sort sort = Sort.by(Sort.Direction.DESC, "email");
Pageable pageable = PageRequest.of(pageNumber, pageSize, sort);
Page<User> users = userRepository.findAll(pageable);

这里通过 Sort.by 方法创建了一个按照 email 字段降序排列的 Sort 对象，然后将其应用到 Pageable 实例中，最终在查询时实现了动态排序。

（二）基于 MyBatis – Plus 的动态排序

在 MyBatis – Plus 中，同样可以通过在 PageHelper.startPage 方法之后，对查询条件进行动态排序设置。假设我们有一个根据用户输入的排序字段和排序方向进行排序的需求，可以这样实现：

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;

@Override public List<User> queryUserListPaged(SysUser user, Integer page, Integer pageSize, String sortField, String sortDirection) { PageHelper.startPage(page, pageSize); QueryWrapper<User> wrapper = new QueryWrapper<>(); if (!StringUtils.isEmpty(sortField) &&!StringUtils.isEmpty(sortDirection)) { wrapper.orderBy(true, "asc".equalsIgnoreCase(sortDirection), sortField); } if (!StringUtils.isEmptyOrWhitespace(user.getUsername())) { wrapper.like("username", "%" + user.getUsername() + "%"); } if (!StringUtils.isEmptyOrWhitespace(user.getNickname())) { wrapper.like("nickname", "%" + user.getNickname() + "%"); } List<User> userList = userMapper.selectList(wrapper); return userList; } }

在上述代码中，通过 QueryWrapper 的 orderBy 方法，根据传入的 sortField 和 sortDirection 参数实现了动态排序功能。

总结

在 Spring Boot3 中实现分页操作，无论是基于 Spring Data JPA 还是 MyBatis – Plus，都为开发者提供了强劲且便捷的工具。通过合理运用这些技术，能够有效地处理海量数据，提升应用程序的性能和用户体验。在实际开发过程中，要根据项目的具体需求、数据库类型以及团队技术栈等因素，选择合适的分页实现方式，并注重性能优化和各种注意事项。希望本文能为各位互联网软件开发人员在 Spring Boot3 分页操作的学习和实践中提供全面而有效的协助，让大家在开发之路上游刃有余。如果你在实际操作中有任何疑问或心得，欢迎在评论区留言分享，咱们一起探讨进步。

文章版权归作者所有，未经允许请勿转载。如内容涉嫌侵权，请在本页底部进入<联系我们>进行举报投诉!

THE END