分页工具类PageUtil

一、背景

日常开发中，有的时候我们需要在代码中对已有数据进行分页，而不是从数据库中分页，比如我们的数据组装非常复杂，不可能通过数据的一次查询就可以直接进行分页，而是多次查询数据库，把查询的数据按照业务逻辑进行汇总整合，如报表查询，此时就需要一个对已有数据能进行分页的工具。本篇文章介绍的是一个在内存上进行自主分页的工具，笔者称之为虚拟分页。本质上其实和数据库分页是一个道理。

二、分页工具类

笔者提供的PageUtil 类是一个 Java 工具类，主要功能是为已经存在的 List 数据进行分页处理。这个类包含两个静态方法：
        1.public static <T> List<T> getList(int pageNum, int pageSize, List<T> list)： 这个方法接收三个参数：pageNum（当前页码），pageSize（每页的元素数量）和一个泛型 List 对象 list。方法内部调用 getPageInfo 方法获取分页后的数据，并从返回的 PageInfo 对象中提取 list 属性，然后返回这个分页后的列表。这样做的目的是为了简化获取分页列表的操作。
         2.public static <T> PageInfo<T> getPageInfo(int currentPage, int pageSize, List<T> list)： 这个方法更为复杂，它负责实际的分页逻辑。参数与 getList 方法相同。首先，计算总记录数 total，然后根据当前页和每页大小确定分页的起始和结束索引。如果索引越界，则进行调整。接着，创建一个 Page 对象，设置其当前页码、每页大小，并将原始列表添加到 Page 对象中。然后，计算总页数（向上取整），并设置到 Page 对象的 pages 字段。最后，创建一个 PageInfo 对象，将 Page 对象传递给它，并返回 PageInfo 对象。PageInfo 包含了分页后的列表、总记录数、总页数等信息。

这两个方法的主要应用场景是，当数据已经经过处理或组装，不能直接使用数据库的分页功能时，可以利用 PageUtil 对数据进行内存中的分页操作。但是，由于分页是在内存中完成的，如果处理的数据量过大，可能会导致内存溢出问题，因此建议只对小到中等规模的数据集使用此工具类。

具体代码如下所示

package com.ruoyi.common.utils;

import com.github.pagehelper.Page;
import com.github.pagehelper.PageInfo;
import java.util.List;

/**
 * 对已知list进行分页查询,通用工具
 * 注意本工具类适合对已知list进行分页查询,list大小不宜太大,否则会导致内存溢出，一般是数据需要经过组装,直接使用pagehelper不方便时，可使用本工具类
 * @author hulei
 * @date 2022-03-30
 */
public class PageUtil {

    /**
     * 直接获取分页列表List<T>
     * @param pageNum 页码
     * @param pageSize 每页大小
     * @param list 待分页集合
     * @param <T> T
     * @return 分页查询后list
     */
    public static <T> List<T> getList(int pageNum, int pageSize, List<T> list){
        return getPageInfo(pageNum, pageSize, list).getList();
    }

    /**
     * 获取分页结果PageInfo<T>
     * @param currentPage 当前页
     * @param pageSize 每页大小
     * @param list  待分页集合
     * @param <T> T
     * @return 分页信息
     */
    public static <T> PageInfo<T> getPageInfo(int currentPage, int pageSize, List<T> list) {
        int total = list.size();
        if (total > pageSize) {
            int toIndex = pageSize * currentPage;
            if (toIndex > total) {
                toIndex = total;
            }
            if(pageSize * (currentPage - 1)<toIndex){
                list = list.subList(pageSize * (currentPage - 1), toIndex);
            }
        }
        Page<T> page = new Page<>(currentPage, pageSize);
        page.addAll(list);
        page.setPages((total + pageSize - 1) / pageSize);
        page.setTotal(total);
        return new PageInfo<>(page);
    }

}

使用mybatis时我们经常使用分页工具PageHelper帮助我们分页，但是pagehelper.startPage()只能针对第一个sql查询结果进行分页，有时候我们查询比较复杂，返回的list是由多个查询结果拼接出来的，使用pagehelper就是不起作用了，这时候使用此工具类包装分页信息

三、实战分析

看如下代码

查询的list方法比较复杂

先把总的list查询出，再使用 PageUtil.getPageInfo()手动分页，从分页信息中提取信息返回包装R对象

注意list不能太大，太大都放在内存会导致内存溢出