跨平台开发 / 系统课时

添加排序、筛选和分页查询

添加排序、筛选和分页查询

本篇解决 SQLite 列表数据查询中的常见需求:按照条件筛选记录、按指定字段排序,并通过分页控制返回数量。你将使用 Flutter SQLite 查询参数构建稳定的列表读取逻辑。

学习目标

  • 理解 where、orderBy、limit、offset 在 SQLite 查询中的作用。
  • 掌握在 Flutter 中组合条件查询和分页查询的方法。
  • 能够为列表页面设计可扩展的数据读取接口。

使用查询参数组织列表读取

移动应用中的列表通常不会一次加载全部数据。例如商品列表需要按价格排序,订单列表需要筛选状态,消息列表需要分页加载。SQLite 提供的查询参数可以将这些需求组合起来。

在 Flutter 中,常见 SQLite 库会将 SQL 查询条件转换为方法参数,例如 where 表示筛选条件,orderBy 控制排序,limit 和 offset 控制分页范围。

一个典型查询流程如下:先确定筛选范围,再排序,最后截取当前页数据。

使用 where 筛选数据

where 用于限制返回的数据行。它通常配合 whereArgs 传入动态参数,避免直接拼接字符串导致 SQL 注入风险。

下面示例查询状态为已完成的任务,并按更新时间倒序排列。

dart
final rows = await database.query(
  'tasks',
  where: 'status = ?',
  whereArgs: ['done'],
  orderBy: 'updated_at DESC',
);

print(rows);

预期输出

text
[
  {id: 3, title: 完成报告, status: done},
  {id: 1, title: 提交代码, status: done}
]

这里 ? 是参数占位符,真实值由 whereArgs 提供。这样可以让数据库驱动负责参数绑定。

使用 orderBy 控制结果顺序

数据库表中的数据没有天然顺序,如果业务需要稳定展示顺序,必须显式指定排序规则。

常见排序方式包括:

查询需求 orderBy 示例
最新数据优先 created_at DESC
最早数据优先 created_at ASC
数值从高到低 price DESC

多字段排序时,可以使用逗号分隔字段,例如先按状态排序,再按创建时间排序。

使用 limit 和 offset 实现分页

分页查询通常根据页码计算偏移量:

offset=(page−1)×pageSizeoffset = (page - 1) \times pageSize

例如每页显示 20 条数据,第 3 页需要跳过前 40 条记录。

dart
Future<List<Map<String, Object?>>> loadPage(Database database, int page) async {
  const pageSize = 20;
  final offset = (page - 1) * pageSize;

  return database.query(
    'articles',
    orderBy: 'created_at DESC',
    limit: pageSize,
    offset: offset,
  );
}

预期结果

text
page=1 返回第 1-20 条记录
page=2 返回第 21-40 条记录
page=3 返回第 41-60 条记录

实际项目中,分页参数通常来自列表滚动状态,而不是固定写在查询方法里。

设计可维护的列表查询

当筛选条件逐渐增加时,不建议在页面中直接拼接数据库参数。可以将查询条件封装成参数对象,由数据层统一转换为 SQLite 查询。

需要注意分页查询的数据量较大时,应为排序字段建立索引,否则数据库可能需要扫描大量数据后再返回结果。对于频繁按照时间查询的列表,通常需要关注时间字段索引设计。

稳定的列表查询不仅取决于查询语句,还依赖明确的排序规则。没有 orderBy 的分页可能在数据变化后出现重复或遗漏记录。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

添加排序、筛选和分页查询

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通