跨平台开发 / 系统课时
添加排序、筛选和分页查询
添加排序、筛选和分页查询
本篇解决 SQLite 列表数据查询中的常见需求:按照条件筛选记录、按指定字段排序,并通过分页控制返回数量。你将使用 Flutter SQLite 查询参数构建稳定的列表读取逻辑。
学习目标
- 理解
where、orderBy、limit、offset在 SQLite 查询中的作用。 - 掌握在 Flutter 中组合条件查询和分页查询的方法。
- 能够为列表页面设计可扩展的数据读取接口。
使用查询参数组织列表读取
移动应用中的列表通常不会一次加载全部数据。例如商品列表需要按价格排序,订单列表需要筛选状态,消息列表需要分页加载。SQLite 提供的查询参数可以将这些需求组合起来。
在 Flutter 中,常见 SQLite 库会将 SQL 查询条件转换为方法参数,例如 where 表示筛选条件,orderBy 控制排序,limit 和 offset 控制分页范围。
一个典型查询流程如下:先确定筛选范围,再排序,最后截取当前页数据。
使用 where 筛选数据
where 用于限制返回的数据行。它通常配合 whereArgs 传入动态参数,避免直接拼接字符串导致 SQL 注入风险。
下面示例查询状态为已完成的任务,并按更新时间倒序排列。
final rows = await database.query(
'tasks',
where: 'status = ?',
whereArgs: ['done'],
orderBy: 'updated_at DESC',
);
print(rows);预期输出
[
{id: 3, title: 完成报告, status: done},
{id: 1, title: 提交代码, status: done}
]这里 ? 是参数占位符,真实值由 whereArgs 提供。这样可以让数据库驱动负责参数绑定。
使用 orderBy 控制结果顺序
数据库表中的数据没有天然顺序,如果业务需要稳定展示顺序,必须显式指定排序规则。
常见排序方式包括:
| 查询需求 | orderBy 示例 |
|---|---|
| 最新数据优先 | created_at DESC |
| 最早数据优先 | created_at ASC |
| 数值从高到低 | price DESC |
多字段排序时,可以使用逗号分隔字段,例如先按状态排序,再按创建时间排序。
使用 limit 和 offset 实现分页
分页查询通常根据页码计算偏移量:
例如每页显示 20 条数据,第 3 页需要跳过前 40 条记录。
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,
);
}预期结果
page=1 返回第 1-20 条记录
page=2 返回第 21-40 条记录
page=3 返回第 41-60 条记录实际项目中,分页参数通常来自列表滚动状态,而不是固定写在查询方法里。
设计可维护的列表查询
当筛选条件逐渐增加时,不建议在页面中直接拼接数据库参数。可以将查询条件封装成参数对象,由数据层统一转换为 SQLite 查询。
需要注意分页查询的数据量较大时,应为排序字段建立索引,否则数据库可能需要扫描大量数据后再返回结果。对于频繁按照时间查询的列表,通常需要关注时间字段索引设计。
稳定的列表查询不仅取决于查询语句,还依赖明确的排序规则。没有 orderBy 的分页可能在数据变化后出现重复或遗漏记录。