在Java开发中,分页功能是处理大量数据展示时不可或缺的环节，它能够有效减少服务器负载，提升用户体验，本文将从分页的基本原理、核心实现步骤、代码示例及优化建议等方面，详细介绍Java分页代码的编写方法。
分页的基本原理与核心参数
分页的核心思想是将大量数据分割成多个小的数据块,每次只加载和展示其中一个数据块，实现分页需要依赖四个核心参数：
- 页码（pageNum）：当前用户请求的页码，通常从1开始。
- 每页大小（pageSize）：每页展示的数据条数，如10、20等。
- 偏移量（offset）：数据库查询的起始位置，计算公式为
(pageNum - 1) * pageSize。 - 总记录数（total）：数据库中符合条件的数据总数，用于计算总页数。
理解这些参数后,分页的逻辑就变得清晰：通过偏移量和每页大小从数据库中提取指定范围的数据，同时根据总记录数和每页大小计算出总页数，用于前端分页组件的渲染。
分页实现的核心步骤
接收前端分页参数
在Controller层,需要定义接收前端分页参数的实体类或方法参数，通常包含pageNum和pageSize，并设置默认值，避免前端未传参时出现异常。
public class PageRequest {
private int pageNum = 1;
private int pageSize = 10;
// getter/setter方法
}
计算偏移量与总页数
在Service层,根据接收的pageNum和pageSize计算偏移量，并调用DAO层查询总记录数，总页数的计算公式为 totalPages = (total + pageSize - 1) / pageSize，确保整除时不会多出一页。
public PageResult<T> findPage(PageRequest request) {
int offset = (request.getPageNum() - 1) * request.getPageSize();
int total = dao.countTotal(); // 查询总记录数
List<T> data = dao.queryPage(offset, request.getPageSize()); // 查询分页数据
int totalPages = (total + request.getPageSize() - 1) / request.getPageSize();
return new PageResult<>(data, total, totalPages);
}
数据库分页查询
在DAO层,通过SQL语句实现分页查询，不同数据库的分页语法略有差异：
- MySQL：使用
LIMIT offset, pageSize，SELECT * FROM table LIMIT 10, 20。 - Oracle：使用
ROWNUM，SELECT * FROM (SELECT a.*, ROWNUM rn FROM table a WHERE ROWNUM <= 30) WHERE rn > 10。 - PostgreSQL：使用
LIMIT pageSize OFFSET offset，SELECT * FROM table LIMIT 20 OFFSET 10。
以MyBatis为例,XML文件中的SQL可以这样写：
<select id="queryPage" resultType="com.example.entity.User">
SELECT * FROM user ORDER BY id LIMIT #{offset}, #{pageSize}
</select>
<select id="countTotal" resultType="int">
SELECT COUNT(*) FROM user
</select>
封装分页结果
将查询到的数据、总记录数、总页数等信息封装成统一的分页结果对象，便于前端解析。
public class PageResult<T> {
private List<T> data;
private int total;
private int totalPages;
// 构造方法、getter/setter
}
分页代码的完整示例
以下是一个基于Spring Boot和MyBatis的分页实现示例：
实体类与分页参数类
// User实体类
public class User {
private Long id;
private String name;
// getter/setter
}
// 分页参数类
public class PageRequest {
private int pageNum = 1;
private int pageSize = 10;
// getter/setter
}
Mapper接口与XML
@Mapper
public interface UserMapper {
List<User> queryPage(@Param("offset") int offset, @Param("pageSize") int pageSize);
int countTotal();
}
<!-- UserMapper.xml -->
<select id="queryPage" resultType="com.example.entity.User">
SELECT id, name FROM user LIMIT #{offset}, #{pageSize}
</select>
<select id="countTotal" resultType="int">
SELECT COUNT(*) FROM user
</select>
Service层实现
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
public PageResult<User> findPage(PageRequest request) {
int offset = (request.getPageNum() - 1) * request.getPageSize();
List<User> users = userMapper.queryPage(offset, request.getPageSize());
int total = userMapper.countTotal();
int totalPages = (total + request.getPageSize() - 1) / request.getPageSize();
return new PageResult<>(users, total, totalPages);
}
}
Controller层接口
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/page")
public PageResult<User> getUsersByPage(PageRequest request) {
return userService.findPage(request);
}
}
分页的优化建议
- 避免全表扫描：确保查询字段有索引，尤其是在排序字段上，避免数据库因全表扫描导致性能下降。
- 使用缓存：对于不经常变化的数据，可以使用Redis缓存总记录数或热点页面的数据，减少数据库压力。
- 深分页优化：当页码较大时（如第1000页），
LIMIT的偏移量会很大，导致查询效率低，可采用“基于游标的分页”（如WHERE id > lastId LIMIT pageSize），但需要业务支持。 - 统一分页插件：使用MyBatis-Plus等插件提供的分页功能，简化代码并提升性能。
Page<User> page = new Page<>(pageNum, pageSize); IPage<User> result = userMapper.selectPage(page, null); return new PageResult<>(result.getRecords(), (int) result.getTotal(), (int) result.getPages());
Java分页代码的实现虽然涉及多个层次,但核心逻辑清晰：接收参数、计算偏移量、数据库查询、封装结果，通过合理的参数设计、SQL优化和工具辅助，可以高效实现分页功能，在实际开发中，还需根据业务场景选择适合的分页策略，平衡性能与用户体验。
