跳到正文
教程首页
FlutterCH 14ch14_persistence

ch14-persistence

本地持久化:shared_preferences 与 drift(SQLite)。完整工程共 104 个文件,其中 64 个文本源文件可在下面在线阅读。

64

在线文本文件

4,938

源码行数

dart / c / yaml

语言

289 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textxmldartyamljson

64 text files · 4,938 lines

dartlib/src/database.dart
// 数据层:drift(SQLite 的类型安全封装)。
//
// 三道工序:
//   1. 用 Dart 类声明表结构(Todos);
//   2. build_runner 生成 database.g.dart(查询构建器 + 数据类);
//   3. 用 `select/into/update/delete` 写类型安全的查询,SQL 由生成器拼。
//
// 对照 Go:database/sql + 手写 Scan;对照 C:sqlite3_prepare_v2 + sqlite3_step。
// drift 的 `watch()` 还能把查询变成 Stream —— 表变了自动推新结果,省掉手写订阅。
import 'dart:io';

import 'package:drift/drift.dart';
import 'package:drift/native.dart';
import 'package:path/path.dart' as p;
import 'package:path_provider/path_provider.dart';

part 'database.g.dart';

/// 待办表。
class Todos extends Table {
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text().withLength(min: 1, max: 200)();
  BoolColumn get done => boolean().withDefault(const Constant(false))();
  DateTimeColumn get createdAt => dateTime().withDefault(currentDateAndTime)();
}

@DriftDatabase(tables: <Type>[Todos])
class AppDatabase extends _$AppDatabase {
  AppDatabase(super.executor);

  /// 测试用:纯内存数据库,不碰磁盘,天然隔离。
  AppDatabase.memory() : super(NativeDatabase.memory());

  /// 应用用:文件数据库,后台 isolate 打开(避免阻塞 UI)。
  factory AppDatabase.open() => AppDatabase(_openConnection());

  @override
  int get schemaVersion => 1;

  // --- 查询 ---------------------------------------------------------------

  Future<List<Todo>> allTodos() => (select(todos)
        ..orderBy(<OrderClauseGenerator<$TodosTable>>[
          (t) => OrderingTerm.desc(t.createdAt),
        ]))
      .get();

  /// 表变化时自动推送新结果(drift 内部监听 SQLite 的 update hook)。
  Stream<List<Todo>> watchTodos() => (select(todos)
        ..orderBy(<OrderClauseGenerator<$TodosTable>>[
          (t) => OrderingTerm.desc(t.createdAt),
        ]))
      .watch();

  // --- 写入 ---------------------------------------------------------------

  Future<int> addTodo(String title) =>
      into(todos).insert(TodosCompanion.insert(title: title.trim()));

  Future<void> setDone(int id, {required bool done}) => (update(todos)
        ..where((t) => t.id.equals(id)))
      .write(TodosCompanion(done: Value<bool>(done)));

  Future<int> deleteTodo(int id) =>
      (delete(todos)..where((t) => t.id.equals(id))).go();

  Future<int> clearDone() =>
      (delete(todos)..where((t) => t.done.equals(true))).go();
}

/// 文件位置:`getApplicationSupportDirectory()` 在各平台给出"应该放私有数据"的目录。
///
/// macOS:   `~/Library/Application Support/<bundle id>/`
/// Linux:   `~/.local/share/<app>/`
/// Windows: `%APPDATA%\<app>\`
/// Android: `/data/data/<package>/files/`
/// iOS:     `.../Library/Application Support/`
LazyDatabase _openConnection() => LazyDatabase(() async {
      final Directory dir = await getApplicationSupportDirectory();
      final File file = File(p.join(dir.path, 'ch14_todos.sqlite'));
      // createInBackground:SQLite 在后台 isolate 里跑,不阻塞 UI 线程。
      return NativeDatabase.createInBackground(file);
    });

代码构成:text 78 KB · xml 41 KB · dart 36 KB · yaml 5 KB

本地运行

zip → 解压 → 执行
$cd examples/ch14-persistence && flutter run -d macos

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze 0 告警、flutter test 12 个用例全绿、flutter build macos --debug 真实构建并启动成功
查看全部示例