迭代器可将后端分页接口封装为无缝数据流,通过hasNext()自动加载下页、next()返回当前项,支持页码和游标两种模式,并需处理加载状态、错误降级与提前终止。

可以用迭代器把后端分页接口包装成一个“可逐个取值”的数据流,让调用方无需关心页码、游标、加载状态,像遍历普通集合一样消费数据——这就是无缝滚动的抽象核心。
封装关键:把分页逻辑藏进 hasNext() 和 next()
迭代器接口只有两个核心方法,正好对应分页行为:
- hasNext():负责判断是否还有下一条。内部自动触发下一页请求(首次或上批数据用完时),拿到新数据后缓存并重置索引;若返回空或不足页长,就标记“无更多”
- next():只管返回当前缓存中的下一项,并推进内部指针;不主动拉数据,也不做网络操作
这样,外部循环 while (it.hasNext()) { it.next(); } 就天然形成“按需加载 + 自动翻页”的节奏,视觉和逻辑上都“无缝”。
需支持两种主流后端分页模式
不同接口分页机制不同,迭代器应能适配:
-
基于页码(page/size):维护
currentPage,每次请求后递增;适合总条数已知、排序稳定场景 -
基于游标(如 lastId 或 timestamp):维护
lastCursor,每次请求传入上一批末尾记录标识;避免因写入导致的漏/重,更适合高并发动态列表
建议在构造迭代器时通过参数指定策略,内部 load(int start, int size) 或 load(String cursor, int limit) 方法分别实现。
必须处理的边界与健壮性细节
真实场景中,仅靠标准 Iterator 接口不够,还需显式控制:
- 加载中状态隔离:hasNext() 不应阻塞,但要避免并发多次触发请求。可用 volatile boolean 标记“正在加载”,重复调用直接返回 false 或等待(视需求而定)
- 错误降级:某页请求失败时,不应中断整个迭代。可记录警告、跳过该页,或抛出自定义异常供上层捕获重试
-
提前终止支持:提供
close()或cancel()方法,取消未完成的请求(如 AbortController),防止内存泄漏或无效回调
前端使用示例(类 Java 风格伪代码)
假设你封装好了一个 PagingIterator:
var it = new PagingIterator<user>(
url: "/api/users",
pageSize: 20,
strategy: CURSOR_BASED // 或 PAGE_NUMBER_BASED
);
while (it.hasNext()) {
User user = it.next();
render(user); // 渲染单条,不感知分页
if (shouldStopEarly(user)) break; // 可随时中断
}</user>
整个过程没有 page=1、page=2,没有 loading 判断,也没有手动拼接数组——滚动加载被完全收口到迭代器内部。











