package com.vincent.rsf.server.common.domain;
|
|
import lombok.Data;
|
import lombok.EqualsAndHashCode;
|
|
import java.util.Map;
|
|
/**
|
* 通用游标分页参数。
|
*
|
* <p>这个类在现有 {@link BaseParam} 的基础上只增加一个 {@code cursor} 字段，
|
* 用来表示“下一页从哪里继续查”。</p>
|
*
|
* <p>当前项目里的普通分页接口大多还是 {@code current + pageSize} 模式，
|
* 但游标分页只依赖：</p>
|
* <ul>
|
* <li>{@code pageSize}：每页大小</li>
|
* <li>{@code cursor}：上一页最后一条记录的游标值</li>
|
* </ul>
|
*
|
* <p>这里仍然继承 {@link BaseParam}，目的是继续复用原有的：</p>
|
* <ul>
|
* <li>筛选条件解析</li>
|
* <li>{@code condition / timeStart / timeEnd} 等通用参数</li>
|
* <li>和 {@link com.vincent.rsf.server.common.domain.PageParam} 的协作能力</li>
|
* </ul>
|
*
|
* <p>注意：前端即使继续传 {@code current}，这里也不会报错；
|
* {@link BaseParam#syncMap(Map)} 会正常解析它，但后续通用游标分页逻辑不会使用它。</p>
|
*/
|
@Data
|
@EqualsAndHashCode(callSuper = true)
|
public class CursorPageParam extends BaseParam {
|
|
/**
|
* 当前页的起始游标。
|
*
|
* <p>约定含义是：只查询“比这个游标更旧”的数据，
|
* 例如按 {@code id desc} 翻页时，会生成 {@code id < cursor} 的条件。</p>
|
*/
|
private Long cursor;
|
|
@Override
|
public void syncMap(Map<String, Object> map) {
|
// 先复用 BaseParam 的通用参数解析能力，
|
// 保证 pageSize、condition、timeStart、timeEnd 等字段照常工作。
|
super.syncMap(map);
|
if (map == null) {
|
return;
|
}
|
Object cursorValue = map.get("cursor");
|
if (cursorValue == null) {
|
return;
|
}
|
String normalizedValue = String.valueOf(cursorValue).trim();
|
if (normalizedValue.isEmpty()) {
|
// 空字符串游标等价于“首屏没有游标”，这里直接移除，避免后续误参与 SQL。
|
map.remove("cursor");
|
return;
|
}
|
// 目前通用方案统一把游标约束为 Long，
|
// 这样可以覆盖当前按主键/数字字段倒序翻页的业务场景。
|
this.cursor = Long.parseLong(normalizedValue);
|
// 解析完成后要从 map 中移除，避免 PageParam.buildWrapper(true)
|
// 把 cursor 当成普通筛选字段再次拼进 where 条件。
|
map.remove("cursor");
|
}
|
}
|
