Java 集合分页

一、前言

        在Java开发中，若单次展示的数据量太大，会造成程序响应缓慢，就需要用到 分页 功能，每一页展示一定量的数据，分多次展示 ... 那么在List集合中，如何实现 分页 功能呢？

        本文将以3种方式，分别是： subList 方法、Java8 Stream 、Lists.partition，实现 List集合的分页功能。

二、代码实现

        1、假设有一个 list集合，元素如下：

ArrayList<Integer> list = Lists.newArrayList(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);

2、使用 subList 实现分页：

/**@Description: subList 分页* <br> 1. 起始位置边界值处理： 当前页码 <= 0 情况处理； 当前页码 > 最大页码 情况处理* <br> 2. 终止位置边界值处理： 当前页码 <= 0 情况处理； 终止位置 <= 总记录数  情况处理* @param pageSize 每页显示的数量* @param pageNum  当前页码* @version v1.0* @author wu* @date 2022/7/31 11:44*/
private List<?> subList(ArrayList<?> list, int pageSize, int pageNum) {int count = list.size(); // 总记录数// 计算总页数int pages = count % pageSize == 0 ? count / pageSize : count / pageSize + 1;// 起始位置int start = pageNum <= 0 ? 0 : (pageNum > pages ? (pages - 1) * pageSize : (pageNum - 1) * pageSize);// 终止位置int end = pageNum <= 0 ? (pageSize <= count ? pageSize : count) : (pageSize * pageNum <= count ? pageSize * pageNum : count);return list.subList(start, end);
}

3、Java8 Stream 分页

/**@Description: Java8 Stream 分页* <br> 1. 起始位置边界值处理： 同 subList 方法* <br> 2. 终止位置：无需处理，会自动处理边界问题*  @param pageSize 每页显示的数量*  @param pageNum  当前页码* @version v1.0* @author wu* @date 2022/7/31 11:49*/
private List<?> subListJava8(ArrayList<?> list, int pageSize, int pageNum) {int count = list.size(); // 总记录数// 计算总页数int pages = count % pageSize == 0 ? count / pageSize : count / pageSize + 1;// 起始位置int start = pageNum <= 0 ? 0 : (pageNum > pages ? (pages - 1) * pageSize : (pageNum - 1) * pageSize);// 终止位置int end = pageSize ;return list.stream().skip(start).limit(pageSize).collect(Collectors.toList());
}

  4、使用 Lists 工具类的 partition 分页

/**@Description: 使用 Lists 工具类的 partition 分页* <br> 1. 页码边界值处理：小于等于0，情况处理； 页码大于 （总页数-1） 情况处理* <br> 2. 总页数-1 ，原因是：list集合索引是从0开始的。*  @param pageSize 每页显示的数量*  @param pageNum  当前页码* @version v1.0* @author wu* @date 2022/7/31 11:55* @see com.google.common.collect.Lists#partition(java.util.List, int)*/
private List<?> partition(ArrayList<?> list, int pageSize, int pageNum) {// 将 List 按照 PageSzie 拆分成多个ListList<? extends List<?>> partition = Lists.partition(list, pageSize);// 总页数int pages = partition.size();pageNum = pageNum <= 0 ? 0 : (pageNum <= (pages - 1) ? pageNum : (pages - 1));return partition.get(pageNum);
}

三、测试

        1、使用List的 subList 方法实现分页 测试：

/*** @Description: 使用List的 subList 方法实现分页* @version v1.0* @author wu* @date 2022/7/31 10:43*/
@Test
public void subListTest() {int pageSize = 3; // 每一页显示的数量int pageNum = 2; // 页码System.out.println(subList(list, pageSize, -2));System.out.println(subList(list, pageSize, 0));System.out.println(subList(list, pageSize, 1));// 第一页System.out.println(subList(list, pageSize, 2));System.out.println(subList(list, pageSize, 3));System.out.println(subList(list, pageSize, 4)); // 第四页数据System.out.println(subList(list, pageSize, 5)); // 第五页数据
}

   2、使用 Java8 Stream 实现分页 测试：

/**@Description: 使用 Java8 Stream 实现分页* @version v1.0* @author wu* @date 2022/7/31 11:44*/
@Test
public void subListJava8Test() {int pageSize = 3; // 每一页显示的数量int pageNum = 2; // 页码System.out.println(subListJava8(list, pageSize, -2));System.out.println(subListJava8(list, pageSize, 0));System.out.println(subListJava8(list, pageSize, 1));// 第一页System.out.println(subListJava8(list, pageSize, 2));System.out.println(subListJava8(list, pageSize, 3));System.out.println(subListJava8(list, pageSize, 4)); // 第四页数据System.out.println(subListJava8(list, pageSize, 5)); // 第四页数据
}

3、Lists 工具类的 partition 分页 测试：

@Test
public void partitionTest() {int pageSize = 3; // 每一页显示的数量int pageNum = 2; // 页码System.out.println(partition(list, pageSize, -2));System.out.println(partition(list, pageSize, 0));System.out.println(partition(list, pageSize, 1));// 第一页System.out.println(partition(list, pageSize, 2));System.out.println(partition(list, pageSize, 3));System.out.println(partition(list, pageSize, 4)); // 第四页数据System.out.println(partition(list, pageSize, 5)); // 第五页数据System.out.println(partition(list, pageSize, 6)); // 第六页数据
}

四、总结

        1、以上是List集合实现分页的3种方式，在实际工作应用中，一般很少，都是在数据中实现好的分页，偶尔遇到实际要使用时，翻开文章，可以做到 “开箱即用”！

        2、注意点：本文分页案例中，都已经对 极端情况（边界值）处理，可以有效避免索引越界的情况，如下：
      开始位置： 当前页码值 <= 0 ， 取值 第一页 ; 当前页码 > 总页数 ， 取值 总页数
      结束位置：当前页码值 <= 0 ，则判断 每页显示数据 是否小于总记录数 （ pageSize <= count       ? pageSize : count ）； 当前页码 > 0 , 则判断 结束数量 是否小于等于 总记录数 （ pageSize       *  pageNum <= count ? pageSize * pageNum : count ）
3、Lists 工具类，依赖 pom.xml ：

<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>28.0-jre</version>
</dependency>

4、补充一个 List 集合创建 笛卡尔积的方法：

List<List<Integer>> lists = Lists.cartesianProduct(list1, list2);