跨平台开发 / 系统课时

从文件恢复本地数据

从文件恢复本地数据

本节解决应用重启后如何从本地文件恢复状态。你将读取 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 负责序列化格式,模型层负责把动态数据验证并转换成应用真正需要的类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

从文件恢复本地数据

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

登录哪都通