java中实现分页的常见几种方式

Posted 2023-03-14 搏·梦

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了java中实现分页的常见几种方式相关的知识，希望对你有一定的参考价值。

文章目录

1. 前言
2. 先说结论
3. 例子

1. 前言

无论是自我学习中，还是在工作中，固然会遇到与前端搭配实现分页的功能，发现有几种方式，特此记录一下。

2. 先说结论

分页功能直接交给前端实现(根据业务场景且仅仅只能用于数据量少的情况)。即后端不做任何数据的限制，直接把全部数据返回给前端，前端通过组件实现分页，筛选等功能。请不要轻视该方式，好处即只需要前后端交互一次。
使用数据库SQL的限制条件，即给搜索语句加上条件，限制查询出来的数据个数：
1. mysql数据库是使用 limit n,m 从第n个开始，往后取m个(注不包括第n个数据)
2. oracle数据库是使用 OFFSET n ROWS FETCH NEXT m ROWS ONLY 从第n行开始，往后取m行(注不包括第n行数据)
3. oracle的可以查看这篇文章：oracle中将数据进行排序之后，获取前几行数据的写法(rownum、fetch方式）
使用List集合的截取功能实现，即将数据都查到内存中List集合，在内存中找到要的数据。当然有人说这种方式还不如第二点，但请具体情况具体分析，有可能需求要的数据，是从数据库中查询不到的，需要将原始数据查到内存加工处理数据之后得到，才能进行分页处理。(同理，该方法，只能根据需求且数据量少的情况)
使用优秀的插件PageHelper，真的很不错。

3. 例子

1. 数据库SQL的限制条件(limit、fetch）

先说结论：

mysql写法：
SELECT * FROM user2
LIMIT (#pageNum - 1) * #pageSize, #pageSize

oracle写法：
SELECT * FROM user2
OFFSET (#pageNum - 1) * #pageSize ROWS FETCH NEXT #pageSize ROWS ONLY

直接看代码：

@Mapper
public interface PageTestDao 
	
	// 查数据
	// start：从第几条开始，向后要数据
	// pageSize：一页多少条数据
    List<UserEntity> getUserInfoByParams(@Param("nameParam") String name,
                                         @Param("start") int start,
                                         @Param("pageSize") int pageSize);
	// 返回总条数
    int getCountByParams(@Param("nameParam") String name);

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.csdn2.page_test.dao.PageTestDao">

    <sql id="nameCondition">
        <where>
            <if test="nameParam != null and nameParam != ''">
                name like CONCAT('%', #nameParam, '%')
            </if>
        </where>
    </sql>

    <select id="getUserInfoByParams" resultType="com.example.csdn2.page_test.entity.UserEntity">
        SELECT * FROM user2
        <include refid="nameCondition" />
        LIMIT #start, #pageSize
    </select>

    <select id="getCountByParams" resultType="int">
        SELECT COUNT(*) FROM user2
        <include refid="nameCondition" />
    </select>
</mapper>

@Service
@RequiredArgsConstructor
public class PageTestService 

    private final PageTestDao pageTestDao;

    public PageResponse<UserEntity> getPageTest(UserRequest userRequest) 
        final List<UserEntity> userEntityList = pageTestDao.getUserInfoByParams(userRequest.getNameParam(),
                userRequest.getStart(), userRequest.getPageSize());

        final int total = pageTestDao.getCountByParams(userRequest.getNameParam());

        return new PageResponse<>(userEntityList, total);

// 若分页的需求很多，可把分页相关的参数抽出来
@Data
public class PageRequest 

    // 第几页
    private int pageNum;

    // 每页几行数据
    private int pageSize;

	// 计算从第几行开始
	// 无论是limit、还是fetch 都是从某一行数据开始，向后取 pageSize 条数据
    public int getStart() 
        if (pageNum <= 0) 
            return 0;
        
        return (pageNum - 1) * pageSize;
    


// 入参
@EqualsAndHashCode(callSuper = true)
@Data
public class UserRequest extends PageRequest 

    // 搜索参数
    private String nameParam;


// 返回实体类，因为分页需要返回总条数，前端好做下标第几页
@Data
@AllArgsConstructor
public class PageResponse<T> 

    private List<T> data;

	// 总条数
    private int total;

@RestController
@RequiredArgsConstructor
public class PageTestController 

    private final PageTestService pageTestService;

    @PostMapping("/page-test")
    public PageResponse<UserEntity> getPageTest(@RequestBody UserRequest userRequest)
       return pageTestService.getPageTest(userRequest);

2. 使用List集合的截取功能实现

先看一下List的截取

// 从第几个下标，到第几个下标
List<E> subList(int fromIndex, int toIndex);

    public void test_ListSub() 
    	// 创建模拟数据，字符串 0-9的集合
        final List<String> list = IntStream.range(0, 10)
                .mapToObj(i -> i + "")
                .collect(Collectors.toList());
        System.out.println(list);
        // 截取从下标0到5的数据
        System.out.println(list.subList(0, 5));
        // 截取从下标3到5的数据
        System.out.println(list.subList(3, 5));

回归上述分页例子，代码改成如下：
dao层不加 limit 条件

  SELECT * FROM user2
  name like CONCAT('%', #nameParam, '%')

server层：

 public PageResponse<UserEntity> getPageTestByListSub(UserRequest userRequest) 
        final List<UserEntity> allData = pageTestDao.getUserInfoByParamsNoLimit(userRequest.getNameParam());
        // 下标开始
        final int start = userRequest.getStart();
        // 下标结束
        final int end = start + userRequest.getPageSize();
        // 截取数据
        final List<UserEntity> userEntityList = allData.subList(start, end);

        final int total = pageTestDao.getCountByParams(userRequest.getNameParam());
        return new PageResponse<>(userEntityList, total);

3. 插件PageHelper

其实PageHelper官网中有详细的文档以及例子：https://pagehelper.github.io/docs/howtouse/
下面例子只是讲其与springboot结合的核心内容，即快速开发：

引入相关jar包坐标到pom.xml中

<dependency>
        <groupId>com.github.pagehelper</groupId>
        <artifactId>pagehelper-spring-boot-starter</artifactId>
        <version>1.3.0</version>
</dependency>

dao层的sql不需要加 Limit 条件(因为PageHelper会自动帮忙加的)
```
  SELECT * FROM user2
  name like CONCAT('%', #nameParam, '%')
```

service层修改如下：

   public PageInfo<UserEntity> getPageTest(UserRequest userRequest) 
        // 告诉PageHelper数据要从第几页，每页多少条数据
        // 注：一定要在select查询语句之前使用该方法，否则无效
        PageHelper.startPage(userRequest.getPageNum(), userRequest.getPageSize());
        
        // 查询sql
        final List<UserEntity> userEntityList = pageTestDao.getUserInfoByParamsNotLimit(userRequest.getNameParam());

        // 返回dto，使用插件自带的PageInfo
        return new PageInfo<>(userEntityList);

		// 上述逻辑还可以简写为：
		// return PageHelper.startPage(userRequest.getPageNum(), userRequest.getPageSize())
            // .doSelectPageInfo(() -> pageTestDao.getUserInfoByParamsNotLimit(userRequest.getNameParam()));

结果如下（与之前查询结果一致，没问题）：


    "total": 9,
    "list": [
        
            "name": "4a",
            "pwd": "D"
        ,
        
            "name": "5a",
            "pwd": "E"
        ,
        
            "name": "6a",
            "pwd": "F"
        
    ],
    "pageNum": 2,
    "pageSize": 3,
    "size": 3,
    "startRow": 4,
    "endRow": 6,
    "pages": 3,
    "prePage": 1,
    "nextPage": 3,
    "isFirstPage": false,
    "isLastPage": false,
    "hasPreviousPage": true,
    "hasNextPage": true,
    "navigatePages": 8,
    "navigatepageNums": [
        1,
        2,
        3
    ],
    "navigateFirstPage": 1,
    "navigateLastPage": 3

为什么说该插件很优秀呢，查看PageInfo的返回参数，核心内容：

	// 当前页
    private int pageNum;
    // 每页的数量
    private int pageSize;
    // 当前页的数量
    private int size;

    // 总记录数
    private long total;
    // 总页数
    private int pages;
    // 结果集
    private List<T> list;
 
 	// 以下内容都是其自动帮生成的
 	// 对于前端来说极其友好，前端分页功能的全部参数都包含了
    // 前一页的页码
    private int prePage;
    // 下一页的页码
    private int nextPage;
    // 是否为第一页
    private boolean isFirstPage = false;
    // 是否为最后一页
    private boolean isLastPage = false;
    // 是否有前一页
    private boolean hasPreviousPage = false;
    // 是否有下一页
    private boolean hasNextPage = false;
    // 导航条上的第一页的页码
    private int navigateFirstPage;
    // 导航条上的第一页的页码
    private int navigateLastPage;

查看PageHelper执行了什么sql语句

以上是关于java中实现分页的常见几种方式的主要内容，如果未能解决你的问题，请参考以下文章

java中数据库中实现分页的sql语句要求每页十条要查询的是第二页

JaveWeb中实现分页的总结

在存储库级别在 Doctrine2 ORM 中实现分页的最佳实践

小案例--面向对象中实现分页

在SSH项目中实现分页效果

使用插件pagehelper在mybatis中实现分页查询