跨平台开发 / 系统课时

查询并映射为 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 对象。示例每次运行前删除旧数据库,因此输出是确定的。

dart
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();
}

预期输出

text
1 购买牛奶 done=false
2 提交周报 done=true

示例依赖 Flutter 项目已经添加 sqflite 与 path。实际数据库目录由运行平台决定,因此不应在代码中硬编码文件系统路径。

按条件查询并保持模型边界

只需要部分记录时,可以直接在数据库查询阶段增加条件,而不是先读取整张表再用 Dart 过滤。例如查询尚未完成的待办事项,可以使用参数绑定:

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,后续展示、筛选和状态处理都会更直接。

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

目录与阅读设置

阅读设置

17

记录一个想法

查询并映射为 Dart 对象

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

登录哪都通