跨平台开发 / 系统课时
从文件恢复本地数据
从文件恢复本地数据
本节解决应用重启后如何从本地文件恢复状态。你将读取 UTF-8 文本,使用 jsonDecode 还原结构,再把动态 JSON 数据转换成类型明确的 Dart 对象,并处理文件不存在或内容损坏的情况。
学习目标
- 使用
File.readAsString读取本地文件 - 将 JSON 文本反序列化为应用数据结构
- 对缺失文件和无效 JSON 提供可控的恢复策略
从文件读取并反序列化
读取 JSON 文件通常分成三步:定位文件、读取字符串、解码并映射为业务对象。不要直接在界面层到处操作 dynamic,因为字段拼写错误或类型变化会把问题推迟到运行时。
下面示例先写入一份模拟的已保存数据,再按真实恢复流程读取它,并转换为 UserSettings。
dart
import 'dart:convert';
import 'dart:io';
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';
class UserSettings {
const UserSettings({
required this.theme,
required this.pageSize,
});
final String theme;
final int pageSize;
factory UserSettings.fromJson(Map<String, dynamic> json) {
return UserSettings(
theme: json['theme'] as String,
pageSize: json['pageSize'] as int,
);
}
}
Future<UserSettings> loadSettings(File file) async {
final String source = await file.readAsString(encoding: utf8);
final Object? decoded = jsonDecode(source);
if (decoded is! Map<String, dynamic>) {
throw const FormatException('settings.json must contain a JSON object');
}
return UserSettings.fromJson(decoded);
}
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
final Directory directory = await getApplicationDocumentsDirectory();
final File file = File('${directory.path}/settings.json');
await file.writeAsString(
'{"theme":"dark","pageSize":20}',
encoding: utf8,
);
final UserSettings settings = await loadSettings(file);
print('theme=${settings.theme}, pageSize=${settings.pageSize}');
}预期输出:
text
theme=dark, pageSize=20处理文件不存在
首次安装、用户清除数据或迁移失败时,目标文件可能不存在。此时通常不应把 FileSystemException 直接抛给界面,而是返回一份明确的默认配置。
片段示例:沿用上一个完整示例中的 UserSettings 和 loadSettings,只补充文件缺失时的分支。
dart
Future<UserSettings> loadSettingsOrDefault(File file) async {
if (!await file.exists()) {
return const UserSettings(theme: 'light', pageSize: 10);
}
return loadSettings(file);
}预期结果:
text
文件存在时恢复已保存配置;文件不存在时返回 theme=light、pageSize=10 的默认配置这里把“缺失文件”视为正常分支,但不应该把所有读取错误都吞掉。例如权限、存储损坏或 I/O 异常可能需要记录日志或提示用户。
处理损坏或版本变化的 JSON
jsonDecode 遇到非法 JSON 会抛出 FormatException;字段缺失或类型变化也可能在 fromJson 中抛出类型错误。生产代码可以只捕获你能恢复的异常,并回退到默认值或迁移旧格式。
如果数据结构会跨版本长期保存,建议在 JSON 中增加类似 version 的字段,并在读取时按版本迁移。这样比假设旧文件永远符合当前模型更可靠。
从文件恢复数据的关键不是“能读出字符串”,而是建立稳定边界:文件系统负责字节与文本,JSON 负责序列化格式,模型层负责把动态数据验证并转换成应用真正需要的类型。
按自己的节奏,确认真正理解。