PageHelper 使用手册
📄字数 1.1K
👁️阅读量 加载中...
本文档将介绍如何使用 PageHelper v6.0.0 在 spring-boot-web 应用中连接 XuguDB 并实现分页。
提示
XuguDB-JDBC 与 PageHelper 框架完全兼容，可以直接使用 PageHelper 框架操作 XuguDB。
示例代码下载xugu-pagehelper-mybatisplus-demo
一、导入项目 xugu-pagehelper-mybatisplus-demo 项目到到IDEA中
项目结构如下：
图 1.1 pagehelper-项目结构1.1 修改配置文件
修改配置文件为数据库的配置
图 1.2 pagehelper-配置文件1.2 初始化数据库
执行脚本文件com/xugu/mybatisplusdemo/pojo/user.sql结果如图 1.3所示：
图 1.3 pagehelper-初始表和数据库1.3 执行测试
找到测试类 MybatisplusdemoApplicationTests.java
图 1.4 pagehelper-测试类测试类执行结果
图 1.5 pagehelper-测试类执行结果提示
该测试类中共介绍了九种分页查询方式，具体可参考项目代码。
二、 项目代码介绍
该项目展示了如何使用 SpringBoot、MyBatis-Plus 和 PageHelper 实现分页查询功能。主要组成部分如下：
- PageHelperConfigure.java: 配置 PageHelper 分页插件，设置数据库类型、分页参数处理等。
- UserService.java: 定义分页服务接口，包括按页码和页面大小进行查询的方法。
- UserMapper.java: 数据访问层接口，包含自定义分页查询方法的声明。
- User.java: 用户实体类，映射数据库中的
user表。 - MybatisplusdemoApplicationTests.java: 测试类，用于测试分页功能共包含九种分页查询方式。
分页实现流程
- 在
PageHelperConfigure.java中配置 PageHelper 插件。 - 在
UserMapper.java中定义分页查询方法。 - 在
UserService.java中实现分页逻辑。 - 在
UserController.java中调用服务层方法并暴露 RESTful API。
三、常见问题及解决办法
- 分页查询结果不正确
- 原因: 可能是由于数据库方言设置错误或分页参数传递不当。
- 解决办法: 检查
PageHelperConfigure.java中的helperDialect设置是否与当前数据库匹配，并确保传入正确的页码和页面大小参数。
- 分页查询性能低下
- 原因: 大数据量下未优化 SQL 查询或索引缺失。
- 解决办法: 在数据库表中添加适当的索引，并考虑对查询语句进行优化。