很多人都不知道的景区游玩小技巧

这是一个非常常见且实际的问题。虽然 **PageHelper** 是一个功能强大、使用广泛的 MyBatis 分页插件，但很多开发人员仍然选择**自己封装 `PageResult`**，而不是直接使用 PageHelper 提供的分页对象（如 `PageInfo`）。下面是几个主要原因和背后的考量。 --- ## ✅ 一、灵活性与解耦 ### 1. **解耦业务逻辑与分页插件** - PageHelper 是一个**第三方插件**，它绑定在 MyBatis 的查询流程中。 - 如果你直接使用 `PageInfo` 或 `Page`，那么你的业务逻辑就和 PageHelper 紧密耦合了。 - 封装成自己的 `PageResult`，可以实现： - 更好的**模块化设计** - 方便未来**替换分页方案**（如换成 MyBatis Plus、手动分页、Spring Data 分页等） ### 2. **统一返回格式** - 很多项目需要统一的 RESTful 接口返回格式，例如： ```json { "code": 200, "message": "success", "data": { "list": [...], "pageNum": 1, "pageSize": 10, "total": 100 } } ``` - 使用 `PageInfo` 等对象无法直接满足这种格式，封装成 `PageResult` 更加方便统一处理。 --- ## ✅ 二、避免 PageHelper 的副作用 ### 1. **PageHelper 的分页是基于 ThreadLocal 的拦截机制** - 它通过 `PageHelper.startPage(pageNum, pageSize)` 来启动分页。 - 它会拦截**下一条 SQL 查询语句**，自动添加 `LIMIT` 和 `OFFSET`。 - 如果后续还有查询语句，可能会出现**错误分页**。 ### 2. **容易出错的使用方式** 例如： ```java PageHelper.startPage(pageNum, pageSize); List<User> users = userMapper.selectAll(); // 正确分页 List<Role> roles = roleMapper.selectAll(); // 错误：这条也被分页了！ ``` - 这种副作用很容易引发 bug。 - 使用自定义的 `PageResult` + 手动分页，可以避免这种“隐形机制”。 --- ## ✅ 三、性能与可控性 ### 1. **PageHelper 的 count 查询可能效率低** - PageHelper 默认会为每个分页查询生成一个 `COUNT(*)` 查询。 - 如果你的查询条件很复杂，这个 `COUNT` 可能非常慢。 - 自己实现时可以： - 缓存总数 - 使用更高效的 `EXPLAIN` 估算 - 甚至跳过总数查询（如移动端“加载更多”） ### 2. **支持更复杂的分页逻辑** - 有些业务场景下，分页不是简单的 `LIMIT offset, size`，而是： - 游标分页（cursor-based pagination） - 时间分页（time-based pagination） - 自定义 `PageResult` 可以更灵活地支持这些场景。 --- ## ✅ 四、封装 PageResult 的示例代码 ### 1. 自定义 `PageResult` 类 ```java public class PageResult<T> { private List<T> list; private int pageNum; private int pageSize; private int total; // 构造方法、getter、setter } ``` ### 2. 手动分页 + 查询总数 ```java public PageResult<TrainingLogVO> getPage(int pageNum, int pageSize) { int offset = (pageNum - 1) * pageSize; List<TrainingLogVO> list = trainingLogDao.selectByPage(offset, pageSize); int total = trainingLogDao.count(); return new PageResult<>(list, pageNum, pageSize, total); } ``` --- ## ✅ 五、总结对比 | 方式 | 是否灵活 | 是否易出错 | 是否依赖插件 | 是否适合复杂场景 | |------|----------|------------|----------------|------------------| | PageHelper | ❌ 有限 | ✅ 易出错 | ✅ 是 | ❌ 不适合 | | 自定义 PageResult | ✅ 高 | ❌ 不易出错 | ❌ 否 | ✅ 适合 | ---