Java コレクションのページネーション

I.はじめに

        Java開発では、一度に表示するデータ量が多すぎるとプログラムの応答が遅くなったり、ページング機能が必要になったり、ページごとに一定量のデータを表示したり、複数回表示したり…。リストコレクション、ページネーション機能の実装方法は?

        この記事では、List コレクションのページング機能を、subList メソッド、Java8 Stream、および Lists.partition の 3 つの方法で実装します。

2. コードの実装

        1. 次の要素を持つリスト コレクションがあるとします。

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 ストリームのページネーション

/**@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 ツール クラスのパーティション ページングを使用する

/**@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 拆分成多个List
    List<? 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);
}

3.テスト

        1. リストの 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 ツール クラスのパーティション ページング テスト:

@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)); // 第六页数据
}

4.まとめ

        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);