无 Spring Data 分页解析技巧

本文介绍了在不依赖 Spring Data 的前提下，如何通过自定义轻量级分页容器类（如 MyOwnPage）精准对接 Spring Data 返回的标准分页 REST 接口，利用 RestTemplate 和 Jackson 实现高效、解耦的跨服务分页数据消费——既避免引入庞大依赖，又严格兼容 Page 的 JSON 序列化结构（如字段名 number、size、content、totalElements 等），并提供了生产就绪的代码示例、关键注意事项及可扩展优化建议，是微服务架构中处理分页协作的简洁可靠实践。

在不引入 Spring Data 依赖的前提下，可通过自定义轻量级分页容器类（如 MyOwnPage）对接返回 Page 的 REST 接口，配合 RestTemplate 完成反序列化与分页逻辑处理。

在不引入 Spring Data 依赖的前提下，可通过自定义轻量级分页容器类（如 MyOwnPage）对接返回 Page 的 REST 接口，配合 RestTemplate 完成反序列化与分页逻辑处理。

在微服务架构中，常需跨服务调用分页接口（如 GET /api/items?page=0&size=20），而提供方若基于 Spring Data JPA 返回 Page，其 JSON 响应结构为标准格式（含 content、pageable、totalElements、totalPages、first、last 等字段）。但消费方若未引入 spring-boot-starter-data-jpa 或 spring-data-commons，则无法直接使用 org.springframework.data.domain.Page —— 因其非仅 POJO，还依赖运行时类型擦除处理与 Spring 序列化机制。

此时推荐方案是定义语义对齐、结构兼容的 DTO 分页容器，而非强行引入庞大依赖。以下是一个生产就绪的 MyOwnPage 实现示例：

public class MyOwnPage<T> {
    private List<T> content;
    private int number;           // 当前页码（0-indexed）
    private int size;             // 每页数量
    private long totalElements;   // 总记录数
    private int totalPages;       // 总页数
    private boolean first;        // 是否为第一页
    private boolean last;         // 是否为最后一页
    private boolean empty;        // 内容是否为空

    // 必须提供无参构造函数（Jackson 反序列化所需）
    public MyOwnPage() {}

    // getter/setter（略，建议使用 Lombok @Data 或手动补全）
}

✅ 关键说明：Spring Data 的 PageImpl 默认序列化字段名为 number（非 pageNumber）、size（非 pageSize）、content、totalElements、totalPages、first、last、empty —— 请严格保持字段名一致，否则 Jackson 将无法正确绑定。

调用时使用 ParameterizedTypeReference 显式声明泛型类型：

String url = "http://service-a/api/items?page={page}&size={size}";
ResponseEntity<MyOwnPage<MyOwnType>> response = restTemplate.exchange(
    url,
    HttpMethod.GET,
    null,
    new ParameterizedTypeReference<MyOwnPage<MyOwnType>>() {},
    0, 20
);

if (response.getStatusCode().is2xxSuccessful()) {
    MyOwnPage<MyOwnType> page = response.getBody();
    List<MyOwnType> data = page.getContent();
    boolean hasNext = !page.isLast();

    // 如需加载下一页：
    if (hasNext) {
        int nextPage = page.getNumber() + 1;
        // 再次 exchange...
    }
}

⚠️ 注意事项：

• 若提供方使用了自定义 PageableHandlerMethodArgumentResolver 或修改了默认 JSON 字段别名（如通过 @JsonAlias），需同步调整 DTO 字段；
• Page 的 sort 字段较复杂（含 sorted, empty, orders 数组），如需排序信息，可扩展 MyOwnPage 添加 SortInfo 内部类或简化为 String sort 字符串字段；
• 生产环境建议配合 OpenFeign 替代 RestTemplate（更简洁、支持声明式客户端与解码器定制）；
• 可进一步封装为通用 PagedClient 工具类，内置翻页迭代器（Iterator）或流式拉取方法。

该方案轻量、解耦、可控，是微服务间分页数据协作的标准实践之一。

以上就是《无 Spring Data 分页解析技巧》的详细内容，更多关于的资料请关注golang学习网公众号！