详解Mybatis之分页插件【PageHelper】

编译软件：IntelliJ IDEA 2019.2.4 x64
操作系统：win10 x64 位 家庭版
Maven版本：apache-maven-3.6.3
Mybatis版本：3.5.6

---

---

---

一. 什么是分页？

以百度搜索为例，如下所示

---

二. 为什么使用分页？

好处

1. 可以提高用户体验度
2. 可以降低服务器端压力

---

三. 如何设计一个Page类（分页）？

举例，例如 47/60

• 47：当前页码
• 60：总页数

Mysql中分页查询代码如下

#x:开启下标 y:每页显示数据数量
SELECT * FROM  tbl_employee  WHERE 1=1  LIMIT x,y    

需要明确Page类的相关参数

• pageNum：当前页码
• pages：总页数【计算：总页数=总数据数量/每页显示数据数量】
• total：总数据数量
• pageSize：每页显示数据数量
• List\：当前页显示数据集合

---

四. PageHelper是什么？

概述

PageHelper是MyBatis中非常方便的第三方分页插件

官方参考文档

https://github.com/pagehelper/Mybatis-PageHelper/blob/master/README_zh.md

---

五. 如何使用PageHelper?（入门案例）

步骤

1. 导入PageHelperE的相关jar包
2. 在mybatis-config.xml中配置分页插件
3. 在查询之前，设置分页条件
4. 在查询之后，将结果封装Pagelnfo中，使用Pagelnfo实现后续分页效果

用法案例

查询所有的员工信息，使用PageHelper插件进行分页显示，暂定分页效果为显示第二页，展示4条数据

示例代码如下：

①导入PageHelper的相关jar包

<dependency>
    <groupId>com.github.pagehelpergroupId>
    <artifactId>pagehelperartifactId>
    <version>5.0.0version>
dependency>

②在mybatis-config.xml中配置分页插件

<plugins>
    <plugin interceptor="com.github.pagehelper.PageInterceptor">plugin>
plugins>

④在查询之前，设置分页条件

使用 PageHelper.startPage(2,4)并测试PageHelper相关使用方法

  @Test
    public void test03(){
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

            //通过SqlSessionFactory对象调用openSession();
            SqlSession sqlSession = sqlSessionFactory.openSession();

            //获取EmployeeMapper的代理对象
            EmployeeMapper employeeMapper = sqlSession.getMapper(EmployeeMapper.class);

            //在查询之前，设置分页条件
            //显示第一页，展示3条数据
            Page<Object> pages = PageHelper.startPage(2, 4);

            //员工的查询条件对象
            EmployeeExample ee=new EmployeeExample();

            //当员工的查询条件对象没有设任何属性值时，默认是查询所有的员工信息
            List<Employee> employees = employeeMapper.selectByExample(ee);
            for (Employee employee : employees) {
                System.out.println(employee);
            }

            //实现类似 "2/3"的效果（当前页码/数据的总页数)
            System.out.println(pages.getPageNum()+"/"+pages.getPages());
            System.out.println("总数据量 :"+pages.getTotal());
            System.out.println("每页显示的数据量 ："+pages.getPageSize());
            System.out.println("当前页显示的数据集合 :"+pages.getResult());
            for (Object page : pages.getResult()) {
                System.out.println(page);
            }

        } catch (IOException e) {
            e.printStackTrace();
        }
    }

⑤在查询之后，将结果封装Pagelnfo中，使用Pagelnfo实现后续分页效果

为什么要使用Pagelnfo去封装分页的结果？

PageInfo就是用来封装分页信息的一个工具类，它能够将分页所需的所有信息组合在一起，并返回给前端或其他业务逻辑进行处理。

使用PageInfo去封装分页的结果可以带来以下好处：

1. 方便管理分页相关的信息：PageInfo可以统一管理当前页码、每页记录数、总记录数、总页数等分页信息，使得代码更加清晰易读。
2. 便于扩展和维护：当需求变化时，可以通过修改PageInfo类来快速实现新需求，而不需要对已有的代码进行大量修改，从而提高了系统的可维护性和扩展性。
3. 更加灵活的分页展示效果：通过调整PageInfo中的参数设置，可以实现不同的分页展示效果，例如改变每页显示的记录数，调整页码的排列顺序等等。

@Test
public void test04(){
    try {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        //通过SqlSessionFactory对象调用openSession();
        SqlSession sqlSession = sqlSessionFactory.openSession();

        //获取EmployeeMapper的代理对象
        EmployeeMapper employeeMapper = sqlSession.getMapper(EmployeeMapper.class);

        //在查询之前，设置分页条件
        //显示第一页，展示3条数据
        Page