14-03 加入分页

题目

为筛选结果规定固定排序，把筛选参数保留在前后页链接里，核对总数、当前页和空结果。

推导与做法

筛选后先确定总数，再按固定 id 顺序切成两本一页。上一页、下一页的 url_for 都保留 q，切页不会突然回到未筛选的全集。

演示为便于逐项观察，先沿用 service.list_books 再切片。数据增大后，把相同筛选条件同时交给 COUNT 与带 LIMIT/OFFSET 的 SELECT；仍保持同一排序。空结果返回 total=0 和空 items。

过程图

%% 每个节点保留输入、执行位置或执行后的实际状态。 flowchart TD S0["按owner和q筛选"] S1["固定id排序并求总数"] S0 --> S1 S2["切成每页两条"] S1 --> S2 S3["前后页链接继续携带q与页号"] S2 --> S3 classDef default fill:#EEF0FB,stroke:#4657B5,color:#24324A linkStyle default stroke:#4657B5

实现与运行

查看带注释实现。本题与相关处理函数放在同一章节代码文件中；启动工具负责定位相邻项目和选择题号。

在配套目录的 Flask/shelf_project 中运行。先按项目 README 执行 uv sync --locked。

# 使用项目解释器运行本题，题号决定执行哪一组演示。
uv run python "../../学习索引/参考实现/代码/ch14.py" 14-03

程序按题号输出处理后的值、查询结果或状态。先和前面的手算比较，再修改一项输入重跑。

查看本题运行结果

# 与上面的手算状态和题目数值逐项比较。
{
  "first": {
    "items": [
      {
        "finished": false,
        "id": 1,
        "tags": [
          "基础",
          "语法"
        ],
        "title": "Python 入门"
      },
      {
        "finished": true,
        "id": 2,
        "tags": [
          "数值"
        ],
        "title": "NumPy 实践"
      }
    ],
    "next": "/practice/books?q=&page=2",
    "page": 1,
    "previous": null,
    "total": 6
  },
  "second": {
    "items": [
      {
        "finished": false,
        "id": 3,
        "tags": [
          "游戏"
        ],
        "title": "Pygame 小游戏"
      },
      {
        "finished": false,
        "id": 4,
        "tags": [
          "网络"
        ],
        "title": "HTTP 与数据采集"
      }
    ],
    "next": "/practice/books?q=&page=3",
    "page": 2,
    "previous": "/practice/books?q=&page=1",
    "total": 6
  },
  "empty": {
    "items": [],
    "next": null,
    "page": 1,
    "previous": null,
    "total": 0
  }
}