---

• PageHelper 在 github 的项目地址：https://github.com/pagehelper/Mybatis-PageHelper
• PageHelper 官网：https://pagehelper.github.io/

---

一、 limit分⻚

• mysql的limit后⾯两个数字：
  • 第⼀个数字：startIndex（起始下标。下标从0开始。）
  • 第⼆个数字：pageSize（每⻚显示的记录条数）
• 假设已知⻚码pageNum，还有每⻚显示的记录条数pageSize，startIndex = (pageNum - 1) * pageSize
• 所以，标准通⽤的mysql分⻚SQL：

select * fromtableName ......
limit (pageNum - 1) * pageSize, pageSize

• 在实际的开发中，一般由前端或者后端人员将 pageNum、pageSize 计算好后传递给 mybatis。

<select id="selectActivityByConditionForPage" parameterType="map" resultMap="BaseResultMap">selecta.id,u1.name as owner,a.name,a.start_date,a.end_date,a.cost,a.description,a.create_time,u2.name as create_by,a.edit_time,u3.name as edit_byfromtbl_activity ajointbl_user u1 on a.owner=u1.idjointbl_user u2 on a.create_by=u2.idleft jointbl_user u3 on a.edit_by=u3.id<where><if test="name!=null and name!=''">and a.name like '%' #{name} '%'</if><if test="owner!=null and owner!=''">and u1.name like '%' #{owner} '%'</if><if test="startDate!=null and startDate!=''">and a.start_date&gt;=#{startDate}</if><if test="endDate!=null and endDate!=''">and a.end_date&lt;=#{endDate}</if></where>order by a.create_time desclimit #{beginNo},#{pageSize}
</select>

---

二、PageHelper插件

第⼀步：引⼊依赖

<dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>5.3.2</version>
</dependency>

第⼆步：在mybatis-config.xml⽂件中配置插件

• typeAliases标签下⾯进⾏配置：

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

第三步：编写Java代码

• 关键点：
  • 在查询语句之前开启分⻚功能。（只有紧跟在 PageHelper.startPage 方法后的第一个 Mybatis 的查询（Select）方法会被分页。）
  • 在查询语句之后封装PageInfo对象。（PageInfo对象将来会存储到 request 域当中。在⻚⾯上展示。）

  @Test
  public void testPageHelper() throws Exception{SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));SqlSession sqlSession = sqlSessionFactory.openSession();CarMapper mapper = sqlSession.getMapper(CarMapper.class);// 开启分⻚PageHelper.startPage(2, 2);// 执⾏查询语句List<Car> cars = mapper.selectAll();// 获取分⻚信息对象PageInfo<Car> pageInfo = new PageInfo<>(cars, 5);System.out.println(pageInfo);
  }
  

第四步：格式化结果查看

• 对于其中的属性都有对应的方法来获取，需要的时候查找即可。
• 每个属性的含义可以在使用的时候上网查找。

PageInfo{pageNum=2, pageSize=2, size=2, startRow=3, endRow=4, total=6, pages=3,list=Page{count=true, pageNum=2, pageSize=2, startRow=2, endRow=4, total=6, pages=3, reasonable=false, pageSizeZero=false}[Car{id=86, carNum='1234', brand='丰⽥霸道', guidePrice=50.5, produceTime='2020-1011', carType='燃油⻋'},Car{id=87, carNum='1234', brand='丰⽥霸道', guidePrice=50.5, produceTime='2020-10-11', carType='燃油⻋'}],prePage=1, nextPage=3, isFirstPage=false, isLastPage=false, hasPreviousPage=true, hasNextPage=true,navigatePages=5, navigateFirstPage=1, navigateLastPage=3,navigatepageNums=[1, 2, 3]
}

---

三、SpringBoot3 集成 PageHelper 插件

• Add the following dependency to your pom.xml:

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

---