在 Java 开发的世界里，数据分页是一个常见且重要的功能。当我们面对实体类时，借助 ORM 框架实现分页相对轻松，但如果遇到非实体类（如 DTO、VO、Map 等）的分页需求，不少开发者会感到棘手。今天，就让我们深入探讨 Java 接口针对非实体类的分页实现，解锁这一实用技能！
一、为什么需要对非实体类进行数据分页？
在实际项目中，实体类通常与数据库表结构一一对应，承载着数据的持久化操作。然而，在业务逻辑层和前端交互时，我们往往会使用非实体类，比如 DTO（数据传输对象）用于前后端数据传输，VO（视图对象）用于特定页面展示数据 。这些非实体类通常是根据业务需求灵活组装而成，并不直接映射数据库表。
当我们需要向用户展示大量这类非实体类数据时，如果一次性返回所有数据，不仅会增加网络传输压力，还会导致页面加载缓慢，影响用户体验。这时，分页就显得尤为重要，它能让数据分批展示，提升系统性能和用户体验。
二、分页实现的核心思路
实现非实体类分页的核心在于：先获取完整的非实体类数据集合，再通过分页算法对集合进行处理，最终返回特定页码的数据。我们可以通过自定义分页模型和通用分页工具类来完成这一过程。
1. 定义分页结果模型
首先，创建一个通用的分页结果模型类，用于封装分页相关信息，如当前页码、每页大小、总记录数、总页数以及具体的分页数据。以下是一个简单的示例：
import java.util.List;
public class PageResult<T> {
// 当前页码
private int pageNum;
// 每页大小
private int pageSize;
// 总记录数
private long totalCount;
// 总页数
private int totalPages;
// 分页数据
private List<T> data;
public PageResult(int pageNum, int pageSize, long totalCount, List<T> data) {
this.pageNum = pageNum;
this.pageSize = pageSize;
this.totalCount = totalCount;
this.totalPages = (int) Math.ceil((double) totalCount / pageSize);
this.data = data;
}
// 省略getter和setter方法
}
在这个PageResult类中，T是泛型类型，可以适配各种非实体类，保证了模型的通用性。
2. 实现分页工具类
接下来，创建一个分页工具类，提供在内存中对数据集合进行分页的方法。例如：
import java.util.List;
public class PageUtils {
public static <T> PageResult<T> getPageResult(List<T> dataList, int pageNum, int pageSize) {
if (pageNum < 1) {
pageNum = 1;
}
if (pageSize < 1) {
pageSize = 10; // 默认每页10条
}
int startIndex = (pageNum - 1) * pageSize;
int endIndex = Math.min(startIndex + pageSize, dataList.size());
List<T> pageData = dataList.subList(startIndex, endIndex);
long totalCount = dataList.size();
return new PageResult<>(pageNum, pageSize, totalCount, pageData);
}
}
getPageResult方法接收完整的数据集合、页码和每页大小作为参数，通过计算起始索引和结束索引，从数据集合中截取对应页码的数据，最后封装成PageResult对象返回。
三、实战案例：对 DTO 进行分页
假设我们有一个用户信息展示的业务场景，前端需要展示用户的部分信息，这些信息通过UserDTO类传输，UserDTO并不是直接的数据库实体类：
public class UserDTO {
private String username;
private String email;
// 省略getter和setter方法
}
import java.util.ArrayList;
import java.util.List;
public class UserService {
public PageResultgetUserDTOPage(int pageNum, int pageSize) {
// 模拟从数据库或其他数据源获取所有用户数据
ListallUserDTOs = new ArrayList<>();
// 这里省略填充数据的逻辑
return PageUtils.getPageResult(allUserDTOs, pageNum, pageSize);
}
}
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
private final UserService userService;
public UserController(UserService userService) {
this.userService = userService;
}
@GetMapping("/users")
public PageResultgetUserPage(
@RequestParam(defaultValue = "1") int pageNum,
@RequestParam(defaultValue = "10") int pageSize) {
return userService.getUserDTOPage(pageNum, pageSize);
}
}
这样，前端每次请求时，就可以根据页码和每页大小获取到对应的分页数据了。
四、注意事项与优化方向
1、性能问题：上述示例是在内存中对数据集合进行分页，如果数据量非常大，一次性加载所有数据到内存可能会导致内存溢出。此时，可以考虑在数据源层面进行分页查询，比如使用数据库的分页语句（如 MySQL 的LIMIT，Oracle 的ROWNUM），只获取需要的部分数据，再转换为非实体类进行处理。
2、分页参数校验：在接收前端传入的页码和每页大小时，一定要进行参数校验，避免非法参数导致程序出错。
3、扩展性：在实际项目中，可以根据业务需求对分页结果模型和分页工具类进行扩展，例如添加排序功能、过滤条件等，以满足更复杂的业务场景。
通过以上步骤，我们成功实现了 Java 接口针对非实体类的分页功能。掌握这一技能，能让我们在处理复杂业务需求时更加得心应手。