package com.vincent.rsf.server.common.domain;
|
|
import lombok.Data;
|
|
import java.util.List;
|
|
/**
|
* 通用游标分页返回体。
|
*
|
* <p>对外响应结构刻意保持简单，只暴露游标分页真正需要的 4 个字段，
|
* 不再返回传统页码分页里的 {@code total/current/pages}。</p>
|
*
|
* <p>字段语义约定：</p>
|
* <ul>
|
* <li>{@code records}：当前页实际返回的数据</li>
|
* <li>{@code pageSize}：本次查询最终采用的分页大小（包含默认值回退后的结果）</li>
|
* <li>{@code nextCursor}：下一页应当使用的游标；没有下一页时为 {@code null}</li>
|
* <li>{@code hasNext}：是否还有下一页</li>
|
* </ul>
|
*
|
* <p>这样设计的目的是让 controller 直接 {@code R.ok().add(result)}，
|
* 同时让前端只关心“有没有下一页”和“下一页该带什么 cursor”。</p>
|
*/
|
@Data
|
public class CursorPageResult<T> {
|
|
/** 当前页数据列表。 */
|
private List<T> records;
|
|
/** 当前请求最终生效的分页大小。 */
|
private Integer pageSize;
|
|
/**
|
* 下一页要携带的游标值。
|
*
|
* <p>约定取“当前页最后一条记录”的游标字段值。
|
* 如果没有下一页，则返回 null。</p>
|
*/
|
private Long nextCursor;
|
|
/** 是否还存在下一页。 */
|
private Boolean hasNext;
|
}
|
