Forge Admin

Appearance

🔒 升级 PRO

分页协议 ​

以用户分页为准：SysUserController.page 是 GET /system/user/page，入参 SysUserQuery extends PageQuery，返回 RespInfo<IPage<SysUser>>。

列表在 data.records。AiCrudPage 的 listDataField 默认就是 records。

请求 ​

PageQuery（forge-starter-core）：

字段默认说明
pageNum1，小于 1 当 1页码
pageSize10，小于 1 当 10，大于 100 截成 100每页条数
orderByColumn空排序列
isAsc空asc / desc

查询条件和分页字段一起作为 query / 表单参数。用户列表是 GET /system/user/page。

GET /system/user/page?pageNum=1&pageSize=10

toPage() 转成 MyBatis-Plus Page。

响应 ​

外层是 RespInfo：code、message、data、timestamp。没有 msg。

data 是 MyBatis-Plus Page / IPage 序列化结果，常用字段：

字段说明
records当前页行
total总行数
size每页条数
current当前页
pages总页数
json
{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [],
    "total": 0,
    "size": 10,
    "current": 1,
    "pages": 0
  },
  "timestamp": 1710000000000
}

后端写法 ​

java
@GetMapping("/page")
public RespInfo<IPage<SysUser>> page(SysUserQuery query) {
    return RespInfo.success(userService.selectUserPage(query));
}

LIMIT 由分页插件加，XML 里不要手写。

相关文档 ​