跨平台开发 / 系统课时
查询并映射为 Dart 对象
查询并映射为 Dart 对象
SQLite 查询得到的不是业务对象,而是由字段名和值组成的 Map。本节用一个待办事项模型完成查询、类型转换和结果验证,让数据库记录重新变成可在 Flutter 页面和业务逻辑中直接使用的 Dart 对象。
学习目标
- 使用
Database.query读取 SQLite 表中的记录 - 编写
fromMap将查询结果转换为 Dart 业务对象 - 正确处理整数布尔值、排序和空结果
查询结果为什么需要映射
sqflite 的 query 返回 List<Map<String, Object?>>。每个 Map 对应数据库中的一行,键是列名,值是 SQLite 读取出的数据。
直接在页面里反复写 row['title']、row['done'] 会让数据库字段细节扩散到 UI 和业务代码。更常见的做法是在模型中集中定义 fromMap,查询完成后立即转换成业务对象。
例如 SQLite 没有独立的 Dart bool 类型,常用整数 0 和 1 保存真假值。这个转换也应该由模型负责,而不是让每个调用方自行判断。
定义模型并执行查询
下面示例会创建一个临时教学数据库,写入两条待办记录,再按主键升序查询并转换为 Todo 对象。示例每次运行前删除旧数据库,因此输出是确定的。
import 'package:flutter/material.dart';
import 'package:path/path.dart' as p;
import 'package:sqflite/sqflite.dart';
class Todo {
final int id;
final String title;
final bool done;
const Todo({
required this.id,
required this.title,
required this.done,
});
factory Todo.fromMap(Map<String, Object?> row) {
return Todo(
id: row['id'] as int,
title: row['title'] as String,
// SQLite 中使用 0/1 保存布尔状态。
done: (row['done'] as int) == 1,
);
}
}
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
final dbPath = p.join(await getDatabasesPath(), 'query_mapping_demo.db');
await deleteDatabase(dbPath);
final db = await openDatabase(
dbPath,
version: 1,
onCreate: (database, version) async {
await database.execute('''
CREATE TABLE todos (
id INTEGER PRIMARY KEY AUTOINCREMENT,
title TEXT NOT NULL,
done INTEGER NOT NULL DEFAULT 0
)
''');
},
);
await db.insert('todos', {'title': '购买牛奶', 'done': 0});
await db.insert('todos', {'title': '提交周报', 'done': 1});
final rows = await db.query(
'todos',
orderBy: 'id ASC',
);
// 数据库行只在这一层转换,后续代码只处理 Todo。
final todos = rows.map(Todo.fromMap).toList();
for (final todo in todos) {
print('${todo.id} ${todo.title} done=${todo.done}');
}
await db.close();
}预期输出
1 购买牛奶 done=false
2 提交周报 done=true示例依赖 Flutter 项目已经添加 sqflite 与 path。实际数据库目录由运行平台决定,因此不应在代码中硬编码文件系统路径。
按条件查询并保持模型边界
只需要部分记录时,可以直接在数据库查询阶段增加条件,而不是先读取整张表再用 Dart 过滤。例如查询尚未完成的待办事项,可以使用参数绑定:
final rows = await db.query(
'todos',
where: 'done = ?',
whereArgs: [0],
orderBy: 'id ASC',
);
final pendingTodos = rows.map(Todo.fromMap).toList();这是片段示例,依赖前一个完整示例中的 db 和 Todo。whereArgs 会把参数值与 SQL 条件分开,既减少字符串拼接错误,也是在条件来自用户输入时应优先采用的写法。
query 没有匹配记录时会返回空列表,因此 map(...).toList() 同样得到空列表,不需要把“无结果”表示成 null。
处理字段变化和类型边界
映射代码与表结构必须保持一致。若数据库列允许 NULL,模型字段就不能直接使用 as String 之类的非空强制转换,而应声明为可空类型或在映射时提供明确默认值。
查询时也可以通过 columns 只读取所需字段,但凡 fromMap 必须读取的列都要包含在查询结果中。否则强制转换缺失字段时会失败。
把数据库记录尽早映射成 Dart 模型,可以把 SQLite 的列名、整数布尔值和可空规则限制在数据访问层中。页面拿到的始终是类型明确的 Todo,后续展示、筛选和状态处理都会更直接。