PageHelper的分页查询：对比传统分页方法并详解实现步骤

        欢迎阅读我的博客！今天我们将介绍一种在Java项目中常用的分页插件：PageHelper。在这篇文章中，我们将解释PageHelper与传统分页方法的区别，并通过一个具体的实例来解释如何使用PageHelper进行分页查询。

 

一、PageHelper与传统分页的区别

        在Java Web项目中，常见的分页方式是通过SQL语句的limit关键字来实现。比如我们需要查询第10页的数据，每页显示20条，那么我们的SQL语句可能是这样的：

SELECT * FROM table LIMIT 180, 20

        这种分页方式的缺点是需要手动计算起始的索引，且对于不同的数据库，分页的SQL语句可能会有所不同。

        PageHelper是一个开源的MyBatis分页插件，它对分页的查询过程进行了封装，使得分页查询变得更为简单。你只需要传递页码和每页的大小，PageHelper会自动计算SQL语句中的limit参数。

        此外，PageHelper还提供了一些其他的功能，例如返回查询结果的总记录数，这在很多时候都非常有用。
 

二、PageHelper具体实现例子

        以下是一个使用PageHelper进行分页查询的例子：

        首先，我们定义一个PageBean类，用于封装分页查询的结果：

@Data
@AllArgsConstructor
@NoArgsConstructor
public class PageBean {
    private Long total;//总记录数
    private List rows;//数据列表
}

        然后，在控制器中，我们可以通过HTTP请求的参数来接收页码和每页的大小：
 

@GetMapping("/enrollmentPlan/page")
public Result page(@RequestParam(defaultValue = "1") Integer page,
                   @RequestParam(defaultValue = "10") Integer pageSize) {
    log.info("招生计划分页查询, 参数: {},{}", page, pageSize);
    PageBean pageBean = iEnrollmentPlanService.pageEnrollmentPlan(page, pageSize);
    return pageBean != null ? Result.success(pageBean) : Result.error("分页查询招生计划失败");
}

        在服务层，我们调用PageHelper.startPage(page, pageSize)方法设置分页参数，然后执行查询：

@Override
public PageBean pageEnrollmentPlan(Integer page, Integer pageSize) {
    if (Objects.isNull(page) || Objects.isNull(pageSize)) {
        throw new IllegalArgumentException("Page number or page size is null");
    }
    //设置分页参数（页数，每页size）
    PageHelper.startPage(page, pageSize);

    //执行查询
    List<EnrollmentPlan> enrList = enrollmentPlanMapper.selectList(null);
    Page<EnrollmentPlan> pg = (Page<EnrollmentPlan>) enrList;

    //封装PageBean对象
    PageBean pageBean = new PageBean(pg.getTotal(), pg.getResult());
    return pageBean;
}

        在这个例子中，我们通过PageHelper.startPage(page, pageSize)设置分页参数，然后执行查询。查询结束后，我们可以通过Page.getTotal()获取总记录数，通过Page.getResult()获取查询结果。

        总的来说，PageHelper的主要优点是使分页查询变得简单且高效，你不需要手动计算limit参数，也不需要关心不同数据库的SQL语句语法。希望这篇文章能帮助你理解和使用PageHelper进行分页查询。