跨平台开发 / 系统课时

拆分 LocalDataSource 职责

拆分 LocalDataSource 职责

本地存储一多,页面很容易同时出现 SharedPreferences、文件路径和数据库查询,随后缓存键名、序列化规则与异常处理散落各处。LocalDataSource 的价值是建立统一边界,让上层只表达“保存或读取什么”,不直接操作具体存储技术。

学习目标

  • 区分 LocalDataSource 与 SharedPreferences、文件、数据库适配器的职责
  • 用接口隐藏本地存储键名和具体 API
  • 根据数据特征选择键值、文件或数据库,而不是把所有内容塞进一种存储

统一的是访问边界,不是一个巨型类

“统一放到 LocalDataSource”不等于创建一个几千行的类。Repository 应只依赖本地数据源抽象;具体实现可以继续按存储类型拆成偏好设置、文件和数据库适配器。这样既保留统一入口,又避免一个类同时承担 SQL、文件 I/O 和键值管理。

LocalDataSource 与多种本地存储的结构关系

常见划分可以按数据特征决定:少量设置、开关和轻量标记适合键值存储;较大的原始文本或二进制内容更适合文件;需要筛选、排序、关系或批量更新的数据更适合数据库。LocalDataSource 负责向上提供稳定方法名,而不是让 Repository 记住每种介质的细节。

隐藏键名与 SharedPreferences API

当前 shared_preferences 文档为新代码提供 SharedPreferencesAsync,其读写接口都是异步的;这能让下面的示例把平台存储调用完整封装在本地数据源实现中。 ([Dart packages][2])

下面示例可直接放进已添加 shared_preferences 依赖的 Flutter 工程。Repository 不知道键名 theme_mode,也不接触插件类型。

dart
import 'package:flutter/widgets.dart';
import 'package:shared_preferences/shared_preferences.dart';

abstract class LocalDataSource {
  Future<void> saveThemeMode(String mode);
  Future<String?> readThemeMode();
}

class PreferencesLocalDataSource implements LocalDataSource {
  PreferencesLocalDataSource(this._preferences);

  static const _themeModeKey = 'theme_mode';

  final SharedPreferencesAsync _preferences;

  @override
  Future<void> saveThemeMode(String mode) async {
    await _preferences.setString(_themeModeKey, mode);
  }

  @override
  Future<String?> readThemeMode() {
    return _preferences.getString(_themeModeKey);
  }
}

class SettingsRepository {
  SettingsRepository(this._local);

  final LocalDataSource _local;

  Future<void> saveThemeMode(String mode) {
    return _local.saveThemeMode(mode);
  }

  Future<String> loadThemeMode() async {
    return await _local.readThemeMode() ?? 'system';
  }
}

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  final local = PreferencesLocalDataSource(
    SharedPreferencesAsync(),
  );
  final repository = SettingsRepository(local);

  await repository.saveThemeMode('dark');
  print(await repository.loadThemeMode());
}

预期输出

text
dark

示例把插件对象和键名锁在实现内部。将来更换存储方式时,Repository 只要继续面对相同的 LocalDataSource 契约,就不需要知道数据究竟来自 SharedPreferences、文件还是数据库。

为不同介质保留不同实现

如果一个功能同时需要三种本地介质,可以让更高层的本地数据源组合多个小适配器。例如会话标记交给偏好设置,离线附件交给文件存储,离线业务记录交给数据库。这样“本地数据层”仍是统一边界,但每个组件只有一种主要变化原因。

数据特征 更合适的介质 LocalDataSource 暴露的示例语义
少量设置、布尔开关、字符串标记 SharedPreferences readThemeMode()
大文本、图片、下载附件 文件 readCachedFile()
可查询、排序、更新的结构化记录 数据库 findPendingOrders()

不要把数据库实体、文件句柄或插件实例直接返回给 Repository。否则上层会重新依赖具体存储 API,抽象层只剩下转发方法,无法承担隔离作用。

处理缓存失效与错误的位置

LocalDataSource 适合处理“键不存在”“文件损坏”“数据库读取失败”这类存储层事实,并转换成本项目的数据层结果或异常。至于“缓存超过多久必须刷新”“读取失败后是否请求服务器”,通常属于 Repository 的策略,因为这些决策需要同时理解本地与远程数据。

拆分完成后,一个很实用的检查方式是查看 Repository 的 import:它应该依赖 LocalDataSource 契约和业务数据类型,而不是同时导入 shared_preferences、文件系统库与数据库驱动。做到这一点,本地存储技术才能真正成为可替换的实现细节。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分 LocalDataSource 职责

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

登录哪都通