当前位置： 首页 > news >正文

PageHelp插件使用

news 2026/5/11 23:28:27

PageHelp插件使用

一、PageHelper 是什么？

PageHelper 是 MyBatis 的一个开源分页插件，它通过拦截 MyBatis 执行的 SQL 语句，自动在原SQL上添加分页语句（如 MySQL 的 LIMIT），并同时查询总记录数。

核心特点：

  • 简单易用：只需要一行代码即可实现分页
  • 支持多种数据库：MySQL、Oracle、PostgreSQL、SQLServer 等
  • 零侵入：不需要修改原有Mapper和SQL语句
  • 功能丰富：支持多种分页方式、排序、Count查询优化等

二、为什么要用 PageHelper？

在没有分页插件时，我们需要手动写分页SQL：

sql

-- 传统方式需要写两条SQL
SELECT COUNT(*) FROM users WHERE age > 18;  -- 查询总数
SELECT * FROM users WHERE age > 18 LIMIT 0, 10;  -- 查询数据

PageHelper 的优势：

  1. 代码简洁：一行代码代替复杂的分页逻辑
  2. 维护方便：分页逻辑与业务逻辑分离
  3. 功能强大：自动处理总数统计、页码计算等
  4. 性能优化：支持多种 Count 查询优化策略

三、集成与配置

1. 添加依赖

Maven 项目：

xml

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

Gradle 项目：

gradle

implementation 'com.github.pagehelper:pagehelper-spring-boot-starter:1.4.2'

2. 配置文件（application.yml）

yaml

pagehelper:helper-dialect: mysql  # 数据库方言：mysql, oracle, postgresql 等reasonable: true       # 分页合理化：true时，pageNum<=0会查询第一页，pageNum>总页数会查询最后一页support-methods-arguments: true  # 支持通过Mapper接口参数来传递分页参数params: count=countSql  # 用于从Map或ServletRequest中参数名的映射page-size-zero: false   # 当pageSize=0时返回所有结果

四、核心使用方法

1. 基本分页查询

这是最常用的方式，在查询方法前调用 PageHelper.startPage()：

java

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;/*** 分页查询用户列表*/public PageInfo<User> getUsersByPage(int pageNum, int pageSize) {// 关键代码：在查询方法前调用，第一个参数是页码，第二个是每页大小PageHelper.startPage(pageNum, pageSize);// 正常的查询，不需要任何修改List<User> userList = userMapper.selectAllUsers();// 用PageInfo对结果进行包装，PageInfo包含了丰富的分页信息PageInfo<User> pageInfo = new PageInfo<>(userList);return pageInfo;}
}

2. Mapper 接口和 XML

UserMapper.java:

java

@Mapper
public interface UserMapper {List<User> selectAllUsers();List<User> selectUsersByCondition(UserQuery query);
}

UserMapper.xml:

xml

<?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.mapper.UserMapper"><!-- 正常的查询SQL，不需要任何分页语句 --><select id="selectAllUsers" resultType="User">SELECT id, name, age, email FROM users</select><select id="selectUsersByCondition" parameterType="UserQuery" resultType="User">SELECT id, name, age, email FROM usersWHERE 1=1<if test="name != null and name != ''">AND name LIKE CONCAT('%', #{name}, '%')</if><if test="minAge != null">AND age >= #{minAge}</if><if test="maxAge != null">AND age <= #{maxAge}</if></select>
</mapper>

3. 实体类

java

// 用户实体
@Data
public class User {private Long id;private String name;private Integer age;private String email;
}// 查询条件实体
@Data
public class UserQuery {private String name;private Integer minAge;private Integer maxAge;
}

五、PageInfo 对象详解

PageInfo 对象包含了完整的分页信息，非常适合返回给前端：

java

// 测试分页查询
@Test
public void testPageInfo() {PageHelper.startPage(2, 5); // 查询第2页，每页5条List<User> userList = userMapper.selectAllUsers();PageInfo<User> pageInfo = new PageInfo<>(userList);// 打印分页信息System.out.println("当前页: " + pageInfo.getPageNum());System.out.println("每页大小: " + pageInfo.getPageSize());System.out.println("当前页数据: " + pageInfo.getList());System.out.println("总记录数: " + pageInfo.getTotal());System.out.println("总页数: " + pageInfo.getPages());System.out.println("是否是第一页: " + pageInfo.isIsFirstPage());System.out.println("是否是最后一页: " + pageInfo.isIsLastPage());System.out.println("是否有上一页: " + pageInfo.isHasPreviousPage());System.out.println("是否有下一页: " + pageInfo.isHasNextPage());
}

PageInfo 常用属性：

  • list：分页后的数据列表
  • pageNum：当前页码
  • pageSize：每页显示数量
  • total：总记录数
  • pages：总页数
  • prePage：上一页页码
  • nextPage：下一页页码
  • isFirstPage/isLastPage：是否第一页/最后一页
  • hasPreviousPage/hasNextPage：是否有上一页/下一页
  • navigatePages：导航页码数（默认8）
  • navigatepageNums：所有导航页号

六、多种使用方式

1. 方式一：startPage + PageInfo（推荐）

java

PageHelper.startPage(1, 10);
List<User> list = userMapper.selectByExample(example);
PageInfo<User> pageInfo = new PageInfo<>(list);

2. 方式二：使用Page对象

java

PageHelper.startPage(1, 10);
List<User> list = userMapper.selectByExample(example);
PageInfo<User> pageInfo = new PageInfo<>(list);// 或者直接使用Page对象
Page<User> page = (Page<User>) list;
System.out.println("总数: " + page.getTotal());

3. 方式三：使用Mapper接口参数（需要配置）

java

// 在接口方法中添加RowBounds参数
List<User> selectByRowBounds(UserExample example, RowBounds rowBounds);// 使用
List<User> list = userMapper.selectByRowBounds(example, new RowBounds(0, 10));

七、高级功能

1. 排序功能

java

// 单字段排序
PageHelper.startPage(1, 10, "id desc");// 多字段排序
PageHelper.startPage(1, 10, "age asc, name desc");// 或者使用OrderBy
PageHelper.startPage(1, 10).setOrderBy("create_time desc");

2. 复杂查询条件 + 分页

java

public PageInfo<User> searchUsers(UserQuery query, int pageNum, int pageSize) {PageHelper.startPage(pageNum, pageSize);List<User> userList = userMapper.selectUsersByCondition(query);return new PageInfo<>(userList);
}

3. 只分页不查询总数（提升性能）

java

// 第三个参数设为false，不执行count查询
PageHelper.startPage(1, 10, false);
List<User> list = userMapper.selectAllUsers();

八、完整实战示例

1. Controller 层

java

@RestController
@RequestMapping("/api/users")
public class UserController {@Autowiredprivate UserService userService;/*** 分页查询用户列表*/@GetMappingpublic Result<PageInfo<User>> getUsers(@RequestParam(defaultValue = "1") int pageNum,@RequestParam(defaultValue = "10") int pageSize,@RequestParam(required = false) String name,@RequestParam(required = false) Integer minAge,@RequestParam(required = false) Integer maxAge) {UserQuery query = new UserQuery();query.setName(name);query.setMinAge(minAge);query.setMaxAge(maxAge);PageInfo<User> pageInfo = userService.searchUsers(query, pageNum, pageSize);return Result.success(pageInfo);}
}// 统一返回结果封装
@Data
class Result<T> {private int code;private String message;private T data;public static <T> Result<T> success(T data) {Result<T> result = new Result<>();result.setCode(200);result.setMessage("success");result.setData(data);return result;}
}

2. Service 层

java

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public PageInfo<User> searchUsers(UserQuery query, int pageNum, int pageSize) {// 开启分页PageHelper.startPage(pageNum, pageSize);// 执行查询List<User> userList = userMapper.selectUsersByCondition(query);// 返回分页结果return new PageInfo<>(userList);}
}

3. 前端调用示例

http

GET /api/users?pageNum=2&pageSize=5&name=张&minAge=18

4. 返回结果示例

json

{"code": 200,"message": "success","data": {"pageNum": 2,"pageSize": 5,"total": 23,"pages": 5,"list": [{"id": 6,"name": "张三","age": 25,"email": "zhangsan@example.com"},// ... 其他4条数据],"prePage": 1,"nextPage": 3,"isFirstPage": false,"isLastPage": false,"hasPreviousPage": true,"hasNextPage": true}
}

九、注意事项

  1. 确保 PageHelper.startPage() 后紧跟查询语句

    java

    // ✅ 正确
PageHelper.startPage(1, 10);
List<User> list = userMapper.selectAll();// ❌ 错误：中间不能有其他代码
PageHelper.startPage(1, 10);
System.out.println("开始查询"); // 这行代码会导致分页失效
List<User> list = userMapper.selectAll();

  2. 线程安全：PageHelper 基于 ThreadLocal，确保在同一个线程内使用

  3. Count查询优化：对于复杂查询，可以自定义Count查询

    xml

    <select id="selectWithCustomCount" resultType="User">SELECT * FROM users WHERE ...
</select><select id="selectWithCustomCount_COUNT" resultType="long">SELECT COUNT(*) FROM users WHERE ...
</select>

总结

PageHelper 是一个非常强大且易用的 MyBatis 分页插件，通过简单的 PageHelper.startPage() 调用，就可以实现完整的分页功能。它的主要优点在于：

  • 使用简单：一行代码实现分页
  • 功能丰富：支持排序、多种分页方式等
  • 兼容性好：支持多种数据库
  • 性能优秀：提供Count查询优化

掌握了 PageHelper 的使用，可以极大提高开发效率和代码质量。建议多动手实践，很快就能熟练掌握！

http://www.jsqmd.com/news/88120/

相关文章：

  • 毕设项目 基于大数据的K-means广告效果分析
  • Java Web 学习全指南：从入门到实战，体系化掌握核心技能
  • 点大商城系统v2全开源版基础上增加22复制7人成团功能的一些开发经验导图支持（链动n+1功能+排队免单功能+大屏数据）
  • 【硕士生必看】毕业论文初稿写崩了？Paperzz智能生成+深度查重，助你3天逆袭，导师直呼“这水平够发核心”！
  • 【单片机毕业设计】【mcugc-mcu910】基于单片机的温控风扇
  • 08cms房产多城市版最新v8.7含小程序及装修网的安装及配置方法整理出来希望能帮到大家
  • 3步搞定Flow Launcher搜索失效：Everything版本冲突的终极修复指南
  • 彻底掌握pyenv：Shim机制如何让Python版本管理如鱼得水
  • 【博士生必看】博士论文初稿写不动了？Paperzz智能辅助+权威查重，助你突破瓶颈，导师说“这思路可以申基金”！
  • 记录一次微前端改造：把 10+ 个独立 Vue 项目整合到一起
  • 股票历史分时BOLL数据之Python、Java等多种主流语言实例代码演示通过股票数据接口
  • 科技赋能味觉创意 “心语酪印” 西安首秀 打造可定制酸奶消费新场景
  • 教程6：事件的使用-–-behaviac
  • ScienceDecrypting完全攻略：三步搞定科研文档解密难题
  • C++中的原型模式 - 详解
  • 【Java-小程序毕设项目】基于微信小程序的个人健康管理系统+SpringBoot后端实现
  • 完整教程：构建AI智能体：九十五、YOLO视觉大模型入门指南：从零开始掌握目标检测
  • Windows系统中msg命令的完整使用方法及相关示例
  • Velero压缩引擎深度解析：从架构原理到实战调优
  • 如何快速掌握umy-ui：面向Vue开发者的终极性能优化指南
  • LookingGlass与OBS集成：实现专业级游戏直播录屏
  • 65、Mono编程入门指南：从基础到GUI应用
  • Polar靶场-Web中等题目记录（15-32）
  • Citra模拟器终极指南：5分钟上手玩转3DS游戏
  • 基于SpringBoot的职工健康监护管理系统-计算机毕业设计源码+LW文档
  • STM32学习_GPIO简介
  • 数据结构期末复习：递归与循环核心算法实战总结
  • GDevelop游戏引擎终极指南：从零基础到专业开发全流程
  • 【机械臂】基于 RRT 算法在3D 机械臂（主轴）路径规划中的工程实现，在含固定障碍物（副轴、外壳）的约束环境中，找到从起点构型到目标构型的无碰撞路径附matlab代码
  • 从产线到质检，兰亭妙微教你做 “工人愿意用” 的工业 UI