跳到正文
教程首页
FlutterCH 16ch16_bookmarks

ch16-bookmarks

综合项目(上):架构设计、数据层、依赖注入。完整工程共 116 个文件,其中 76 个文本源文件可在下面在线阅读。

76

在线文本文件

5,837

源码行数

dart / c / yaml

语言

301 KB

打包体积

在线阅读源码

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

textdartxmljsonkotlin

76 text files · 5,837 lines

dartlib/src/data/database.dart
// 数据层(一):drift 表与数据库。
//
// 注意:这一层只暴露"行(Row)",领域映射放在仓储实现里,
// 这样领域层不会 import drift。
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';

/// `@DataClassName` 把生成的行类改名,避免与领域实体 `Bookmark` 冲突。
@DataClassName('BookmarkRow')
class Bookmarks extends Table {
  IntColumn get id => integer().autoIncrement()();
  TextColumn get title => text().withLength(min: 1, max: 200)();
  TextColumn get url => text()();
  TextColumn get note => text().withDefault(const Constant(''))();
  BoolColumn get favorite => boolean().withDefault(const Constant(false))();
  DateTimeColumn get createdAt => dateTime().withDefault(currentDateAndTime)();
}

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

  /// 测试:内存库,用例之间天然隔离。
  AppDatabase.memory() : super(NativeDatabase.memory());

  factory AppDatabase.open() => AppDatabase(_open());

  @override
  int get schemaVersion => 1;

  @override
  MigrationStrategy get migration => MigrationStrategy(
        onCreate: (Migrator m) => m.createAll(),
        onUpgrade: (Migrator m, int from, int to) async {
          // v1 是初版,暂无迁移。以后加列/加表都写在这里(见 ch14)。
        },
      );

  Stream<List<BookmarkRow>> watchAllRows() => (select(bookmarks)
        ..orderBy(<OrderClauseGenerator<$BookmarksTable>>[
          (t) => OrderingTerm(expression: t.favorite, mode: OrderingMode.desc),
          (t) => OrderingTerm(expression: t.createdAt, mode: OrderingMode.desc),
        ]))
      .watch();

  /// 插入(按 url 去重)。返回 `(id, created)`:
  /// `created == false` 表示该 url 已存在,导入统计时不算新增。
  Future<({int id, bool created})> insertRow({
    required String title,
    required String url,
    String note = '',
  }) async {
    final BookmarkRow? existing = await (select(bookmarks)
          ..where((t) => t.url.equals(url))
          ..limit(1))
        .getSingleOrNull();
    if (existing != null) return (id: existing.id, created: false);

    final int id = await into(bookmarks).insert(BookmarksCompanion.insert(
      title: title,
      url: url,
      note: Value<String>(note),
    ));
    return (id: id, created: true);
  }

  Future<void> updateFavorite(int id, {required bool favorite}) => (update(bookmarks)
        ..where((t) => t.id.equals(id)))
      .write(BookmarksCompanion(favorite: Value<bool>(favorite)));

  Future<int> deleteRow(int id) =>
      (delete(bookmarks)..where((t) => t.id.equals(id))).go();
}

LazyDatabase _open() => LazyDatabase(() async {
      final Directory dir = await getApplicationSupportDirectory();
      final File file = File(p.join(dir.path, 'bookmarks.sqlite'));
      return NativeDatabase.createInBackground(file);
    });

代码构成:text 77 KB · dart 69 KB · xml 41 KB · json 4 KB

本地运行

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

这个 zip 里有什么

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

已验证

  • flutter analyze 0 告警、flutter test 20 个用例全绿、debug 与 **release** 构建均真实启动成功
查看全部示例